br-cpf-cnpj 0.1.1__py3-none-any.whl

br_cpf_cnpj/__init__.py

@@ -0,0 +1,12 @@
+from .__version__ import __version__, __author__
+from .validator import is_valid_cpf, is_valid_cnpj
+from .generator import generate_random_cnpj, generate_random_cpf
+
+__all__ = [
+    '__version__',
+    '__author__',
+    'is_valid_cpf',
+    'is_valid_cnpj',
+    'generate_random_cpf',
+    'generate_random_cnpj'
+]

br_cpf_cnpj/__version__.py

@@ -0,0 +1,2 @@
+__version__ = "0.1.1"
+__author__ = "Renan Campista"

br_cpf_cnpj/calculation.py

@@ -0,0 +1,63 @@
+def calculate_dv_cpf(base: str) -> tuple[int, int]:
+    """Calculates the two verification digits (DVs) for a given CPF base.
+    
+    Args:
+        base (str): The first 9 digits of the CPF number.
+    Returns:
+        tuple[int, int]: A tuple containing the two calculated verification digits.
+    """
+    if len(base) != 9 or not base.isdigit():
+        raise ValueError("CPF base must have exactly 9 digits")
+
+    weight = 10
+    total = 0
+    for digit in base:
+        total += int(digit) * weight
+        weight -= 1
+
+    resto = total % 11
+    dv1 = 0 if resto < 2 else 11 - resto
+
+    weight = 11
+    total = 0
+    for digit in base + str(dv1):
+        total += int(digit) * weight
+        weight -= 1
+
+    resto = total % 11
+    dv2 = 0 if resto < 2 else 11 - resto
+
+    return dv1, dv2
+
+
+def calculate_dv_cnpj(base: str) -> tuple[int, int]:
+    """Calculates the two verification digits (DVs) for a given CNPJ base.
+
+    Args:
+        base (str): The first 12 characters of the CNPJ number.
+    Returns:
+        tuple[int, int]: A tuple containing the two calculated verification digits.
+    """
+    if len(base) != 12:
+        raise ValueError("CNPJ base must have exactly 12 characters")
+
+    weight = 2
+    total = 0
+    for i in range(11, -1, -1):
+        total += (ord(base[i]) - ord('0')) * weight
+        weight = weight + 1 if weight < 9 else 2
+
+    resto = total % 11
+    dv1 = 0 if resto < 2 else 11 - resto
+
+    weight = 2
+    total = 0
+    base_dv1 = base + str(dv1)
+    for i in range(12, -1, -1):
+        total += (ord(base_dv1[i]) - ord('0')) * weight
+        weight = weight + 1 if weight < 9 else 2
+
+    resto = total % 11
+    dv2 = 0 if resto < 2 else 11 - resto
+
+    return dv1, dv2

br_cpf_cnpj/generator.py

@@ -0,0 +1,50 @@
+import random
+import string
+
+from .calculation import calculate_dv_cpf, calculate_dv_cnpj
+
+
+def generate_random_cpf(masked: bool = False) -> str:
+    """
+    Generates a valid random CPF number (only digits).
+
+    Args:
+        masked (bool): If True, generates masked CPF (with dots and hyphen).
+                       If False, generates numeric-only CPF.
+    Returns:
+        str: A valid CPF with 11 digits.
+    """
+    base = ''.join(str(random.randint(0, 9)) for _ in range(9))
+
+    dv1, dv2 = calculate_dv_cpf(base)
+
+    if masked:
+        return f"{base[:3]}.{base[3:6]}.{base[6:9]}-{dv1}{dv2}"
+    return f"{base}{dv1}{dv2}"
+
+
+def generate_random_cnpj(masked: bool = False, alphanumeric: bool = True) -> str:
+    """
+    Generates a valid random CNPJ number.
+
+    Args:
+        masked (bool): If True, generates masked CNPJ (with dots, slashes, and hyphen).
+                       If False, generates numeric-only CNPJ.
+        alphanumeric (bool): If True, generates alphanumeric CNPJ.
+                             If False, generates numeric-only CNPJ.
+
+    Returns:
+        str: A valid CNPJ with 14 characters.
+    """
+    if alphanumeric:
+        charset = string.digits + string.ascii_uppercase
+    else:
+        charset = string.digits
+
+    base = ''.join(random.choice(charset) for _ in range(12))
+
+    dv1, dv2 = calculate_dv_cnpj(base)
+
+    if masked:
+        return f"{base[:2]}.{base[2:5]}.{base[5:8]}/{base[8:12]}-{dv1}{dv2}"
+    return f"{base}{dv1}{dv2}"

br_cpf_cnpj/normalize.py

@@ -0,0 +1,15 @@
+import re
+
+
+def normalize_cpf(value: str | int) -> str:
+    """Normalizes a CPF number by removing any non-digit characters and leading zeros."""
+    if not value or not isinstance(value, (str, int)):
+        return ''
+    return re.sub(r'\D', '', str(value))
+
+
+def normalize_cnpj(value: str) -> str:
+    """Normalizes a CNPJ by removing formatting characters and uppercasing letters."""
+    if not value or not isinstance(value, str):
+        return ''
+    return re.sub(r'[^A-Za-z0-9]', '', value).upper()

