cnpj-validador 0.1.0__tar.gz

cnpj_validador-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# Arquivos de compilação e distribuição do Python
+dist/
+build/
+*.egg-info/
+.eggs/
+
+# Caches do Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Ambientes virtuais
+venv/
+.venv/
+env/
+
+# Arquivos de sistema ou IDE
+.DS_Store
+.vscode/
+.idea/
+
+
+pypi-AgEIcHlwaS5vcmcCJDY5ODI2M2JiLTJmOTktNDY0Yy05ZGI3LWQwMjkxMzNiMzIyMQACKlszLCJlOTVlNzU2Mi03YjdiLTRlZjQtYjBmNS1lOWNhOWVkZjU2MjkiXQAABiCBZopn1ZqhW01l9CIZBDIkyshMzD9KFJlO638eP0lGPw

cnpj_validador-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Celso Custodio Júnior
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cnpj_validador-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.5
+Name: cnpj_validador
+Version: 0.1.0
+Summary: Validador unificado de CNPJ compatível com os formatos antigo (numérico) e novo (alfanumérico) da Receita Federal.
+Author-email: Celso Custodio Junior <celsocustodiojunior1985@gmail.com>
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# cnpj_validador
+
+O **cnpj_validador** é uma biblioteca Python leve, rápida e sem dependências externas desenvolvida para validar CNPJs nos dois formatos aceitos pela Receita Federal: o modelo tradicional (**antigo/numérico**) e o novo modelo (**alfanumérico**).
+
+## 🚀 Recursos
+
+- **Validação Unificada:** Suporta os formatos antigo (apenas números) e novo (alfanumérico).
+- **Flexível:** Aceita strings com ou sem formatação (pontuação, barras e traços).
+- **Zero Dependências:** Código puro, rápido e seguro.
+
+## 📦 Instalação
+
+Após a publicação no PyPI, você poderá instalar a biblioteca via `pip`:
+
+```bash
+pip install cnpj_validador
+```
+
+## 🛠️ Como Usar
+
+Basta importar a função `validar_cnpj` e passar o documento como string. A função retorna `True` para documentos válidos e `False` para inválidos.
+
+```python
+from cnpj_validador import validar_cnpj
+
+# Testando formato alfanumérico (Novo)
+print(validar_cnpj("12.ABC.345/0001-XX"))  # Retorna True ou False
+
+# Testando formato tradicional apenas números (Antigo)
+print(validar_cnpj("12.345.678/0001-00"))  # Retorna True ou False
+
+# Também aceita strings sem pontuação
+print(validar_cnpj("12ABC3450001XX"))       # Retorna True ou False
+```
+
+## ⚙️ Regra de Validação
+
+A biblioteca segue estritamente a regulamentação oficial da Receita Federal do Brasil, onde os caracteres alfanuméricos das posições correspondentes são convertidos para valores de 10 a 35 (A=10, B=11, ..., Z=35) antes do cálculo dos dígitos verificadores por meio do módulo 11.
+
+## 📄 Licença
+
+Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.

cnpj_validador-0.1.0/README.md

@@ -0,0 +1,42 @@
+# cnpj_validador
+
+O **cnpj_validador** é uma biblioteca Python leve, rápida e sem dependências externas desenvolvida para validar CNPJs nos dois formatos aceitos pela Receita Federal: o modelo tradicional (**antigo/numérico**) e o novo modelo (**alfanumérico**).
+
+## 🚀 Recursos
+
+- **Validação Unificada:** Suporta os formatos antigo (apenas números) e novo (alfanumérico).
+- **Flexível:** Aceita strings com ou sem formatação (pontuação, barras e traços).
+- **Zero Dependências:** Código puro, rápido e seguro.
+
+## 📦 Instalação
+
+Após a publicação no PyPI, você poderá instalar a biblioteca via `pip`:
+
+```bash
+pip install cnpj_validador
+```
+
+## 🛠️ Como Usar
+
+Basta importar a função `validar_cnpj` e passar o documento como string. A função retorna `True` para documentos válidos e `False` para inválidos.
+
+```python
+from cnpj_validador import validar_cnpj
+
+# Testando formato alfanumérico (Novo)
+print(validar_cnpj("12.ABC.345/0001-XX"))  # Retorna True ou False
+
+# Testando formato tradicional apenas números (Antigo)
+print(validar_cnpj("12.345.678/0001-00"))  # Retorna True ou False
+
+# Também aceita strings sem pontuação
+print(validar_cnpj("12ABC3450001XX"))       # Retorna True ou False
+```
+
+## ⚙️ Regra de Validação
+
+A biblioteca segue estritamente a regulamentação oficial da Receita Federal do Brasil, onde os caracteres alfanuméricos das posições correspondentes são convertidos para valores de 10 a 35 (A=10, B=11, ..., Z=35) antes do cálculo dos dígitos verificadores por meio do módulo 11.
+
+## 📄 Licença
+
+Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.

