Brazilian Utils é uma biblioteca com foco na resolução de problemas que enfrentamos diariamente no desenvolvimento de aplicações para o business Brasileiro.

• Instalação
• Utilização
• Utilitários
• Novos Utilitários e Reportar Bugs
• Dúvidas? Ideias?
• Contribuindo com o Código do Projeto

pip install brutils 

Para usar um de nossos utilitários, basta importar a função necessária, como no exemplo abaixo:

>>> from brutils import is_valid_cpf >>> is_valid_cpf('00011122233') False

• CPF
  • is_valid_cpf
  • format_cpf
  • remove_symbols_cpf
  • generate_cpf
• CNPJ
  • is_valid_cnpj
  • format_cnpj
  • remove_symbols_cnpj
  • generate_cnpj
• CEP
  • is_valid_cep
  • format_cep
  • remove_symbols_cep
  • generate_cep
• Phone
  • is_valid_phone
  • is_valid_mobile_phone
  • is_valid_landline_phone
  • remove_symbols_phone
• Email
  • is_valid_email
• License Plate
  • is_valid_license_plate_old_format
  • is_valid_license_plate_mercosul
  • convert_license_plate_to_mercosul
• PIS
  • is_valid_pis
  • generate_pis
• Processo Jurídico
  • remove_symbols_processo_juridico

Verifica se o CPF é valido. Apenas números, formatados como string. Não verifica se o CPF existe.

>>> from brutils import is_valid_cpf >>> is_valid_cpf('00011122233') False

Formata o CPF. Retorna None se o CPF for inválido.

>>> from brutils import format_cpf >>> format_cpf('11144477735') '111.444.777-35'

Remove os símbolos de formatação do CPF e retorna somente números. Filtra apenas os símbolos utilizados para a validação do CPF. Propositalmente não remove outros símbolos.

>>> from brutils import remove_symbols_cpf >>> remove_symbols_cpf('000.111.222-33') '00011122233'

Gera um CPF válido aleatório.

>>> from brutils import generate_cpf >>> generate_cpf() '17433964657'

Verifica se o CNPJ é valido. Apenas números, formatados como string. Não verifica se o CNPJ existe.

>>> from brutils import is_valid_cnpj >>> is_valid_cnpj('00111222000133') False

Formata o CNPJ.

>>> from brutils import format_cnpj >>> format_cnpj('00111222000100') '00.111.222/0001-00'

Remove os símbolos de formatação do CPF e retorna somente números. Filtra apenas os símbolos utilizados para a validação do CPF. Propositalmente não remove outros símbolos.

>>> from brutils import remove_symbols_cnpj >>> remove_symbols_cnpj('00.111.222/0001-00') '00111222000100'

Gera um CNPJ válido aleatório.

>>> from brutils import generate_cnpj >>> generate_cnpj() '34665388000161'

Verifica se o CEP é valido. Apenas números, formatados como string. Não verifica se o CEP existe.

>>> from brutils import is_valid_cep >>> is_valid_cep('01310200') True

Formata o CEP. Retorna None se o CEP for inválido.

>>> from brutils import format_cep >>> format_cep('01310200') '01310-200'

Remove os símbolos de formatação do CEP e retorna somente números. Filtra apenas os símbolos utilizados para a validação do CEP. Propositalmente não remove outros símbolos.

>>> from brutils import remove_symbols_cep >>> remove_symbols_cep('01310-200') '01310200'

Gera um CEP válido aleatório.

>>> from brutils import generate_cep >>> generate_cep() '77520503'

Verifica se o número de telefone é valido, podendo ser telefone fixo ou celular. Apenas números, com DDD e sem o prefixo internacional, formatados como string. Exemplo: +55 48 9999 9999 deve ser chamado como is_valid_phone('4899999999'). Esta função valida apenas números de telefone brasileiros e não verifica se o número realmente existe.

>>> from brutils import is_valid_phone >>> is_valid_phone('11994029275') True

Verifica se o número de celular é valido. Apenas números, com DDD e sem o prefixo internacional, formatados como string.Exemplo: +55 48 9999 9999 ficaria '4899999999'. Esta função valida apenas números de celular brasileiros e não verifica se o número realmente existe.

>>> from brutils import is_valid_mobile_phone >>> is_valid_mobile_phone('11994029275') True

