konval

Background
Validointi ja muuntaa tietoja.
Ongelma desinfiointiin tietojen (tarkistus oikeellisuuden ja muuntautumaan hyödyllinen lomake) on yleistä kaikissa ohjelmointi:
- Miten voin vahvistaa käyttäjä syöttää on oikea?
- Miten munge tietoja taulukkosi päivämäärät ja numerot?
- Miten muuntaa raaka tietokannan kenttiä ohjelmallinen esine?
Ian Bicking keksi järkevää sanonta tähän ongelmaan, ilmentää hänen FormEncode kirjastossa [FormEncode]: validointi ja muuntaminen ovat yksi ja sama asia, ja voidaan käsitellä johtamalla raakadatan läpi ketjun validaattorin. Jokainen validator tarkastuksia ja / tai muuntaa datan ja siirtää sen seuraavalle.
Tässä hengessä konval on paketti, joka sisältää:
- Rikas kirjaston validointi esineiden
- Base luokat helposti tilaustyönä validators
- Toiminnot helposti käyttämällä validaattoreihin eri tavoilla
tila
konval on valmistelevassa tilassa, jotka on tuotettu tukemaan toista pakettia ja katso jos käyttöä voidaan riistäytynyt yleistyksiä muuntaminen. Sellaisenaan. se on vielä aikaista vapautumista ja API voi muuttua. Kommentti on kutsuttu.
asennus
Yksinkertaisin tapa asentaa konval on kautta easy_install [setuptools] tai vastaava ohjelma:
easy_install konval
Vaihtoehtoisesti tarrapallon voidaan ladata, purettu ja setup.py run:
 terva zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py asentaa
konval on moduuli, joka ei ole edellytyksiä, ja pitäisi toimia juuri mitään versiota Python.
käyttäminen konval
Täydellinen API on mukana lähde jakelussa.
Esimerkkejä
Yleisimmin konval käytetään tarkistaa tai puhdistaa arvoja. Epäonnistumiset aiheuttaa poikkeuksia heitetään:
# Muuntaa käyttäjä syöttää todellinen kokonaisluku
>>> Alkaen konval tuonti *
>>> Desinfioi ('1,0', ToInt ())
1
>>> Desinfioi ("yksi", ToInt ())
Paluuseurannan (viimeisin kutsu viimeinen)
...
ValueError: ei voi muuntaa '1.0' integer
Yksittäinen validator tai luetteloa voidaan siirtää puhdistaa. Epäonnistuminen tahansa johtaa mitään poikkeusta:
# Tarkista Listalla on enintään 3 jäsentä
>>> Desinfioi (['', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Tarkista salasana on riittävän pitkä
>>> Desinfioi ('mypass', [ToLength (), IsEqualOrMore (8)])
Paluuseurannan (viimeisin kutsu viimeinen)
...
ValueError: 6 on pienempi kuin 8
Mikä tahansa omavelkaisia ​​esine, joka hyväksyy ja palauttaa yksi arvo voidaan käyttää Validator:
>>> Merkkijono tuonti *
>>> Desinfioi ("my otsikko", [strip, hyödyntämään])
"Oma otsikko"
Rikas kirjasto esikäännettyjen validaattorin toimitetaan:
>>> Desinfioi ("abcde", IsNonblank ())
"Abcde"
>>> Desinfioi (5, IsInRange (1,6))
5
>>> Desinfioi ('foo', Synonyymit ({'foo': "bar", "Baz ':' quux '}))
"Bar"
Custom validators voidaan helposti subclassed alkaen mukana perustaa luokan:
luokan IsFoo (BaseValidator):
& Nbsp; def validate_value (itse, arvo):
& Nbsp; jos arvo! = 'Foo':
& Nbsp; self.raise_validation_error (arvo)
& Nbsp; palauttaa True

Mikä on uusi tässä julkaisussa:

• Uusi nimi muutama validators enemmän johdonmukaista järjestelmää. Nimet olisi vahvistettava nyt.

vaatimukset

• Python

rajoitukset

• konval pyritään yksisuuntaisen muutoksen datan, kääntämällä käyttäjän toimia tai varastoidaan data Python objekteja. Varmasti sitä voidaan käyttää vastakkaiseen suuntaan, mutta se ei ole ensisijainen käyttötapaus. FormEncode perustuu noin kaksisuuntainen (edestakainen matka) muuntaa tietoja, jotta voi olla käyttökelpoinen vaihtoehto.


• Nimi konval valittiin, koska:
• siellä jo Python kirjasto nimeltään & quot; järki & quot;
• ulos & quot; Valcon & quot ;, & quot; Valkon & quot ;, & quot; conval & quot; jne se oli yksi vähiten osumia Googlessa