Skip to main content

Wltr Doc Validate

Project description

Wltr Doc Validate

PyPI

Build Status

Autor

👤 Walter Avelino

📝 Licença

Copyright © 2020 Walter Avelino.
Os projetos estão sob a licença MIT.

Pacote para validação de documentos

Instalação do Wltr Doc Validate

Para instalar o pacote:

pip install wltr-doc-validate

Métodos

Os documentos possuem os mesmos métodos de chamada.


Validação

Valida o documento passado como argumento. Retorna um bool, True caso seja válido, False caso contrário . Recebe os parâmetros:

Parâmetro Tipo Valor Padrão Requerido Descrição
doc str '' X O documento a ser validado.
from wltr_doc_validate import CPF

cpf = CPF()

# Validar CPF
cpf.validate("012.345.678-90")  # True
cpf.validate("012.345.678-91")  # False

Caso Especial de CPF

Os CPFs de 000.000.000-00 até 999.999.999-99 são considerados válidos pois, em alguns casos, existem pessoas vinculadas a eles. Foi utilizada a base de dados Coleção de CNPJs e CPFs brasileiros do Brasil.IO para verificar esses documentos:

CPF Pessoa Consulta
000.000.000-00 - https://brasil.io/dataset/documentos-brasil/documents?search=00000000000&document_type=CPF&document=&name=&sources=
111.111.111-11 AKA CENTRAL PARK - NEW YORK https://brasil.io/dataset/documentos-brasil/documents?search=11111111111&document_type=CPF&document=&name=&sources=
222.222.222-22 - https://brasil.io/dataset/documentos-brasil/documents?search=22222222222&document_type=CPF&document=&name=&sources=
333.333.333-33 - https://brasil.io/dataset/documentos-brasil/documents?search=33333333333&document_type=CPF&document=&name=&sources=
444.444.444-44 - https://brasil.io/dataset/documentos-brasil/documents?search=44444444444&document_type=CPF&document=&name=&sources=
555.555.555-55 ISAEL HERMINIO DA SILVA https://brasil.io/dataset/documentos-brasil/documents?search=55555555555&document_type=CPF&document=&name=&sources=
666.666.666-66 - https://brasil.io/dataset/documentos-brasil/documents?search=66666666666&document_type=CPF&document=&name=&sources=
777.777.777-77 ANTONIO GONÇALO DA SILVA https://brasil.io/dataset/documentos-brasil/documents?search=77777777777&document_type=CPF&document=&name=&sources=
888.888.888-88 - https://brasil.io/dataset/documentos-brasil/documents?search=88888888888&document_type=CPF&document=&name=&sources=
999.999.999-99 JOAQUIM ROCHA MATOS https://brasil.io/dataset/documentos-brasil/documents?search=99999999999&document_type=CPF&document=&name=&sources=

Para não validar esses CPFs, utilize o parâmetro repeated_digits (por padrão é False) da classe CPF ou mudar a variável de mesmo nome no objeto criado.

from wltr_doc_validate import CPF

cpf = CPF(repeated_digits=True)

# Validar CPF
cpf.validate("111.111.111-11")  # True

# Não aceitando entradas de 000.000.000-00 até 999.999.999-99
cpf.repeated_digits = False

# Validar CPF
cpf.validate("111.111.111-11")  # False

Validar uma Lista

Valida uma lista de documentos passado como argumento. Retorna uma lista de bool, True caso seja válido, False caso contrário. Recebe os parâmetros:

Parâmetro Tipo Valor Padrão Requerido Descrição
docs List[str] [] X A lista de documentos para validar.
from wltr_doc_validate import CPF

cpf = CPF()

# Validar CPFs
cpf.validate_list(["012.345.678-90", "012.345.678-91"])  # [True, False]

Gerar Documento

Gera um novo documento, retorna em formato de str. Recebe os parâmetros:

Parâmetro Tipo Valor Padrão Requerido Descrição
mask bool False - Quando possui o valor True, o documento retornado estará formatado.
from wltr_doc_validate import CPF

cpf = CPF()

# Gerar novo CPF
new_cpf_one = cpf.generate()  # "01234567890"
new_cpf_two = cpf.generate(True)  # "012.345.678-90"

Gerar Lista de Documentos

Gera uma lista de documentos list com elementos str. Aceita os parâmetros:

Parâmetro Tipo Valor Padrão Requerido Descrição
n int 1 X Quantidade de documentos que serão gerados.
mask bool False - Aplicar máscara aos documentos gerados.
repeat bool False - Aceitar repetiçõe de documentos.
from wltr_doc_validate import CPF

cpf = CPF()

# Gerar lista de CPFs
cpfs_one = cpf.generate_list(2)  # [ "85215667438", "28293145811" ]
cpfs_two = cpf.generate_list(2, True)  # [ "852.156.674-38", "282.931.458-11" ]

Máscara

Aplicar mascára ao documento passado como argumento. Retorna o domumento mascarado como str. Aceita os parâmetros:

Parâmetro Tipo Valor Padrão Requerido Descrição
doc str '' X Documento que receberá a máscara.
from wltr_doc_validate import CPF

cpf = CPF()

cpf_me = "01234567890"

# Mascara o CPF
cpf.mask(cpf_me)  # "012.345.678-90"

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

wltr-doc-validate-1.0.0.tar.gz (7.1 kB view details)

Uploaded Source

Built Distribution

wltr_doc_validate-1.0.0-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file wltr-doc-validate-1.0.0.tar.gz.

File metadata

  • Download URL: wltr-doc-validate-1.0.0.tar.gz
  • Upload date:
  • Size: 7.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.0.0.post20200309 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.6

File hashes

Hashes for wltr-doc-validate-1.0.0.tar.gz
Algorithm Hash digest
SHA256 5ecdb15401e1681cb02738bfa3dd47b3118e1c7fede4a0b0a03d6f0c9efb70cb
MD5 acea051c50d419c1e642e114526fe828
BLAKE2b-256 76fb66814542488ff672fb8cd87c6a879d61425f1e0fd319beb7360a8ae0f0c9

See more details on using hashes here.

File details

Details for the file wltr_doc_validate-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: wltr_doc_validate-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.0.0.post20200309 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.6

File hashes

Hashes for wltr_doc_validate-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a9d44e65edc294265e14b26c08c4c3ec521c3c9747d0c80ca82a4338c335e169
MD5 5bf33111a3da22e2f813822b09f819c6
BLAKE2b-256 7c9560883cba0045f9e16450162babe6af8527129ef02f29afb68c32224b83fe

See more details on using hashes here.

Supported by

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