cnpj_validador-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cnpj_validador"
+version = "0.1.0"
+authors = [
+  { name="Celso Custodio Junior", email="celsocustodiojunior1985@gmail.com" },
+]
+description = "Validador unificado de CNPJ compatível com os formatos antigo (numérico) e novo (alfanumérico) da Receita Federal."
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cnpj_validador"]

cnpj_validador-0.1.0/src/cnpj_validador/__init__.py

@@ -0,0 +1 @@
+from .core import validar_cnpj

cnpj_validador-0.1.0/src/cnpj_validador/core.py

@@ -0,0 +1,41 @@
+import re
+
+
+def _converter_caractere(c: str) -> int:
+    """
+    Regra Oficial Definitiva da Receita Federal (Nota Técnica 2025/001):
+    O valor decimal corresponde ao código ASCII do caractere menos 48.
+    - Dígitos '0' (ASCII 48) a '9' (ASCII 57) mantêm os valores de 0 a 9.
+    - Letras 'A' (ASCII 65) a 'Z' (ASCII 90) passam a valer de 17 a 42.
+    """
+    return ord(c.upper()) - 48
+
+
+def _calcular_digito(cnpj_base: list, pesos: list) -> int:
+    soma = sum(v * p for v, p in zip(cnpj_base, pesos))
+    resto = soma % 11
+    return 0 if resto < 2 else 11 - resto
+
+
+def validar_cnpj(cnpj_str: str) -> bool:
+    if not isinstance(cnpj_str, str):
+        return False
+
+    cnpj_limpo = re.sub(r'[^A-Za-z0-9]', '', cnpj_str).upper()
+
+    if len(cnpj_limpo) != 14:
+        return False
+
+    valores = [_converter_caractere(c) for c in cnpj_limpo]
+
+    # Pesos padrão do Módulo 11 para CNPJ
+    pesos_1 = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]
+    pesos_2 = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]
+
+    base = valores[:12]
+    digitos_informados = valores[12:]
+
+    digito_1 = _calcular_digito(base, pesos_1)
+    digito_2 = _calcular_digito(base + [digito_1], pesos_2)
+
+    return digitos_informados == [digito_1, digito_2]

cnpj_validador-0.1.0/teste.py

@@ -0,0 +1,33 @@
+import re
+from cnpj_validador import validar_cnpj
+
+print("--- Iniciando Testes do cnpj_validador ---")
+
+# Captura o CNPJ direto digitado pelo usuário no terminal
+cnpj = input("Digite um cnpj para ser validado: ")
+
+# ==========================================
+# ETAPA 1: PROCESSAMENTO E VERIFICAÇÃO
+# ==========================================
+is_null = cnpj is None or str(cnpj).strip() == ""
+
+if not is_null:
+  cnpj_limpo = re.sub(r"[^A-Za-z0-9]", "", str(cnpj))
+  eh_alfanumerico = any(c.isalpha() for c in cnpj_limpo)
+  is_valido = validar_cnpj(cnpj)
+else:
+  eh_alfanumerico = False
+  is_valido = False
+
+# ==========================================
+# ETAPA 2: RETORNO DE RESULTADOS (IF/ELIF/ELSE)
+# ==========================================
+if is_null:
+  print("❌ Erro: Insira um CNPJ válido! O campo está vazio.")
+elif is_valido:
+  if eh_alfanumerico:
+    print(f"✅ Sucesso: O CNPJ Alfanumérico '{cnpj}' é VÁLIDO!")
+  else:
+    print(f"✅ Sucesso: O CNPJ Tradicional '{cnpj}' é VÁLIDO!")
+else:
+  print(f"❌ Erro: O CNPJ '{cnpj}' é INVÁLIDO!")