konval

Background
Validarea și conversia datelor.
Problema igienizarea date (verificarea corectitudinii și transformarea într-o formă utilă) este larg răspândită în întreaga programare:
- Cum pot verifica datele introduse de utilizator este corectă?
- Cum pot munge date de la o foaie de calcul în date și numere?
- Cum convertesc domenii de baze de date brute într-un obiect programatic?
Ian Bicking venit cu un idiom sensibil pentru această problemă, întruchipat în biblioteca lui Formencode [formencode]: validare și conversie sunt unul și același lucru, și pot fi manipulate prin trecerea datelor brute printr-un lanț de validatoare. Fiecare controale validator și / sau transformă datele și trece-l pe la alta.
În acest spirit, konval este un pachet care oferă:
- O biblioteca bogata de obiecte de validare
- cursuri de bază pentru producerea de ușor validatoare personalizate
- Funcții de ușor utilizând validatoare într-o varietate de moduri
Stare
konval este într-o stare de explorare, au fost produse pentru a sprijini un alt pachet și vezi dacă utilizarea poate fi ieșit din generalizarea conversie. Ca atare. este încă o versiune timpurie și API poate schimba. Comentariu este invitat.
Instalare
Cel mai simplu mod de a instala konval este prin easy_install [setuptools] sau un program de echivalent:
easy_install konval
Alternativ arhiva poate fi descărcat, despachetat și a alerga setup.py:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py instala
konval este un modul care nu are nici premise și ar trebui să lucreze cu doar despre orice versiune de Python.
Utilizarea konval
Un API complet este inclus în distribuția sursă.
Exemple
Cel mai frecvent, konval vor fi utilizate pentru a verifica sau valorile curate. Eșecuri duce la excepțiile fiind aruncat:
# Converti introduse de utilizator într-un întreg actual
>>> Din import konval *
>>> Asanare ("1.0", ToInt ())
1
>>> Asanare ("o", ToInt ())
Traceback (cel mai recent apel ultima)
...
ValueError: nu poate converti "1.0" la număr întreg
Un singur validator sau listă poate fi trecut de asanare. Nerespectarea în orice va duce la nici o excepție:
# Verifica o listă nu are mai mult de 3 membri
>>> Asanare (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Verifica parola este suficient de lung
>>> Asanare ("mypass", [ToLength (), IsEqualOrMore (8)])
Traceback (cel mai recent apel ultima)
...
ValueError: 6 este mai mică de 8
Orice obiect nevărsat care acceptă și returnează o singură valoare poate fi folosit ca un validator:
>>> Din șir import *
>>> Asanare ("titlul meu", [benzi, valorifica])
"Titlul meu"
O bibliotecă bogată de validatoare precompilate sunt furnizate:
>>> Asanare ("abcde", IsNonblank ())
"Abcde"
>>> Igienizarea (5, IsInRange (1,6))
5
>>> Asanare ("foo", Sinonime ({'foo': 'bar', 'Baz ":" quux "}))
"Bar"
Validatoare personalizate pot fi ușor subclasată dintr-o clasa de baza furnizate:
clasa IsFoo (BaseValidator):
& Nbsp; def validate_value (auto, valoare):
! & Nbsp; dacă valoarea = 'foo':
& Nbsp; self.raise_validation_error (valoare)
& Nbsp; a reveni Adevărat

Ce este nou în această versiune:

• Renamed câteva validatoare pentru schema mai consistent. Denumiri trebuie stabilit acum.

Cerințe :

• Python

Limitări :

• konval vizează o transformare într-o direcție de date, transformându introduse de utilizator sau stocate date în obiecte Python. Desigur, ar putea fi folosită în sens invers, însă acest lucru nu este un caz de utilizare primar. FormEncode se bazează pe două căi (dus-intors) conversia datelor, astfel încât poate fi o alternativa utila.

Numele konval a fost ales deoarece:
• există deja o bibliotecă Python numit & quot; bun-simț & quot;
• din & quot; & quot ;, Valcon & quot; & quot ;, valkon & quot; conval & quot; etc. a fost cea cu cele mai puține lovituri pe Google