konval

Háttér
Validálása és átalakítása adatok.
A probléma a fertőtlenítő adatok (ellenőrzés helyességét, és átalakítja a hasznos formában) széles körben elterjedt programozási:
- Hogyan ellenőrzik felhasználói input helyes?
- Hogyan munge adatokat egy táblázatba a dátumok és számok?
- Hogyan alakíthatom nyers adatbázis területeken egy programadó tárgyat?
Ian Bicking jött egy értelmes idióma ezt a problémát, öltött testet Formencode könyvtár [formencode]: érvényesítése és átalakítás egy és ugyanaz a dolog, és lehet kezelni a múló nyers adatokat egy lánc érvényesítő. Minden validatornak ellenőrzéseket és / vagy átalakítja az adatokat és átadja azt, hogy a következő.
Ebben a szellemben konval egy olyan csomag, amely:
- Egy gazdag könyvtár érvényesítési tárgyak
- Alap osztályok számára könnyen termelő egyéni érvényesítő
- Funkciók segítségével egyszerűen érvényesítő különféle módokon
Állapot
konval van feltáró állapotban, hozta létre, hogy támogassa egy másik csomagot, hátha használatra is kiszállt általánosító átalakítás. Mint ilyen. ez még mindig egy korai kiadása és az API megváltoztathatja. Megjegyzés felkérést.
Telepítés
A legegyszerűbb módja annak, hogy telepítse konval keresztül easy_install [setuptools] vagy azzal egyenértékű program:
easy_install konval
Alternatívaként a tar lehet letölteni, és csomagolás setup.py run:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py telepíteni
konval egy modul, amely nem rendelkezik előfeltételek és kell dolgozni majdnem minden változat Python.
A konval
A teljes API benne van a forráskódban.
Példák
Leggyakrabban konval fogják használni, hogy ellenőrizze, vagy tiszta értékeket. Kudarcok eredményezheti kivételek dobálnak:
# Átalakítani felhasználói inputot a tényleges értéke
>>> From konval import *
>>> Sanitize ('1.0', ToInt ())
1
>>> Sanitize ("egy", ToInt ())
Lőfegyverét (legutolsó hívás utolsó)
...
ValueError: nem lehet átalakítani "1.0" egészrészre
Egy érvényesítő vagy lista átadhatók fertőtlenítse. Meghibásodást a fog eredményezni minden kivételt:
# Ellenőrizze a lista nem több, mint 3 tag
>>> Sanitize (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Ellenőrizze a jelszó elég hosszú
>>> Sanitize ("mypass ', [ToLength (), IsEqualOrMore (8)])
Lőfegyverét (legutolsó hívás utolsó)
...
ValueError: 6 kisebb, mint 8
Bármilyen lehívható objektum, amely elfogadja, hogy ezután egyetlen értéket lehet használni, mint egy érvényesítő:
>>> String import *
>>> Sanitize ("én" címmel, [strip, tőkét])
"Saját cím"
A gazdag könyvtár előre elkészített érvényesítő szállítjuk:
>>> Sanitize ("abcde", IsNonblank ())
"Abcde"
>>> Sanitize (5, IsInRange (1,6))
5
>>> Sanitize ("foo", szinonimák ({'ize': 'bar', 'BAZ': 'maze'}))
"Bar"
Egyedi érvényesítő könnyen subclassed egy mellékelt alap osztály:
osztály IsFoo (BaseValidator):
& Nbsp; def validate_value (self, érték):
& Nbsp; ha értéket! = 'Ize':
& Nbsp; self.raise_validation_error (érték)
& Nbsp; return true

Mi az új ebben a kiadásban:

• átnevezett egy pár validátorait következetesebb rendszer. Nevek rögzíteni kell teremteni.

követelmények :

• Python

Korlátozások :

• konval célja egy egyirányú átalakítása adatok fordult felhasználói vagy tárolt adatokat Python objektumok. Természetesen akkor lehetne használni fordított irányban, de ez nem egy elsődleges használata esetén. FormEncode épül kétirányú (oda-vissza) átalakítása adatok, így hasznos lehet a megoldás.


• A név konval azért választottuk, mert:
• már van ezzel Python könyvtár & quot; józanság & quot;
• ki & quot; Valcon & quot ;, & quot; Valkon & quot ;, & quot; conval & quot; stb volt az, aki a legkevesebb találatot a Google