konval

Fonas "
Patvirtinimas ir atsivertimas duomenų.
Nuo valyti duomenis (tikrinimas teisingumą ir pertvarkyti į naudingą forma) problema yra plačiai paplitę visoje programavimo:
- Kaip aš galiu patikrinti naudotojo įvesties yra teisinga?
- Kaip man munge duomenis iš lentelės į datas ir numerius?
- Kaip aš galiu konvertuoti RAW duomenų bazės laukus į programinio objektą?
Ianas Bicking atėjo su protinga idioma šią problemą, įkūnytas jo formencode bibliotekoje [formencode]: patvirtinimas ir atsivertimas yra vienas ir tas pats dalykas, ir gali būti tvarkomi artimųjų neapdorotus duomenis per tvirtintojus grandinėje. Viename Walidator patikrinimai ir / arba transformuoja duomenis ir perduoda ją į kitą.
Šia dvasia konval yra paketas, kuris numato:
- Turtinga biblioteka patvirtinimo objektų
- bazinės klases lengvai gaminti pagal užsakymą tvirtintojus
- Funkcijos lengvai, naudojant autentiškumo tikrinimo ir įvairiais būdais
Būsena
konval yra parengti tiriamąją valstybės, kuri buvo pagaminta siekiant remti kitą paketą ir pamatyti, jei naudojimas gali būti išlipo apibendrinimo konversiją. Kaip toks. tai dar anksti spaudai ir "API gali keistis. Komentaras prašoma.
Diegimas
Paprasčiausias būdas įdiegti konval yra per easy_install [setuptools] arba lygiavertės programos:
easy_install konval
Arba tar galima atsisiųsti, išpakuoti ir setup.py paleisti:
 deguto zxvf konval.tgz
& Nbsp; CD konval
& Nbsp; pitonas set.py įdiegti
konval yra modulis, kuris neturi prielaidas ir turėtų dirbti su beveik bet Python versija.
Naudojant konval
Pilnas API įtraukti į šaltinio paskirstymo.
Pavyzdžiai
Dažniausiai konval bus naudojamas patikrinti ar švarios vertės. Gedimai sukelti mėto išimtys:
# Konvertuoti vartotojo įvestį į faktinį sveikasis skaičius
>>> Iš konval import *
>>> Iškarpyti filmą ("1.0", ToInt ())
1
>>> Iškarpyti filmą ("vieno", ToInt ())
Traceback (naujausia skambutis paskutinis)
...
ValueError: negali konvertuoti "1,0", kad sveikasis skaičius
Vieno vertintojas arba sąrašas gali būti perduota iškarpyti filmą. Jeigu bet sukels bet išskyrus:
# Patikrinti sąraše yra ne daugiau kaip 3 nariai
>>> Išvalyti (['', "b", "c"], [ToLength (), IsEqualOrLess (3)])
3
# Patikrinti slaptažodis yra pakankamai ilgai
>>> Iškarpyti filmą ("mypass" [ToLength (), IsEqualOrMore (8)])
Traceback (naujausia skambutis paskutinis)
...
ValueError: 6 yra mažesnis nei 8
Bet koks jų pareikalauti objektas, kuri priima ir grąžina vieną reikšmę, gali būti naudojamas kaip tvirtintojas:
>>> Iš styginių import *
>>> Iškarpyti filmą ("mano pavadinimas" [juostelės, kapitalizuoti])
"Mano antraštinė dalis"
Turtingas biblioteka sukompiliuotas tvirtintojus tiekiamas:
>>> Išvalyti (ABCDE "IsNonblank ())
"ABCDE"
>>> Išvalyti (5, IsInRange (1,6))
5
>>> Iškarpyti filmą ("Foo" Sinonimai ({"Foo": "baras", "bazių": "quux"}))
"Baras"
Individualizuotos autentiškumo tikrinimo gali būti lengvai poklasiu iš tiekiamo pagrindinės klasės:
klasė IsFoo (BaseValidator):
& Nbsp; Def validate_value (savarankiškai, vertė):
! & Nbsp; jei vertė = 'rūšys':
& Nbsp; self.raise_validation_error (vertė)
& Nbsp; grąžina true

Kas naujo , šioje laidoje:

• pervadintas keletą autentiškumo tikrinimo ir nuosekliau schemą. Vardai turi būti nustatytas dabar.

Reikalavimai

• Python,

Apribojimai

• konval siekiama į vieną pusę transformacijos duomenis, tekinimo naudotojo įvesties arba saugomi duomenis į Python objektų. Žinoma, jis gali būti naudojamas priešinga kryptimi, bet tai nėra pirminis naudojimo atveju. Formencode yra aplink dviejų krypčių (pirmyn ir atgal) konvertuoti duomenis, kad gali būti naudinga alternatyva.


• vardas konval buvo pasirinkta, nes: "
• ten jau Python biblioteka vadinama & quot; normalumas & quot;
• iš & quot; & quot ;, valcon & quot; & quot ;, VALKON & quot; conval & quot; ir tt tai buvo viena su mažiausiai paspaudimų ant Google "