docs-validator 1.2.0

Documents validator (CNPJ numeric and alphanumeric)

docs-validator

A Python library and CLI to validate Brazilian documents (CPF, CNPJ), including experimental support for alphanumeric CNPJ.

Features

• Validate CPF
• Validate CNPJ (numeric)
• Experimental alphanumeric CNPJ
• Multiple validation modes:
  • strict (default)
  • loose
  • experimental
• CLI support
• JSON output

---

Installation

pip install docs-validator

For development:

git clone https://github.com/thinkbruno/docs-validator
cd docs-validator

python -m venv .venv
source .venv/bin/activate

pip install -e .

---

Usage

from docs_validator import validate

result = validate("11222333000181")
print(result)

Output

{
  "country": "BR",
  "type": "CNPJ",
  "valid": true
}

---

CLI Usage

Basic

docs-validator 11222333000181

Force type

docs-validator 12345678909 --type cpf
docs-validator 11222333000181 --type cnpj

Modes

docs-validator 12345678000100 --type cnpj --mode loose
docs-validator AB12CD34EF5601 --type cnpj --mode experimental

Disable DV

docs-validator 12345678000100 --type cnpj --no-dv

Detect only

docs-validator AB12CD34EF5601 --detect

JSON Output

docs-validator 11222333000181 --json

---

Validation Modes

Mode	Description
strict	Safe default, validates DV for numeric
loose	Only validates format
experimental	Enables alphanumeric DV validation

---

Portfolio

Author

Developed by Bruno Ramos

---

License

MIT License