konval

Fundo
Validação e conversão de dados.
O problema de sanitização de dados (verificação de correcção e transformando a uma forma útil) é generalizado em toda a programação:
- Como faço para verificar a entrada do usuário está correto?
- Como faço para munge dados de uma planilha em datas e números?
- Como faço para converter campos de banco de dados brutos em um objeto programático?
Ian Bicking veio com uma expressão sensata para esse problema, consubstanciado na sua biblioteca FormEncode [FormEncode]: validação e conversão são uma ea mesma coisa, e pode ser manuseada por passar dados em bruto através de uma cadeia de validadores. Cada validador verifica e / ou transforma os dados e passa para a próxima.
Neste espírito, konval é um pacote que prevê:
- Uma rica biblioteca de objetos de validação
- classes de base para a produção facilmente validadores customizados
- As funções para utilizar facilmente validadores em uma variedade de formas
Status
konval está em um estado exploratório, tendo sido produzidas para apoiar outro pacote e veja se o uso pode ser saiu de generalizar conversão. Como tal. ainda é uma libertação antecipada ea API pode mudar. Comentar é convidado.
Instalação
A maneira mais simples de instalar konval é via easy_install [setuptools] ou um programa equivalente:
easy_install konval
Em alternativa, o arquivo tar pode ser baixado, descompactado e executado setup.py:
 tar zxvf konval.tgz
& Nbsp; cd konval
& Nbsp; python set.py instalar
konval é um módulo que não tem pré-requisitos e deve funcionar com praticamente qualquer versão do Python.
Usando konval
A API completo está incluído na distribuição fonte.
Exemplos
Mais comumente, konval vai ser utilizado para verificar ou valores limpas. Falhas resultar em exceções sendo lançadas:
# Converter a entrada do usuário para um número inteiro real
>>> From importação konval *
>>> Sanitize ('1.0', ToInt ())
1
>>> Sanitize ('one', ToInt ())
Traceback (most recent call last)
...
ValueError: não é possível converter '1.0' para inteiro
Um único validador ou lista pode ser passada para desinfetar. A reprovação em qualquer resultará em qualquer exceção:
# Verificar uma lista não tem mais de 3 membros
>>> Sanitize (['a', 'b', 'c'], [ToLength (), IsEqualOrLess (3)])
3
# Verifique uma senha é longo o suficiente
>>> Sanitize ('mypass', [ToLength (), IsEqualOrMore (8)])
Traceback (most recent call last)
...
ValueError: 6 é menor do que 8
Qualquer objecto que pode ser chamado que aceita e retorna um valor único pode ser utilizado como um validador:
>>> From import string *
>>> Sanitize ("o meu título", [tira, capitalizar])
'O meu título'
Uma rica biblioteca de validadores pré-construídos é fornecido:
>>> Sanitize ('ABCDE', IsNonblank ())
'ABCDE'
>>> Sanitize (5, IsInRange (1,6))
5
>>> Sanitize ('foo', sinônimos ({'foo': 'bar', 'baz': 'quux'}))
'Bar'
Validadores customizados podem ser facilmente subclasse de uma classe base fornecido:
classe isFoo (BaseValidator):
& Nbsp; def validate_value (self, valor):
! & Nbsp; se value = 'foo':
& Nbsp; self.raise_validation_error (valor)
& Nbsp; retornar True

O que é novo nesta versão:

• Renomeado alguns validadores de esquema mais consistente. Os nomes devem ser corrigidos agora.

Requisitos :

• Python

Limitações :

• konval é dirigido a um one-way transformação de dados, transformando a entrada do usuário ou armazenados dados em objetos Python. Certamente, que poderiam ser utilizados na direcção inversa, mas este não é um caso de uso primário. FormEncode é baseado em torno de dois sentidos (ida e volta) a conversão de dados, de modo que pode ser uma alternativa útil.


• O nome foi escolhido porque konval:
• já existe uma biblioteca Python chamado & quot; sanidade & quot;
• fora de & quot; Valcon & quot ;, & quot; Valkon & quot ;, & quot; conval & quot; etc. era aquele com o menor número de acessos em Google