Pydantic library extension with Brazilian fields
Project description
Pydantic BR
Essa é uma biblioteca de extensão e visa disponibilizar campos com validações brasileiras para a biblioteca pydantic.
Compatível com a versão v1 e v2 do Pydantic.
Código fonte: https://github.com/scjorge/pydantic_br
Documentação: https://pydantic-br.readthedocs.io
Disponibilidades
Campo | Grupo de Documentos | Nome do Documento | Método de validação | Situação |
---|---|---|---|---|
CNPJ | Pessoa Jurídica | Carteira Nacional de Pessoas Jurídicas | Digito Verificador | Concluído |
CPF | Pessoa física | Cadastro de Pessoa Física | Digito Verificador | Concluído |
CNH | Pessoa física | Carteira Nacional de Habilitação | Digito Verificador | Concluído |
TE | Pessoa física | Título de Eleitor | Digito Verificador | Concluído |
PIS | Pessoa física | Programa de Integração Social | Digito Verificador | Concluído |
CERT | Pessoa física | Certidão (Nascimento/Casamento/Óbito) | Digito Verificador | Concluído |
CNS | Pessoa física | Cartão Nacional de Saúde | Digito Verificador | Em desenvolvimento |
RENAVAM | Veículos | Registro Nacional de Veículos Automotores | RegExr | Em desenvolvimento |
PLACA | Veículos | Placa do Veículo | RegExr | Em desenvolvimento |
ISBN | Livros | Padrão Internacional de Numeração de Livro | Digito Verificador | Em desenvolvimento |
Instalação
Utilizando pip
pip install pydantic-br
Utilizando Poetry
poetry add pydantic-br
Exemplos de Utilização
Os exemplos de dados exemplificados foram tirados dos seguintes sites:
A má utilização dos dados é de total responsabilidade do usuário.
CPF válido
from pprint import pprint
from pydantic import BaseModel
from pydantic_br import CPF, CPFDigits, CPFMask
class Pessoa(BaseModel):
nome: str
cpf: CPF # aceita CPF válidos com ou sem máscara
cpf_mask: CPFMask # aceita CPF válido apenas com máscara
cpf_digits: CPFDigits # aceita CPF válido apnas com dígitos
p1 = Pessoa(
nome="João", cpf="53221394780", cpf_mask="532.213.947-80", cpf_digits="53221394780"
)
pprint(p1.dict())
Saída
{'cpf': '53221394780',
'cpf_digits': '53221394780',
'cpf_mask': '532.213.947-80',
'nome': 'João'}
CPF inválido
from pprint import pprint
from pydantic import BaseModel
from pydantic_br import CPF, CPFDigits, CPFMask
class Pessoa(BaseModel):
nome: str
cpf: CPF # aceita CPF válidos com ou sem máscara
cpf_mask: CPFMask # aceita CPF válido apenas com máscara
cpf_digits: CPFDigits # aceita CPF válido apenas com dígitos
p1 = Pessoa(
nome="João", cpf="00000000000", cpf_mask="53221394780", cpf_digits="532.213.947-80"
)
pprint(p1.dict())
Saída
Traceback (most recent call last):
p1 = Pessoa(
File "pydantic\main.py", line 341, in pydantic.main.BaseModel.__init__
pydantic.error_wrappers.ValidationError: 3 validation errors for Pessoa
cpf
invalid data (type=value_error.invalid_data)
cpf_mask
invalid mask format (type=value_error.invalid_mask)
cpf_digits
field only accept digits as string (type=value_error.not_digits)
Versões do Pydantic
Os exemplos acima estão escritos na versão v1 do Pydantic. Entretanto, funciona perfeitamente com a versão v2.
Então que mudará? Bem, os métodos de 'apresentação' das models foram alterados na v2.
- O método
dict()
foi alterado paramodel_dump()
- O método
schema()
foi alterado paramodel_json_schema()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pydantic_br-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f18b0d74f8c1e16348a4082ad30231c6f4d059f17eb1447c49ebf32557d0871a |
|
MD5 | 24b6f27e33f637e34f4189f67a4397f2 |
|
BLAKE2b-256 | 9b27086eb32e17de66c3fef56c6f711f1329256e5d2fb0f0b4ef581b97a99312 |