Package: validate-docbr
validate-docbrPacote Python para validação de documentos brasileiros.Para instalar o pacote:pipinstallvalidate-docbrA documentação pode ser acessadaclicando aqui.DocumentosDocumentos que estão no pacote:CPF: Cadastro de Pessoas Físicas;CNH: Carteira Nacional de Habilitação;CNPJ: Cadastro Nacional da Pessoa Jurídica;CNS: Cartão Nacional de Saúde;PIS: PIS/NIS/PASEP/NIT;Título eleitoral: Cadastro que permite cidadãos brasileiros votar;RENAVAM: Registro Nacional de Veículos Automotores.Para entender melhor os documentos e suas respectivas classes, basta acessar aWiki do projeto.MétodosTodos os documentos possuem os mesmos métodos e funcionam da mesma forma.validateValida o documento passado como argumento. Retorna umbool,Truecaso seja válido,Falsecaso contrário . Recebe os parâmetros:ParâmetroTipoValor padrãoObrigatórioDescriçãodocstr''XO documento que se quer validar.fromvalidate_docbrimportCPFcpf=CPF()# Validar CPFcpf.validate("012.345.678-90")# Truecpf.validate("012.345.678-91")# FalseCaso especial de CPF.validate_listValida uma lista de documentos passado como argumento. Retorna uma lista debool,Truecaso seja válido,Falsecaso contrário. Recebe os parâmetros:ParâmetroTipoValor padrãoObrigatórioDescriçãodocsList[str][]XA lista de documentos para validar.fromvalidate_docbrimportCPFcpf=CPF()# Validar CPFscpf.validate_list(["012.345.678-90","012.345.678-91"])# [True, False]validate_docsObservação: diferente dos outros métodos, esse método é do escopo global do pacote, não precisa-se instanciar uma classe para uso.Valida vários documentos difererentes. Retorna uma lista com valoresboolpara cada tupla da lista (na mesma ordem),Truecaso seja válido,Falsecaso contrário . Recebe os parâmetros:ParâmetroTipoValor padrãoObrigatórioDescriçãodocumentsList[Tuple[BaseDoc, str]][]XLista de tuplas, cada tupla possui como primeiro elemento o tipo de documento e o segundo elemento o valor que se deseja validar.importvalidate_docbrasdocbr# Validar diferentes documentosdocs=[(docbr.CPF,'90396100457'),(docbr.CNPJ,'49910753848365')]docbr.validate_docs(docs)# [True, False]generateGera um novo documento, retorna em formato destr. Recebe os parâmetros:ParâmetroTipoValor padrãoObrigatórioDescriçãomaskboolFalse-Quando possui o valorTrue, o documento retornado estará formatado.fromvalidate_docbrimportCPFcpf=CPF()# Gerar novo CPFnew_cpf_one=cpf.generate()# "01234567890"new_cpf_two=cpf.generate(True)# "012.345.678-90"generate_listGera uma lista de documentos, retorna em formato delistcom elementos do tipostr. Recebe os parâmetros:ParâmetroTipoValor padrãoObrigatórioDescriçãonint1XA quantidade desejada de documentos que serão gerados.maskboolFalse-Se os documentos gerados deverão ter ou não máscara.repeatboolFalse-Se aceita ou não documentos repetidos.fromvalidate_docbrimportCPFcpf=CPF()# Gerar lista de CPFscpfs_one=cpf.generate_list(2)# [ "85215667438", "28293145811" ]cpfs_two=cpf.generate_list(2,True)# [ "852.156.674-38", "282.931.458-11" ]maskMascara o documento passado como argumento. Retorna umstrque é o documento mascarado . Recebe os parâmetros:ParâmetroTipoValor padrãoObrigatórioDescriçãodocstr''XO documento que se quer mascarar.fromvalidate_docbrimportCPFcpf=CPF()cpf_me="01234567890"# Mascara o CPFcpf.mask(cpf_me)# "012.345.678-90"