konval

Antecedentes
Validación y conversión de datos.
El problema de la higienización de datos (comprobación de la corrección y la transformación a una forma útil) es generalizado en toda la programación:
- ¿Cómo verifico la entrada del usuario es correcta?
- ¿Cómo Munge datos de una hoja de cálculo en las fechas y los números?
- ¿Cómo puedo convertir los campos de base de datos en bruto en un objeto programática?
Ian Bicking subió con un lenguaje razonable para este problema, encarnado en su biblioteca Formencode [formencode]: validación y conversión son una y la misma cosa, y pueden ser manejados por pasar los datos en bruto a través de una cadena de validadores. Cada validador comprueba y / o transforma los datos y se lo pasa a la siguiente.
En este espíritu, konval es un paquete que ofrece:
- Una rica biblioteca de objetos de validación
- clases de base para producir fácilmente validadores personalizados
- Funciones para fácilmente usando validadores en una variedad de maneras
Estado
konval está en un estado de exploración, habiéndose producido para apoyar otro paquete y ver si su uso se puede sacó de generalizar la conversión. Como tal. todavía es una libertad anticipada y la API puede cambiar. Se invita comentario.
Instalación
La forma más sencilla de instalar konval es a través easy_install [setuptools] o un programa equivalente:
easy_install konval
Alternativamente, el tarball puede ser descargado, desempaquetado y correr setup.py:
 tar zxvf konval.tgz
& Nbsp; konval cd
& Nbsp; python set.py instalar
konval es un módulo que no tiene requisitos previos y debe trabajar con casi cualquier versión de Python.
Uso konval
Un API completo se incluye en la distribución fuente.
Ejemplos
Por lo general, konval se utilizará para comprobar o valores limpias. Las fallas resultan en excepciones son lanzadas:
# Convertir la entrada de usuario a un número entero real
>>> De importación konval *
>>> Esterilice ('1.0', Toint ())
1
>>> Esterilice ("uno", Toint ())
Rastreo (llamadas recientes más última)
...
ValueError: no se puede convertir '1.0' a entero
Un único validador o la lista se pueden pasar a desinfectar. El incumplimiento de alguna dará lugar a ninguna excepción:
# Comprobar una lista no tiene más de 3 miembros
>>> Esterilice (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Comprobar una contraseña es lo suficientemente largo
>>> Esterilice ('mypass', [ToLength (), IsEqualOrMore (8)])
Rastreo (llamadas recientes más última)
...
ValueError: 6 es inferior a 8
Cualquier objeto invocable que acepta y devuelve un solo valor puede ser utilizado como un validador:
>>> From import string *
>>> Esterilice ("mi título", [tira, capitalizar])
'Mi título'
Una amplia biblioteca de validadores prediseñados se suministra:
>>> Esterilice ('abcde', IsNonblank ())
'Abcde'
>>> Desinfección (5, EstaEnRango (1,6))
5
>>> Esterilice ('foo', sinónimos ({'foo': 'bar', 'baz': 'quux'}))
'Bar'
Validadores personalizados pueden ser fácilmente subclases de una clase base suministrado:
clase isFoo (BaseValidator):
& Nbsp; def validate_value (self, valor):
! & Nbsp; si el valor = 'foo':
& Nbsp; self.raise_validation_error (valor)
& Nbsp; devolverá True

¿Cuál es nuevo en esta versión:

• Renombrado unos validadores al esquema más consistente. Los nombres deben fijarse ahora.

Requisitos

• Python

Limitaciones

• konval está dirigida a una transformación de un solo sentido de los datos, convirtiendo la entrada del usuario o almacenada datos en objetos de Python. Ciertamente, podría ser utilizado en la dirección inversa, pero esto no es un caso de uso primario. FormEncode se basa alrededor de dos vías (ida y vuelta) de conversión de datos, por lo que puede ser una alternativa útil.


• Se eligió el nombre konval porque:
• ya hay una biblioteca de Python llamada & quot; la cordura & quot;
• de & quot; & quot ;, valcon & quot; & quot ;, Valkon & quot; Conval & quot; etc. que era el de los éxitos menor número de Google