Skip to content

Latest commit

 

History

History

python

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

novo-cnpj (Python)

Validador e gerador do novo CNPJ Alfanumérico brasileiro (Instrução Normativa RFB nº 2.229/2024), com suporte a CNPJs numéricos tradicionais.

Parte do monorepo novo-cnpj — implementações em TypeScript, Go, PHP, Python e JVM com o mesmo algoritmo e casos de teste.

Instalação

pip install novo-cnpj

Requer Python 3.9+. Sem dependências externas.

Uso

from novo_cnpj import CnpjValidator

# Validação — aceita com ou sem máscara, maiúsculas e minúsculas
CnpjValidator.is_valid("12.ABC.345/01AB-77")  # True
CnpjValidator.is_valid("12.abc.345/01ab-77")  # True  — normaliza automaticamente
CnpjValidator.is_valid("11.222.333/0001-81")  # True  — CNPJ numérico tradicional
CnpjValidator.is_valid("00000000000000")       # False — sequência uniforme
CnpjValidator.is_valid(None)                   # False — não é string

# Normalização — retorna 14 chars sem máscara ou lança ValueError
CnpjValidator.create("12.abc.345/01ab-77")    # "12ABC34501AB77"
CnpjValidator.create("12ABC34501AB35")         # raises ValueError: Invalid Alphanumeric CNPJ!

# Geração de CNPJs válidos aleatórios
CnpjValidator.generate()     # ["A1B2C3D4E5F677"]        — 1 CNPJ
CnpjValidator.generate(5)    # ["...", "...", ...]        — 5 CNPJs

Desenvolvimento

# Instalar em modo editável com dependências de dev
pip install -e ".[dev]"

# Rodar os testes
pytest -v tests/

Ou via Docker (sem nenhuma dependência local):

# Na raiz do monorepo
make test-python

Licença

MIT