100% open-source (MIT) workspace em Rust — biblioteca de alta performance para formatação e validação de identificadores e documentos brasileiros, CLI para terminal e datasets públicos oficiais embutidos offline. Port oficial do projeto open-data-brazil/br-validators. Os algoritmos rastreiam diretamente as fontes primárias oficiais (Receita Federal, Bacen, CONTRAN, Correios, SEFAZ).
| Surface | Pacote / URL |
|---|---|
| Library | br-validators via dependência git (Cargo.toml) ou GitHub Releases |
| CLI | br-validators-cli via binários pré-compilados no GitHub Releases ou cargo install --git |
| Dados | Embedded offline (JSON) ou assets no GitHub Releases e URLs raw |
| Playground | open-data-brazil.github.io/br-validators — interface web interativa do ecossistema, 100% client-side sem envio de PII |
Datasets de referência (IBGE, bancos Bacen STR, consulta DDD, feriados nacionais, CNAE, CFOP, CST, LC 116, eSocial categorias/rubricas, NCM, CBO, natureza jurÃdica, NBS, CEST, moedas, cotações PTAX, paÃses Bacen, cUF NF-e, tabelas IRPF/INSS, SELIC meta, ISS municipal top 500 PIB, Incoterms, aeroportos ANAC, portos ANTAQ, preços de combustÃveis ANP LPC) são embutidos offline e atualizados diariamente (00:00 BrasÃlia) — veja docs/DATA-FRESHNESS.md. Alertas crÃticos de fontes: data/refresh-reports/CRITICAL-ALERTS.md.
Adicione via dependência git apontando para a tag ou release desejada:
[dependencies]
br-validators = { git = "https://github.com/open-data-brazil/br-validators-rust.git", tag = "v0.1.1" }Para habilitar grupos de datasets ou serialização Serde:
[dependencies]
br-validators = { git = "https://github.com/open-data-brazil/br-validators-rust.git", tag = "v0.1.1", features = ["fiscal", "trade", "serde"] }Instale com o Cargo:
cargo install --git https://github.com/open-data-brazil/br-validators-rust.git br-validators-cliOu baixe binários pré-compilados para Linux (x86_64, aarch64), macOS (x86_64, aarch64) e Windows (x86_64) diretamente dos Releases no GitHub.
use br_validators::{validate_cnpj, format_cnpj, validate_cpf};
// Suporta CNPJ numérico e alfanumérico (RFB IN 2.229/2024)
let cnpj = validate_cnpj("12ABC34501DE35");
if cnpj.is_ok() {
println!("CNPJ canônico: {}", cnpj.value);
}
let formatado = format_cnpj("12ABC34501DE35");
assert_eq!(formatado.formatted, Some("12.ABC.345/01DE-35".to_string()));
// Nunca entra em pânico — retorne Result ou inspecione o objeto de validação
let cpf = validate_cpf("12345678909");
assert!(cpf.is_ok());Por padrão, a crate br-validators tem zero dependências em tempo de execução para todos os validadores de documentos e geradores.
Datasets públicos oficiais são ativados granularmente por feature flags:
[features]
# Grupos de domÃnio
fiscal = ["cnaes", "cfop", "cst", "csosn", "ncm", "cest", "nbs", "lc116", "natureza-juridica", "cnpj-motivos", "ibpt", "iss-municipal", "nfe-cuf"]
trade = ["moedas", "ptax", "paises-bacen", "incoterms"]
finance = ["selic", "bancos"]
payroll = ["irpf", "inss", "esocial", "cbo", "simples-nacional"]
logistics = ["aeroportos", "portos", "anp-combustiveis"]
geo = ["ibge", "tse-municipios", "cep-faixas", "telefone-ddd", "feriados"]
gov = ["pncp-reference", "transparencia-snapshots"]
all-data = ["fiscal", "trade", "finance", "payroll", "logistics", "geo", "gov"]
full = ["all-data", "serde", "generate", "remote"]Tabela completa de tamanhos por feature: data/bundle-sizes/feature-sizes.md.
use axum::{extract::Json, http::StatusCode, response::IntoResponse};
use br_validators::validate_cpf;
use serde::{Deserialize, Serialize};
#[derive(Deserialize)]
pub struct CadastroPayload {
pub cpf: String,
}
#[derive(Serialize)]
pub struct RespostaErro {
pub erro: String,
}
pub async fn cadastrar(Json(payload): Json<CadastroPayload>) -> Result<impl IntoResponse, (StatusCode, Json<RespostaErro>)> {
let cpf = validate_cpf(&payload.cpf);
if !cpf.is_ok() {
return Err((
StatusCode::BAD_REQUEST,
Json(RespostaErro { erro: cpf.error.unwrap_or_else(|| "CPF inválido".into()) }),
));
}
Ok(StatusCode::CREATED)
}br-validators cnpj validate "$CNPJ" --quiet || exit 1
br-validators ie validate "$IE" --uf SP --json
br-validators ptax lookup USD --verbose| Tipo | Módulo Rust | Comando CLI | Playground |
|---|---|---|---|
| CNPJ (numérico + alfanumérico) | br_validators::validate_cnpj |
br-validators cnpj … |
/cnpj |
| CPF | br_validators::validate_cpf |
br-validators cpf … |
/cpf |
| CEP | br_validators::validate_cep |
br-validators cep … |
/cep |
| Telefone (Anatel fixo + móvel) | br_validators::validate_telefone |
br-validators telefone … |
/telefone |
| CNH | br_validators::validate_cnh |
br-validators cnh … |
/cnh |
| RENAVAM | br_validators::validate_renavam |
br-validators renavam … |
/renavam |
| TÃtulo de eleitor | br_validators::validate_titulo_eleitor |
br-validators titulo … |
/titulo-eleitor |
| Processo judicial CNJ | br_validators::validate_processo_judicial |
br-validators processo-judicial … |
/processo-judicial |
| RG (por UF, 27 unidades federativas) | br_validators::validate_rg |
br-validators rg … --uf SP |
/rg |
| NF-e chave de acesso | br_validators::validate_nfe_chave |
br-validators nfe … |
/nfe-chave |
| Placa veicular (Mercosul + padrão cinza) | br_validators::validate_placa |
br-validators placa … |
/placa |
| PIS / PASEP / NIS | br_validators::validate_pis_pasep |
br-validators pis-pasep … |
/pis |
| Chave PIX | br_validators::validate_pix_key |
br-validators pix … |
/pix |
| BR Code (QR Code PIX) | br_validators::validate_br_code |
br-validators brcode … |
/brcode |
| Boleto cobrança (bancário) | br_validators::validate_boleto |
br-validators boleto … |
/boleto |
| Boleto arrecadação (concessionárias) | br_validators::validate_boleto |
br-validators boleto … |
/boleto |
| Cartão de crédito (Luhn / ISO 7812) | br_validators::validate_cartao_credito |
br-validators cartao … |
/cartao-credito |
| Inscrição Estadual (todas as 27 UFs) | br_validators::validate_inscricao_estadual |
br-validators ie … --uf SP |
/ie |
| Inscrição Estadual SP produtor rural | br_validators::validate_ie_sp_produtor_rural |
br-validators ie … (automático com P) |
/ie |
| API | Módulo Rust | CLI | Playground | Finalidade |
|---|---|---|---|---|
detect() |
br_validators::detect |
br-validators detect … |
/detect |
Auto-classificação do tipo de identificador |
sanitize() |
br_validators::sanitize |
br-validators sanitize <type> … |
/sanitize |
Normalização e correção de caracteres comuns |
mask() |
br_validators::mask |
br-validators mask <type> … |
via ações format |
Aplicação de máscara visual padrão |
compare() |
br_validators::compare |
br-validators compare <type> … |
/compare |
Igualdade semântica normalizada |
batch() |
br_validators::batch |
br-validators batch <type> … |
/batch |
Validação em lote com estatÃsticas |
diff() |
br_validators::diff |
br-validators diff <type> … |
/diff |
Análise de divergência estrutural campo a campo |
generate() |
br_validators::generate |
br-validators generate … |
/generate |
Geração de fixtures válidas para testes sintéticos |
use br_validators::{compare, diff, mask, DocumentType};
let eq = compare("123.456.789-09", "12345678909", DocumentType::Cpf);
assert!(eq.equal);
let m = mask("12345678909", DocumentType::Cpf);
assert_eq!(m.formatted.as_deref(), Some("123.456.789-09"));use br_validators::{build_static_pix_brcode, parse_br_code, validate_br_code, BuildStaticPixOptions};
let options = BuildStaticPixOptions {
key: "[email protected]".to_string(),
merchant_name: "Empresa Exemplo".to_string(),
merchant_city: "Brasilia".to_string(),
amount: Some(150.50),
txid: Some("FATURA123".to_string()),
};
let payload = build_static_pix_brcode(&options).expect("BR Code estático válido");
assert!(validate_br_code(&payload).is_ok());
let parsed = parse_br_code(&payload).expect("Parse EMV TLV");
assert_eq!(parsed.merchant_city, Some("Brasilia".to_string()));Tabelas e classificações governamentais embutidas diretamente na biblioteca — zero chamadas de rede em tempo de execução, compiladas com include_str! ou parseadas por demanda.
| Dataset | Feature | CLI | Playground | Funções-chave | Fonte oficial |
|---|---|---|---|---|---|
| IBGE estados e municÃpios | ibge |
ibge lookup · ibge list |
/data/ibge |
get_estados, get_municipios, get_municipio_por_codigo |
IBGE localidades |
| Bacen STR bancos | bancos |
bancos lookup · bancos list |
/data/bancos |
get_bancos, get_banco_por_codigo, get_banco_por_ispb |
Bacen STR CSV |
| ANAC aeródromos públicos | aeroportos |
aeroportos lookup |
/data/logistics |
get_aeroportos, get_aeroporto_por_iata, get_aeroporto_por_icao |
ANAC aeródromos CSV |
| ANTAQ instalações portuárias | portos |
portos lookup |
/data/logistics |
get_porto_por_codigo, search_portos, get_portos_por_municipio |
ANTAQ instalações portuárias |
| ANP preços de combustÃveis (LPC) | anp-combustiveis |
— | /data/logistics |
get_anp_precos_medios, get_anp_semana_atual |
ANP levantamento LPC |
| TSE ↔ IBGE municÃpios | tse-municipios |
tse-municipios lookup |
/data/ibge |
get_municipio_ibge_por_codigo_tse, get_codigos_tse_por_municipio |
TSE dados abertos |
| Anatel DDD geográfico | telefone-ddd |
ddd lookup |
— | get_ddd_info |
Anatel painel DDD |
| Feriados nacionais | feriados |
feriados list --year |
/data/calendar |
is_feriado_nacional, get_feriados_nacionais, get_proximo_dia_util |
Lei 662/1949 |
| CNAE 2.3 subclasses | cnaes |
cnae lookup · cnae search |
/data/fiscal |
get_cnae_por_codigo, search_cnaes |
IBGE CNAE API |
| CFOP operações fiscais | cfop |
cfop lookup · cfop search |
/data/fiscal |
get_cfop_por_codigo, search_cfop |
CONFAZ CFOP |
| CST (ICMS, IPI, PIS, COFINS) | cst |
— | /data/fiscal |
get_cst_icms_por_codigo, get_cst_ipi_por_codigo |
RFB SPED tabelas |
| LC 116 lista de serviços ISS | lc116 |
— | /data/fiscal |
get_lc116_por_codigo, search_lc116 |
LC 116/2003 Planalto |
| eSocial (categorias + rubricas) | esocial |
— | /data/payroll |
get_esocial_categoria_por_codigo, get_esocial_rubrica_por_codigo |
eSocial leiautes S-1.3 |
| NCM Siscomex | ncm |
ncm lookup · ncm search |
/data/fiscal |
get_ncm_por_codigo, search_ncm |
Siscomex NCM JSON |
| Natureza jurÃdica RFB | natureza-juridica |
natureza-juridica lookup |
/data/fiscal |
get_natureza_juridica_por_codigo |
RFB Dados Abertos CNPJ |
| NBS serviços nacionais | nbs |
nbs lookup |
/data/fiscal |
get_nbs_por_codigo, search_nbs |
NFSe Anexo B NBS2 |
| CEST substituição tributária | cest |
cest lookup |
/data/fiscal |
get_cest_por_codigo, get_cest_por_ncm |
CONFAZ Convênio 142/2018 |
| Moedas ISO 4217 + Bacen | moedas |
moedas lookup |
/data/trade |
get_moeda_por_codigo, search_moedas |
Bacen PTAX Moedas |
| Bacen PTAX Fechamento | ptax |
ptax lookup · ptax historico |
/data/trade |
get_ptax_cotacao, get_ptax_historico, get_ptax_ultimo_dia_util |
Bacen Olinda PTAX API |
| PaÃses Bacen (NF-e cPais) | paises-bacen |
paises-bacen lookup |
/data/trade |
get_pais_por_codigo_bacen, get_paises_bacen |
Tabela de PaÃses NF-e |
| NF-e cUF códigos UF | nfe-cuf |
nfe-cuf lookup |
/data/fiscal |
get_cuf_por_codigo |
Manual de Orientação NF-e |
| IRPF tabela progressiva | irpf |
irpf tabela · irpf calc |
/data/payroll |
get_irpf_tabela_progressiva, calcular_irpf_mensal |
RFB Tabelas IRPF |
| INSS faixas de contribuição | inss |
inss tabela · inss calc |
/data/payroll |
get_inss_tabela_contribuicao, calcular_inss_mensal |
INSS Tabelas |
| SELIC meta Bacen | selic |
selic |
/data/finance |
get_selic_meta, get_selic_meta_por_data |
Bacen SGS série 432 |
| ISS municipal (top 500 PIB) | iss-municipal |
iss-municipal lookup |
/data/fiscal |
get_iss_municipal_por_ibge |
IBGE SIDRA PIB 5938 |
| Incoterms 2020 ICC | incoterms |
incoterms lookup |
/data/trade |
get_incoterm_por_codigo, get_incoterms |
ICC Incoterms |
| CBO 2002 ocupações | cbo |
cbo lookup |
/data/fiscal |
get_cbo_por_codigo, search_cbo |
MTE CBO |
| CEP faixas por municÃpio | cep-faixas |
cep faixa |
— | get_cep_faixa_info |
IBGE CNEFE 2022 |
| Catálogo de transparência | _data |
— | /data/catalog |
get_data_catalog, get_dataset_metadata |
docs/DATA-FRESHNESS.md |
use br_validators::data::ncm::get_ncm_por_codigo;
use br_validators::data::bancos::get_banco_por_codigo;
use br_validators::data::ptax::get_ptax_ultimo_dia_util;
let ncm = get_ncm_por_codigo("01012100");
println!("NCM: {:?}", ncm.map(|n| &n.descricao));
let banco = get_banco_por_codigo("001");
assert_eq!(banco.map(|b| b.nome.as_str()), Some("Banco do Brasil S.A."));
let ptax = get_ptax_ultimo_dia_util("USD");
if let Some(cotacao) = ptax {
println!("PTAX USD: compra {} / venda {}", cotacao.cotacao_compra, cotacao.cotacao_venda);
}Todos os datasets públicos consolidados e auditados podem ser consumidos diretamente via HTTP sem dependência de crates:
-
Catálogo de metadados da última release:
curl -s https://github.com/open-data-brazil/br-validators-rust/releases/latest/download/catalog.json | jq .
-
Download de arquivo individual:
curl -s https://raw.githubusercontent.com/open-data-brazil/br-validators-rust/main/crates/br-validators/data/bancos/bancos.json | jq .
-
Verificação de integridade: Cada release inclui um arquivo
SHA256SUMScontendo os hashes criptográficos de todos os datasets publicados. -
Consulta dinâmica em runtime (Feature
remote):#[cfg(feature = "remote")] use br_validators::remote::RemoteClient; #[cfg(feature = "remote")] fn fetch_bancos() -> Result<(), Box<dyn std::error::Error>> { let client = RemoteClient::latest(); let bancos: Vec<br_validators::schema::bancos::Banco> = client.fetch("bancos", "bancos.json")?; println!("Total de bancos baixados: {}", bancos.len()); Ok(()) }
Seguimos SemVer:
- MAJOR (
x.0.0): Mudança com quebra de compatibilidade na API pública de validação. - MINOR (
0.x.0): Adição de novos validadores, novos datasets ou novas funções utilitárias. - PATCH (
0.0.x): Atualização rotineira diária dos datasets embutidos pelo bot automatizado ou correções de bugs.
Contribuições são bem-vindas! Consulte os guias:
- CONTRIBUTING.md — fluxo de trabalho, padrões de código e vetores de teste.
- docs/OFFICIAL-SOURCES.md — lista de fontes oficiais obrigatórias.
- docs/DATA-SOURCE-MAINTENANCE.md — manutenção de fontes e recuperação de falhas.
- SECURITY.md — polÃtica de divulgação responsável de vulnerabilidades.
- CODE_OF_CONDUCT.md — código de conduta da comunidade.
MIT — software livre e de código aberto permanente.