alfac 0.1.0__tar.gz

alfac-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.1
+Name: alfac
+Version: 0.1.0
+Summary: Validador de CNPJ Alfanumérico conforme novas normas do Governo (2024).
+License: MIT
+Keywords: cnpj,alfanumerico,validador,governo,brasil
+Author: kleitomberg
+Author-email: kss@cin.ufpe.br
+Requires-Python: >=3.12,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+
+

alfac-0.1.0/alfac/validator.py

@@ -0,0 +1,61 @@
+import re
+from math import ceil
+
+class DigitoVerificador:
+    """Classe responsável pelo cálculo matemático do Módulo 11 alfanumérico."""
+    def __init__(self, conteudo: str):
+        self.conteudo = conteudo.upper()
+        self.pesos = []
+
+    def _calcula_ascii(self, char: str) -> int:
+        # Regra oficial: Valor ASCII - 48
+        return ord(char) - 48
+
+    def _gerar_pesos(self):
+        tamanho = len(self.conteudo)
+        # Repetições de 2 a 9
+        num_repeticoes = ceil(tamanho / 8)
+        for _ in range(num_repeticoes):
+            self.pesos.extend(range(2, 10))
+        self.pesos = self.pesos[:tamanho]
+        self.pesos.reverse()
+
+    def calcula(self) -> int:
+        self._gerar_pesos()
+        # Soma ponderada dos valores convertidos pelos pesos
+        soma = sum(a * b for a, b in zip(map(self._calcula_ascii, self.conteudo), self.pesos))
+        resto = soma % 11
+        return 0 if resto < 2 else 11 - resto
+
+class CNPJ:
+    """Classe de negócio para tratar a estrutura do CNPJ."""
+    def __init__(self, cnpj_input: str):
+        # Remove caracteres de pontuação comuns
+        self.limpo = "".join(filter(str.isalnum, str(cnpj_input))).upper()
+
+    def e_valido(self) -> bool:
+        # 1. Validação de tamanho e formato (Regex oficial do Serpro)
+        if not re.match(r'^([A-Z]|\d){12}\d{2}$', self.limpo):
+            return False
+        
+        # 2. Bloqueio de letras proibidas pela norma (I, O, Q)
+        if any(c in self.limpo for c in "IOQ"):
+            return False
+
+        # 3. Bloqueio de valores zerados (comum em testes de fumaça)
+        if self.limpo == "0" * 14:
+            return False
+
+        base = self.limpo[:12]
+        dv_informado = self.limpo[12:]
+        
+        # Cálculo do DV1
+        dv1 = DigitoVerificador(base).calcula()
+        # Cálculo do DV2 (base + dv1)
+        dv2 = DigitoVerificador(base + str(dv1)).calcula()
+        
+        return f"{dv1}{dv2}" == dv_informado
+
+def validar_cnpj(cnpj: str) -> bool:
+    """Interface simplificada para uso externo."""
+    return CNPJ(cnpj).e_valido()

alfac-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[tool.poetry]
+name = "alfac"
+version = "0.1.0"
+description = "Validador de CNPJ Alfanumérico conforme novas normas do Governo (2024)."
+authors = ["kleitomberg <kss@cin.ufpe.br>"]
+readme = "README.md"
+
+keywords = ["cnpj", "alfanumerico", "validador", "governo", "brasil"]
+license = "MIT"
+
+# Mova os classifiers para cá
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+[tool.poetry.dependencies]
+python = "^3.12"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"