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
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
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! 🚀🚀