No artigo de hoje irei falar um pouco sobre um projeto Open Source que pode ser muito útil para aqueles que fazem projetos envolvendo dados relacionados às instituições brasileiras, o Brazilian Utils (https://github.com/brazilian-utils/python). Esta biblioteca é um toolkit para o tratamento (manipulação e validação) de dados que seguem o padrão estabelecido pelas instituições brasileiras, como os CPFs, CNPJs, CEPs etc.

Neste artigo eu irei demonstrar algumas das funções que a biblioteca possui na sua versão para Python. No entanto, também existem versões desta biblioteca para JavaScript, .Net, Ruby, Rust e Golang.

Começando por uma pequena demonstração do CPF. É possível gerar, validar e formatar um CPF utilizando as funções contidas no objeto cpf.

Podemos fazer o mesmo também para o CNPJ.

No exemplo a seguir eu utilizei o endereço da casa onde eu passei a minha infância para retornar as informações sobre o logradouro, inclusive o CEP.

Note que inicialmente a validação do CEP retornou como False, mas é necessário que sejam removidos os caracteres especiais antes de realizar a validação.

Ainda sobre o CEP, é possível também resgatar um logradouro informando o CEP. Neste exemplo estou utilizando o CEP de uma famosa rua da cidade do Rio de Janeiro.

Outro objeto que pode ser muito útil é o license_plate que possui ferramentas para trabalhar com dados de placas de carro. Como vemos no código abaixo, é possível gerar uma placa de carro no formato atual (padrão Mercosul) ou no formato antigo utilizando o parâmetro format. Também é possível realizar a conversão de uma placa no formato antigo para o padrão Mercosul.

Nesta biblioteca existem ainda funções relacionadas ao IBGE que podem ser muito úteis, como uma função para obter o código do município a partir do seu nome e uma outra função para gerar o nome da UF a partir do seu código.

Por fim, existem muitas outras funções que podem ser usadas para facilitar o tratamento de dados brasileiros, como uma função para verificar feriados, uma função para formatar valores monetários em real e uma função para transformar datas em texto corrido.

Esta biblioteca pode ser uma ótima oportunidade para aqueles que querem começar a contribuir com projetos Open Source. Por isso, se você achou a biblioteca interessante e teve alguma ideia de melhoria, ou apenas deseja ajudar de alguma forma, não deixe de colaborar com o projeto.