brado

Brado é um pacote Rust para validação de documentos brasileiros. Este projeto é inspirado na biblioteca Python validate-docbr.

Brado fornece funções para identificação, validação e geração de documentos brasileiros. O nome desta biblioteca (Brado) é um acronimo de BRAzilian DOcs validator (validador de DOcumentos BRAsileiros).

:warning: A documentação desta biblioteca pode ser acessada aqui.

Guia Rápido

Para adicionar o pacote ao projeto, basta rodar o seguinte comando:

cargo add brado

Ou adicionar a linha a seguir no arquivo Cargo.toml:

brado = "0.3.5"

Documentos

CPF: Cadastro de Pessoa Física;
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;
Certidão de Nascimento/Casamento/Óbito.

Funções

Todos os documentos possuem as mesmas funções e funcionam da mesma forma.

validate

Valida o documento passado como parâmetro (&str). Retorna um valor booleano (bool), true caso o documento seja válido, ou false caso contrário.

use brado::cpf;

cpf::validate("63929247011"); // true
cpf::validate("639.292.470-11"); // true

cpf::validate("63929247010"); // false
cpf::validate("639.292.470-10"); // false

mask

Mascara o documento passado como parâmetro (&str). Retorna uma string (Result<String, &'static str>) correspondente ao documento mascarado ou um erro. A string passada não deve possuir símbolos.

use brado::cpf;

cpf::mask("63929247011"); // Ok("639.292.470-11")

cpf::mask("639.292.470-11"); // Err("The given string cannot be masked as CPF!")
cpf::mask("639292470"); // Err("The given string cannot be masked as CPF!")

is_bare

Verifica se o documento passado como parâmetro (&str) não possui símbolos. Retorna um valor booleano (bool), true caso o documento não possua símbolos, ou false caso contrário.

use brado::cpf;

cpf::is_bare("63929247011"); // true
cpf::is_bare("63929247010"); // true

cpf::is_bare("639.292.470-11"); // false
cpf::is_bare("639.29247011"); // false
cpf::is_bare("639292470110"); // false

OBS: se for utilizada a função cpf::is_bare para verificar se um CNPJ não possui símbolos, o resultado será false! Isso acontece pois esta função considera que a string é um CPF, ou seja, possui 11 dígitos.

is_masked

Verifica se o documento passado como parâmetro (&str) está mascarado de acordo com o documento correspondente. Retorna um valor booleano (bool), true caso o documento esteja mascarado, ou false caso contrário.

use brado::cpf;

cpf::is_masked("639.292.470-10"); // true

cpf::is_masked("63929247011"); // false
cpf::is_masked("6392.92.470-11"); // false
cpf::is_masked("639.292.470-110"); // false

OBS: cpf::is_masked verifica se a string passada está mascarada como um CPF. cnpj::is_masked verifica se a string passada está mascarada como um CNPJ.

generate

Gera um novo documento sem símbolos (String).

use brado::cpf;

cpf::generate(); // "639.292.470-11"

generate_masked

Gera um novo documento mascarado (String).

use brado::cpf;

cpf::generate_masked(); // "639.292.470-11"

Como Contribuir

Instalar nix (com flakes, ou seja, >2.4);
Fazer um fork do projeto;
Clonando o repositório, e considerando que se está usando direnv:

nix flake clone github:your-github-user/brado --dest ./brado \
&& cd brado 1>/dev/null 2>/dev/null \
&& direnv allow

Testes

Para rodar os testes, basta executar o comando a seguir:

make test

brado 0.3.1