br_cpf_cnpj/validator.py

@@ -0,0 +1,41 @@
+from .normalize import normalize_cnpj, normalize_cpf
+from .calculation import calculate_dv_cnpj, calculate_dv_cpf
+
+
+def is_valid_cnpj(value: str) -> bool:
+    """Checks if the given value is a valid CNPJ number.
+
+    Args:
+        value (str): CNPJ value (numeric or alphanumeric).
+    Returns:
+        bool: True if the CNPJ number is valid, False otherwise.
+    """
+    cnpj = normalize_cnpj(value)
+
+    if len(cnpj) != 14 or cnpj == cnpj[0] * 14:
+        return False
+    
+    base = cnpj[:12]
+    dv1, dv2 = calculate_dv_cnpj(base)
+
+    return (dv1, dv2) == (int(cnpj[12]), int(cnpj[13]))
+
+
+def is_valid_cpf(value: str | int) -> bool:
+    """Checks if the given value is a valid CPF number.
+
+    Args:
+        value (str | int): The CPF number to validate.
+        NOTE: If the value is a number, it will be converted to a string and any leading zeros will be removed.
+    Returns:
+        bool: True if the CPF number is valid, False otherwise.
+    """    
+    cpf = normalize_cpf(value)
+
+    if len(cpf) != 11 or cpf == cpf[0] * 11:
+        return False
+    
+    base = cpf[:9]
+    dv1, dv2 = calculate_dv_cpf(base)
+
+    return (dv1, dv2) == (int(cpf[9]), int(cpf[10]))

br_cpf_cnpj-0.1.1.dist-info/METADATA

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: br-cpf-cnpj
+Version: 0.1.1
+Summary: CPF and CNPJ validation and generation with support for alphanumeric CNPJ
+Author-email: RenanCampista <rennan.campistah@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/RenanCampista/br-cpf-cnpj
+Project-URL: Repository, https://github.com/RenanCampista/br-cpf-cnpj
+Project-URL: Issues, https://github.com/RenanCampista/br-cpf-cnpj/issues
+Keywords: cpf,cnpj,brasil,validation,validação
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# 📦 py-cpf-cnpj
+
+A Python library for **CPF and CNPJ validation and generation**, with **support for the new alphanumeric CNPJ standard**.
+
+---
+
+## ✨ Features
+
+- ✅ CPF validation  
+- ✅ CNPJ validation (numeric and alphanumeric)  
+- 🔢 Random CPF generator  
+- 🔡 Random CNPJ generator (numeric or alphanumeric)  
+- 🧪 Fully tested with pytest 
+---
+
+## 📥 Installation
+
+```bash
+pip install py-cpf-cnpj
+```
+
+---
+
+## 🚀 Usage
+### Validate CPF
+
+```python
+from py_cpf_cnpj import is_valid_cpf
+
+is_valid_cpf("529.982.247-25")
+# True
+```
+
+### Validate CNPJ
+
+```python
+from py_cpf_cnpj import is_valid_cnpj
+
+# Validate numeric CNPJ
+is_valid_cnpj("11.222.333/0001-81")
+# True
+
+# Validate alphanumeric CNPJ
+is_valid_cnpj("2P.76B.MNX/0001-66")
+# True
+```
+
+### Generate Random CPF
+
+```python
+from py_cpf_cnpj import generate_random_cpf
+
+cpf = generate_random_cpf(masked=True)
+print(cpf)
+# e.g., "123.456.789-09"
+
+cpf_unmasked = generate_random_cpf(masked=False)
+print(cpf_unmasked)
+# e.g., "12345678909"
+```
+
+### Generate Random CNPJ
+
+```python
+from py_cpf_cnpj import generate_random_cnpj
+
+# Generate numeric CNPJ
+cnpj_numeric = generate_random_cnpj(alphanumeric=False, masked=True)
+print(cnpj_numeric)
+# e.g., "12.345.678/0001-95"
+
+# Generate alphanumeric CNPJ
+cnpj_alphanumeric = generate_random_cnpj(alphanumeric=True, masked=False)
+print(cnpj_alphanumeric)
+# e.g., "RSASKDDW000100"
+```
+
+---
+
+## 🧠 How it works
+### CPF
+- Uses fixed weights (10 → 2, then 11 → 2)
+- Applies the official modulo 11 algorithm
+- Prevents invalid repeated-digit CPFs (e.g. `11111111111`)
+
+### CNPJ (Alphanumeric)
+- Supports digits (0–9) and uppercase letters (A–Z)
+- Characters are converted using:
+  `value = ord(char) - ord('0')`
+- Weights cycle from 2 → 9
+
+---
+
+## Contributing
+Contributions are very welcome!  
+Feel free to open issues, suggest improvements, or submit pull requests.
+
+
+## 📄 License
+MIT License.
+
+---
+
+# Versão em Português
+# 📦 py-cpf-cnpj
+Uma biblioteca Python para **validação e geração de CPF e CNPJ**, com **suporte ao novo padrão de CNPJ alfanumérico**.
+
+---
+
+## ✨ Funcionalidades
+
+- ✅ Validação de CPF
+- ✅ Validação de CNPJ (numérico e alfanumérico)  
+- 🔢 Gerador de CPF aleatório
+- 🔡 Gerador de CNPJ aleatório (numérico ou alfanumérico)
+- 🧪 Testes automatizados com pytest 
+
+---
+
+## 📥 Instalação
+
+```bash
+pip install py-cpf-cnpj
+```
+
+## 🚀 Uso
+### Validar CPF
+
+```python
+from py_cpf_cnpj import is_valid_cpf
+
+is_valid_cpf("529.982.247-25")
+# True
+```
+
+### Validar CNPJ
+
+```python
+from py_cpf_cnpj import is_valid_cnpj
+
+# Validar CNPJ numérico
+is_valid_cnpj("11.222.333/0001-81")
+# True
+
+# Validar CNPJ alfanumérico
+is_valid_cnpj("2P.76B.MNX/0001-66")
+# True
+```
+
+### Gerar CPF Aleatório
+
+```python
+from py_cpf_cnpj import generate_random_cpf
+
+cpf = generate_random_cpf(masked=True)
+print(cpf)
+# e.g., "123.456.789-09"
+
+cpf_unmasked = generate_random_cpf(masked=False)
+print(cpf_unmasked)
+# e.g., "12345678909"
+```
+
+### Gerar CNPJ Aleatório
+
+```python
+from py_cpf_cnpj import generate_random_cnpj
+
+# Gerar CNPJ numérico
+cnpj_numeric = generate_random_cnpj(alphanumeric=False, masked=True)
+print(cnpj_numeric)
+# e.g., "12.345.678/0001-95"
+
+# Gerar CNPJ alfanumérico
+cnpj_alphanumeric = generate_random_cnpj(alphanumeric=True, masked=False)
+print(cnpj_alphanumeric)
+# e.g., "RSASKDDW000100"
+```
+
+---
+
+## 🧠 Como Funciona
+### CPF
+- Pesos fixos (10 → 2 e 11 → 2)
+- Algoritmo módulo 11
+- Rejeita CPFs inválidos com dígitos repetidos (e.g. `11111111111`)
+
+### CNPJ (Alfanumérico)
+- Aceita números (0–9) e letras (A–Z)
+- Conversão baseada em valor ASCII:
+  `value = ord(char) - ord('0')`
+- Pesos cíclicos de 2 → 9
+
+## Contribuindo
+Contribuições são muito bem-vindas!
+Sinta-se à vontade para abrir issues, sugerir melhorias ou enviar pull requests.
+
+## 📄 License
+MIT License.

