Skip to main content

Brazilian document validator using the check digit

Project description

validdocbr

  • Validador do padrão numérico de documentos brasileiros com base no dígito verificador.
  • Deve ser utilizado apenas para uma pré validação e não ser considerado como validador oficial. Para validação oficial, favor consultar os entidades específicas para cada documento e/ou cartão.

Instalação:

pip install validdocbr
pip3 install validdocbr

Documentos validados:

  • CPF
  • CNPJ
  • RG
  • CNH
  • RENAVAM
  • Título de eleitor

Outros validadores:

  • Cartão de crédito

Construtores:

  • Máscara para RG
  • Máscara para CPF
  • Máscara para CNPJ

Utilização:

  • Enviar (como string) o número do documento que deseja como parâmetro da função. Pode conter máscara.

Exemplos validadores:

  • Importar o validador e instanciá-lo:
from validdocbr import validdocbr

validator = validdocbr()   
  • CPF
validator.cpf("12345678999") ---> para validar padrão do CPF      
  • CNPJ
validator.cnpj("12345678000189") ---> para validar padrão do CNPJ      
  • CNH
validator.cnh("01234567890") ---> para validar padrão do CNH      
  • RENAVAM
validator.renavam("01234567890") ---> para validar padrão do RENAVAM      
  • RG
validator.rg("123456789") ---> para validar padrão do RG      
  • Título de eleitor
validator.te("123456789") ---> para validar padrão do Título de eleitor      
  • Cartão de crédito
validator.cc("1234567890123456") ---> para validar padrão do Cartão de crédito
  • Tipos de respostas para os validadores
True ---> caso padrão do documento seja válido     
False ---> caso padrão do documento seja inválido      

Exemplos construtores:

  • Máscara para RG
validator.rg_mask("123456789") ---> Para máscara em RG
  • Máscara para CPF
validator.cpf_mask("12345678901") ---> Para máscara em CPF
  • Máscara para CNPJ
validator.cnpj_mask("12345678901234") ---> Para máscara em CNPJ
  • Tipos de respostas para os construtores
máscara RG ---> "12.345.678-9"     
máscara CPF ---> "123.456.789-01"     
máscara CNPJ ---> "12.345.678/0001-90"     
False ---> caso quantidade de dígitos do documento esteja incorreta (RG = 9, CPF = 11, CNPJ = 14)      

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

validdocbr-1.2.2.tar.gz (2.5 kB view hashes)

Uploaded Source

Built Distribution

validdocbr-1.2.2-py3-none-any.whl (3.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page