konval

Bakgrunn
Validering og konvertering av data.
Problemet med desinfiserende data (sjekke korrekthet og trans til en nyttig form) er utbredt over hele programmering:
- Hvordan kan jeg bekrefte brukerundersøkelser er riktig?
- Hvordan kan jeg munge data fra et regneark i datoer og tall?
- Hvordan konverterer jeg rå database felt inn i en programma objekt?
Ian Bicking kom opp med en fornuftig idiom for dette problemet, nedfelt i hans Formencode bibliotek [formencode]: validering og konvertering er en og samme ting, og kan håndteres ved å sende rådata gjennom en kjede av validatorer. Hver validator sjekker og / eller transformerer dataene og sender den videre til den neste.
I denne ånd, er konval en pakke som gir:
- Et rikholdig bibliotek av validerings gjenstander
- grunnklasser for enkelt å produsere tilpassede validatorer
- Funksjoner for enkelt ved hjelp validators i en rekke måter
Status
konval er i en utforskende tilstand, etter å ha blitt produsert for å støtte en annen pakke og se om bruken kan være fikk ut av general konvertering. Som sådan. det er fortsatt en tidlig løslatelse og API kan endre seg. Kommentaren er invitert.
Installasjon
Den enkleste måten å installere konval er via easy_install [setuptools] eller et tilsvarende program:
easy_install konval
Alternativt tarball kan lastes ned, pakket og setup.py run:
 tjære zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py installere
konval er en modul som ikke har noen forutsetninger og bør arbeide med bare om noen versjon av Python.
Ved hjelp konval
En full API er inkludert i kildefordelingen.
Eksempler
Oftest vil konval brukes til å kontrollere eller rene verdier. Svikt føre unntak blir kastet:
# Konvertere brukerundersøkelser til en faktisk heltall
>>> Fra konval import *
>>> Oppryddings ('1.0', ToInt ())
1
>>> Oppryddings ('en', ToInt ())
Traceback (siste samtale sist)
...
ValueError: kan ikke konvertere '1.0' til heltall
En enkelt validator eller en liste kan sendes til rense. Svikt i en hvilken som helst vil resultere i noen unntak:
# Sjekke en liste har ikke mer enn 3 medlemmer
>>> Oppryddings (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Sjekke et passord er lang nok
>>> Oppryddings ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (siste samtale sist)
...
ValueError: 6 er lavere enn 8
Enhver kallbart objekt som aksepterer og returnerer en enkeltverdi kan brukes som en validator:
>>> Fra string import *
>>> Oppryddings ("min tittel", [stripen, kapital])
'Min tittel'
En rikholdig bibliotek av forhåndsbygde validatorer leveres:
>>> Oppryddings ('abcde', IsNonblank ())
'Abcde'
>>> Oppryddings (5, IsInRange (1,6))
5
>>> Oppryddings ('foo', synonymer ({'foo': 'bar', 'Baz': 'quux'}))
'Bar'
Tilpassede validatorer kan enkelt subclassed fra en medfølgende base klasse:
klasse IsFoo (BaseValidator):
& Nbsp; def validate_value (selvtillit, verdi):
! & Nbsp; hvis verdi = 'foo':
& Nbsp; self.raise_validation_error (verdi)
& Nbsp; return true

Hva er nytt i denne versjonen:

• Omdøpt noen validatorer til mer konsekvent ordningen. Navnene skal være løst nå.

Krav

• Python

Begrensninger

• konval er rettet mot en enveis transformasjon av data, snu brukerundersøkelser eller lagres data i Python objekter. Sikkert er det kunne brukes i den motsatte retning, men dette er ikke en primær brukstilfelle. FormEncode er basert rundt toveis (rundtur) konvertering av data, slik at det kan være et nyttig alternativ.


• Navnet konval ble valgt fordi:
• Det finnes allerede en Python bibliotek kalt & quot; tilregnelighet & quot;
• ut av & quot; valcon & quot ;, & quot; valkon & quot ;, & quot; conval & quot; etc. det var den med færrest treff på Google