konval

tle
Walidacja i konwersji danych.
Problem odkażania danych (sprawdzanie poprawności i przekształcanie do użytecznej formie) jest powszechna w całym programowania:
- Jak sprawdzić, czy dane wprowadzone przez użytkownika jest prawidłowe?
- Jak mogę munge dane z arkusza kalkulacyjnego do dat i liczb?
- W jaki sposób przekształcić surowce pola bazy danych do programowej przedmiotu?
Ian Bicking wymyślił sensownej idiomu tego problemu, ucieleśnionego w swojej bibliotece Formencode [formencode]: walidacja i konwersji to jedno i to samo, a może być obsługiwane przez przejście surowych danych poprzez sieć weryfikatorów. Każdy sprawdza Validator i / lub przekształca dane i przekazuje go do następnej.
W tym duchu, konval to pakiet, który zapewnia:
- Bogata biblioteka obiektów walidacji
- klasy bazowe do produkcji własnych weryfikatorów łatwością
- Funkcje łatwo za pomocą weryfikatorów w różnych sposobów
Stan
konval jest w stanie rozpoznawczej, został opracowany w celu wsparcia inny pakiet i czy można korzystać można wysiadł z uogólniania konwersji. Takie jak. nadal jest przedterminowe zwolnienie i API mogą ulec zmianie. Komentarz jest zaproszony.
instalacji
Najprostszym sposobem zainstalowania konval jest poprzez easy_install [setuptools] lub równoważną programu:
easy_install konval
Alternatywnie archiwum tar można pobrać, uruchomić setup.py rozpakowaniu i:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py zainstalować
konval jest moduł, który nie ma żadnych przesłanek i powinien współpracować z niemal każdym wersji Pythona.
Korzystanie konval
Pełne API jest zawarta w dystrybucji źródłowej.
Przykłady
Najczęściej konval zostaną wykorzystane w celu sprawdzenia czy czyste wartości. Awarie powodują wyjątki wyrzucane:
# Konwersji danych wprowadzonych przez użytkownika do rzeczywistej liczby całkowitej
>>> Z konval importu *
>>> Sanitize ("1.0", ToInt ())
1
>>> Sanitize ("jeden", ToInt ())
Traceback (najnowsze połączenie ostatnia)
...
ValueError: nie można przekonwertować "1,0" do liczby całkowitej
Pojedynczy walidator lub listy mogą być przekazywane do dezynfekcji. Niedopełnienie któregokolwiek spowoduje żadnego wyjątku:
# Sprawdzić lista ma nie więcej niż 3 członków
>>> Sanitize (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Sprawdzić hasło jest wystarczająco długi
>>> Sanitize ("mojehasło '[ToLength () IsEqualOrMore (8)])
Traceback (najnowsze połączenie ostatnia)
...
ValueError: 6 jest niższa niż 8
Każdy obiekt, który wpłacone akceptuje i zwraca jedną wartość mogą być wykorzystane jako weryfikatora:
>>> Z importu smyczkowy *
>>> Sanitize ("mój tytuł", [taśma wykorzystać])
"Mój tytuł"
Bogata biblioteka prekompilowanych weryfikatorów dostarczany jest:
>>> Sanitize ("abcde", IsNonblank ())
"Abcde"
>>> Sanitize (5, IsInRange (1,6))
5
>>> Sanitize ('foo', Synonimy ({'foo': 'bar', 'baz': 'QUUX'}))
"Bar"
Zatwierdzające niestandardowe można łatwo podklasy z dostarczonej klasy podstawowej:
Klasa IsFoo (BaseValidator):
& Nbsp; def validate_value (self, wartości):
! & Nbsp; jeśli wartość = "foo":
& Nbsp; self.raise_validation_error (wartość)
& Nbsp; return true

Co nowego w tym wydaniu:

• Zmiana nazwy kilku weryfikatorów się bardziej spójne schematu. Nazwy powinny być ustalone teraz.

Wymagania :

• Python

Ograniczenia :

• konval ma na celu jednokierunkowej transformacji danych, obrót lub przechowywane dane wprowadzane przez użytkownika danych do obiektów Pythona. Z pewnością można to stosować w odwrotnym kierunku, lecz nie jest to przypadek użycia podstawowej. FormEncode opiera się na dwukierunkowej (w obie strony), konwersja danych, tak, że może być przydatne rozwiązanie.


• Nazwa konval został wybrany, ponieważ:
• nie jest już biblioteka Pythona o nazwie & quot; rozsądek & bdquo;
• z & quot; & quot ;, VALCON & quot; & quot ;, valkon & quot; conval & quot; itp to był jeden z najmniejszą ilością odsłon Google