br_cpf_cnpj-0.1.1.dist-info/RECORD

@@ -0,0 +1,11 @@
+br_cpf_cnpj/__init__.py,sha256=y7oEnZfCZrcQ3i3q6D5DKUtnaiAJyrV5NMcGHp5pWE0,322
+br_cpf_cnpj/__version__.py,sha256=_jkbh1MX9fo13gQTcQ0xuZh1RTrPX7gOAHFPeY4NNUA,52
+br_cpf_cnpj/calculation.py,sha256=Us5FymKDzHB43pO2bDie6d1k2dVYxjx9kE98lxa042k,1776
+br_cpf_cnpj/generator.py,sha256=UmoCZht1ucXk-CO4UPOCVeL7FhcqHcGW5F5enpGBMaE,1529
+br_cpf_cnpj/normalize.py,sha256=fnzd2TkEp4xno-mHgMIEaA5hRqPH8RmaxjEwgQMBZZw,523
+br_cpf_cnpj/validator.py,sha256=A_Cc2wLHMvLKISlrahBYyoD0S8gLANs75PUTM-MNo4o,1217
+br_cpf_cnpj-0.1.1.dist-info/licenses/LICENSE,sha256=IArap4WCSn0OBMYbrjTFvPLT36uj-2yfo5FsbPcwAzc,1092
+br_cpf_cnpj-0.1.1.dist-info/METADATA,sha256=7nRGwkyeSss6RdxAcL-Xt-yb5TCbJkhSt9BeeYjxW0A,4705
+br_cpf_cnpj-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+br_cpf_cnpj-0.1.1.dist-info/top_level.txt,sha256=V6jFhRasLPhiHAWntnuoCud6u0FuJ0RPT_vZg2AAQb0,12
+br_cpf_cnpj-0.1.1.dist-info/RECORD,,

br_cpf_cnpj-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

br_cpf_cnpj-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Renan Campista
+
+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.

br_cpf_cnpj-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+br_cpf_cnpj