Skip to content

luiz158/brutils-python

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

brutils

Compatível com Python 2.7 e 3.x

brutils é uma biblioteca para tratar de validações de documentos brasileiros, e que eventualmente pode evoluir para tratar de outras coisas dentro do escopo de validações relacionadas a burocracias brasileiras.

Sua principal funcionalidade é a validação de CPFs e CNPJs, mas sugestões sobre outras coisas a se validar (preferencialmente de maneira determinística) são bem vindas.

Instalação

pip install brutils 

Utilização

Importando a Biblioteca:

>>> from brutils import cpf, cnpj 

Como faço para validar um CPF ou CNPJ?

# somente numeros, em formato string >>> cpf.validate('00011122233') False >>> cnpj.validate('00111222000133') False 

E se a minha string estiver formatada com simbolos?

>>> cpf.sieve('000.111.222-33') '00011122233' >>> cnpj.sieve('00.111.222/0001-00') '00111222000100' # A função `sieve` limpa apenas os simbolos de formatação de CPF ou CNPJ, e de # whitespace nas pontas. Ela não remove outros caractéres propositalmente, pois # estes seriam indicativos de uma possível corrupção no dado ou de uma falta de # filtros de input. 

E se eu quiser formatar uma string numérica?

>>> cpf.display('00011122233') '000.111.222-33' >>> cnpj.display('00111222000100') '00.111.222/0001-00' 

E se eu quiser gerar CPFs ou CNPJs validos aleatórios?

>>> cpf.generate() '17433964657' >>> cnpj.generate() '34665388000161' 

Testes

python2.7 -m unittest discover tests/ python3 -m unittest discover tests/ 

About

🇧🇷 Validador de CPF e CNPJ para Python 2.7 e 3.x

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%