konval

Hintergrund
Validierung und Konvertierung von Daten.
Das Problem der Desinfektion Daten (Überprüfung Richtigkeit und die Umwandlung in eine nützliche Form) ist weit verbreitet in der Programmierung:
- Wie kann ich überprüfen, Benutzereingaben korrekt ist?
- Wie kann ich munge Daten aus einer Tabelle in Daten und Zahlen?
- Wie kann ich rohen Datenbankfelder in einer programmatischen Objekt zu konvertieren?
Ian Bicking kam mit einer sinnvollen Idiom für dieses Problem in seiner Formencode Bibliothek [formencode] verkörpert: Validierung und Konvertierung sind ein und dasselbe, und kann, indem Rohdaten durch eine Kette von Validatoren behandelt werden. Jede Prüfung Schecks und / oder umwandelt, die Daten und leitet sie an die nächste.
In diesem Sinne ist konval ein Paket, das lautet:
- Eine umfangreiche Bibliothek von Validierungsobjekte
- Basisklassen zur einfachen Herstellung von kundenspezifischen Validatoren
- Funktionen zum leicht mit Prüfungen in einer Vielzahl von Weisen
Status
konval ist in einer explorativen Zustand, nachdem er produziert, um ein anderes Paket unterstützt und ob die Nutzung kann von Verallgemeinerung Konvertierung bekommen werden. Als solche. es ist immer noch eine vorzeitige Entlassung und die API können sich ändern. Kommentieren ist eingeladen.
Installation
Der einfachste Weg, konval zu installieren, ist easy_install [Setuptools] oder einem gleichwertigen Programm:
easy_install konval
Alternativ kann das Tar-Archiv heruntergeladen werden, ausgepackt und setup.py Lauf:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py installieren
konval ist ein Modul, das keine Voraussetzungen hat und sollte mit nahezu jeder Version von Python zu arbeiten.
Mit konval
Eine vollständige API wird in der Source-Distribution enthalten.
Beispiele
Am häufigsten wird konval verwendet werden, um zu überprüfen oder Werte sauber werden. Ausfälle führen zu Ausnahmen geworfen:
# Zu konvertieren Benutzereingaben zu einer tatsächlichen ganzen Zahl
>>> Von konval import *
>>> Sanitize ('1.0', ToInt ())
1
>>> Sanitize ("eins", ToInt ())
Traceback (jüngste Aufforderung zuletzt)
...
Valueerror: Konvertierung '1.0' nach integer
Eine einzige Validator oder Liste geführt werden kann, um zu desinfizieren. Wird in auf jeden Exception:
# Überprüfen eine Liste nicht mehr als 3 Mitglieder
>>> Sanitize (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Überprüfen ein Passwort ist lang genug,
>>> Sanitize ('mypass' [ToLength () IsEqualOrMore (8)])
Traceback (jüngste Aufforderung zuletzt)
...
Valueerror: 6 niedriger als 8
Alle Callable-Objekt, das einen einzigen Wert akzeptiert und können als Prüfung eingesetzt werden:
>>> From string import *
>>> Sanitize ("mein Titel", [Streifen, Kapital])
"Mein Titel"
Eine reiche Bibliothek mit vordefinierten Validatoren geliefert:
>>> Sanitize ('abcde', IsNonblank ())
'Abcde'
>>> Sanitize (5, IsInRange (1,6))
5
>>> Sanitize ('foo', Synonyme ({'foo': 'bar', 'baz': 'quux'}))
'Bar'
Eigene Prüfungen kann leicht von einer mitgelieferten Basisklasse in Unterklassen unterteilt werden:
Klasse IsFoo (BaseValidator):
& Nbsp; def validate_value (self, Wert):
! & Nbsp; wenn value = 'foo':
& Nbsp; self.raise_validation_error (Wert)
& Nbsp; True zurück

Was ist neu in dieser Pressemitteilung:

• umbenannt einige Validatoren, um einheitlichere Regelung. Namen sollten nun behoben sein.

Anforderungen :

• Python

Einschränkungen :

• konval bei einem One-Way-Transformation von Daten ausgerichtet und wandte Benutzereingabe oder gespeichert Daten in Python-Objekte. Sicherlich ist es in umgekehrter Richtung verwendet werden könnten, aber dies ist nicht eine primäre Anwendungsfall. FormEncode um Zwei-Wege (hin und zurück) Umwandlung von Daten auf der Basis, so dass eine sinnvolle Alternative sein.


• Der Name wurde gewählt, weil konval:
• es bereits Python-Bibliothek namens & quot; geistige Gesundheit & quot;
• aus & quot; Valcon & rdquo ;, & rdquo; Valkon & rdquo ;, & rdquo; CONVAL & quot; etc. Es war derjenige mit den wenigsten Zugriffe auf Google