konval

Contexte
Validation et la conversion des données.
Le problème de l'assainissement des données (vérification exactitude et la transformation d'une forme utile) est très répandue dans la programmation:
- Comment puis-je vérifier l'entrée d'utilisateur est correct?
- Comment puis-je Munge données à partir d'une feuille de calcul dans les dates et les chiffres?
- Comment puis-je convertir les champs de base de données brutes en un objet programmatique?
Ian Bicking venu avec un idiome raisonnable pour ce problème, incarnée dans sa bibliothèque Formencode [formencode]: la validation et de conversion sont une seule et même chose, et peuvent être manipulés par le passage des données brutes à travers une chaîne de validateurs. Chaque contrôles de validateur et / ou transforme les données et les transmet à la suivante.
Dans cet esprit, konval est un package qui fournit:
- Une riche bibliothèque d'objets de validation
- classes de base pour produire facilement des validateurs
- Pour l'utilisation de fonctions facilement validateurs dans une variété de façons
Statut
konval est dans un état exploratoire, ayant été produite pour soutenir un autre paquet et de voir si l'utilisation peut être sorti de la généralisation de la conversion. En tant que tel. il est toujours une libération précoce et l'API peut changer. Commentaire est invité.
Installation
La façon la plus simple d'installer konval est via easy_install [setuptools] ou un programme équivalent:
easy_install konval
Sinon l'archive peut être téléchargé, décompressé et exécuté setup.py:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py installer
konval est un module qui n'a pas de conditions préalables et devrait fonctionner avec à peu près aucune version de Python.
Utilisation konval
Une API complet est inclus dans la distribution source.
Exemples
Le plus souvent, konval sera utilisé pour vérifier ou les valeurs propres. Les échecs résultent dans les exceptions étant jetés:
# Convertir une entrée d'utilisateur pour un nombre entier réel
>>> D'importation konval *
>>> Désinfection ('1.0', ToInt ())
1
>>> Désinfection («un», ToInt ())
Retraçage (appel le plus récent dernière)
...
ValueError: ne peut pas convertir '1.0' en entier
Un validateur unique ou liste peuvent être transmises à désinfecter. L'échec de toute entraînera aucune exception:
# Vérifier une liste n'a pas plus de 3 membres
>>> Désinfection (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Vérifier un mot de passe est assez long
>>> Désinfection ('mypass', [ToLength (), IsEqualOrMore (8)])
Retraçage (appel le plus récent dernière)
...
ValueError: 6 est inférieure à 8
Tout objet appelable qui accepte et renvoie une valeur unique peut être utilisé comme un validateur:
>>> From chaîne import *
>>> Désinfection ("mon titre", [bande, de capitaliser])
«Mon titre '
Une riche bibliothèque de validateurs prédéfinis est fourni:
>>> Désinfection («ABCDE», IsNonblank ())
«ABCDE»
>>> Désinfection (5, IsInRange (1,6))
5
>>> Désinfection ('foo', synonymes ({'foo': 'bar', 'baz': 'quux'}))
'Bar'
validateurs personnalisés peuvent facilement être sous-classé à partir d'une classe de base fourni:
classe isFoo (BaseValidator):
& Nbsp; def validate_value (auto, valeur):
! & Nbsp; si la valeur = 'foo':
& Nbsp; self.raise_validation_error (valeur)
& Nbsp; renvoyer Vrai

Quoi de neuf dans cette version:

• Rebaptisé quelques validateurs de régime plus cohérent. Les noms doivent être fixés aujourd'hui.

Exigences :

• Python

Limitations :

• konval vise à une transformation unidirectionnelle des données, tournant entrée d'utilisateur ou stockées données dans des objets Python. Il est certain qu'elle pourrait être utilisée dans le sens inverse, mais ceci est un cas d'utilisation non primaire. FormEncode est basé autour de deux sens (aller-retour) conversion des données, de sorte que peut être une alternative utile.


• Le nom a été choisi parce konval:
• Il ya déjà une bibliothèque Python appelé & quot; la santé mentale & quot;
• sur & quot; & quot ;, Valcon & quot; & quot ;, Valkon & quot; Conval & quot; etc., il était celui avec le moins de hits sur Google