Verifica se o número de telefone fixo é valido. Apenas números, com DDD e sem o prefixo internacional, formatados como string. Exemplo: +55 48 3333 3333 ficaria '4833333333'. Esta função valida apenas números de telefones fixos brasileiros e não verifica se o número realmente existe.

>>> from brutils import is_valid_landline_phone >>> is_valid_landline_phone('1938814933') True

Remove símbolos do número de telefone. Exemplo: (21)2569-6969 ficaria '2125696969'.

>>> from brutils import remove_symbols_phone >>> remove_symbols_phone('(21)2569-6969') '2125696969'

Verificar se uma string corresponde a um e-mail válido. As regras para validar um endereço de e-mail geralmente seguem as especificações definidas pelo RFC 5322 (atualizado pelo RFC 5322bis), que é o padrão amplamente aceito para formatos de endereços de e-mail.

from brutils import is_valid_email >>> is_valid_email("joao.ninguem@gmail.com") True >>> is_valid_email(".joao.ninguem@gmail.com") False >>> is_valid_email("joao.ninguem@gmail.") False >>> is_valid_email("joao ninguem@gmail.com") False

Verifica se é uma Placa de Veículo no antigo padrão utilizado no Brasil. Recebe como parâmetro uma string devendo conter somente caracteres alfanuméricos(letras e números) e retorna um valor booleano. Exemplo: 'abc1234' resulta em True. Esta função valida somente placas no antigo padrão e não verifica se a mesma realmente existe.

>>> from brutils import is_valid_license_plate_old_format >>> is_valid_license_plate_old_format('ABC1234') True >>> is_valid_license_plate_old_format('def5678') True >>> is_valid_license_plate_old_format('GHI-4567') False

Verifica se uma string correspondente a um número da placa é válido, conforme as novas normas do Mercosul, isto é, seguindo o padrão LLLNLNN. Exemplo: ABC4E67.

>>> from brutils import is_valid_license_plate_mercosul >>> is_valid_license_plate_mercosul('ABC4E67') True

Converte uma string correspondente a um número da placa é válido no formato antigo, para o novo formato, conforme as novas normas do Mercosul (seguindo o padrão LLLNLNN). Caso a placa informada seja inválida será retornado o valor None. Exemplo: ABC4567 -> ABC4F67.

>>> from brutils import convert_license_plate_to_mercosul >>> convert_license_plate_to_mercosul("ABC123") "ABC1C34" >>> convert_license_plate_to_mercosul("abc123") "ABC1C34" >>> convert_license_plate_to_mercosul("ABC1D23") None

Verifica se o número PIS/PASEP é valido. Apenas números, formatados como string. Não verifica se o PIS/PASEP existe. Mais detalhes sobre a validação estão disponíveis em https://www.macoratti.net/alg_pis.htm.

Gera um PIS/PASEP válido aleatório.

from brutils import generate_pis >>> generate_pis() '12038619494' >>> generate_pis() '57817700092' >>> generate_pis() '49850211630'

Remove os símbolos "." e "-" de formatação de um número de processo jurídico e retorna apenas o número. Propositalmente não remove outros símbolos.

from brutils import remove_symbols_processo_juridico >>> remove_symbols_processo_juridico("6439067-89.2023.4.04.5902") "64390678920234045902" >>> remove_symbols_processo_juridico("4976023-82.2012.7.00.2263") "49760238220127002263" >>> remove_symbols_processo_juridico("4976023-82.2012.7.00.2263*!*&#") "49760238220127002263*!*&#"

Caso queira sugerir novas funcionalidades ou reportar bugs, basta criar uma nova issue e iremos lhe responder por lá!

(Para saber mais sobre github issues, confira a documentação oficial do GitHub).

Dúvidas de como utilizar a biblioteca? Novas ideias para o projeto? Quer compartilhar algo com a gente? Fique à vontade para criar um tópico no nosso Discussions que iremos interagir por lá!

(Para saber mais sobre github discussions, confira a documentação oficial do GitHub).

Sua colaboração é sempre muito bem-vinda! Preparamos o arquivo CONTRIBUTING.md para te ajudar nos primeiros passos. Lá você encontrará toda a informação necessária para contribuir com o projeto. Não hesite em nos perguntar utilizando o GitHub Discussions caso haja qualquer dificuldade ou dúvida. Toda ajuda conta!

Vamos construir juntos! 🚀🚀