niftools 0.1.0__tar.gz

niftools-0.1.0/LICENSE

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

niftools-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include tests *.py

niftools-0.1.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: niftools
+Version: 0.1.0
+Summary: Validador mínimo y sin dependencias de DNI, NIE y NIF de entidades
+Author: Pablo Castelo
+License: MIT License
+        
+        Copyright (c) 2026 Pablo Castelo
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/pcastelovigo/validarnif
+Project-URL: Repository, https://github.com/pcastelovigo/validarnif
+Project-URL: Issues, https://github.com/pcastelovigo/validarnif/issues
+Keywords: nif,nie,cif,dni,spain,validation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# niftools
+
+Validador mínimo y sin dependencias de identificadores fiscales españoles.
+Comprueba DNI, NIE y NIF de entidades (tradicionalmente llamado CIF) mediante
+su formato y carácter de control.
+
+## Instalación
+
+```bash
+pip install niftools
+```
+
+## Uso
+
+```python
+from niftools import normalizarnif, validarnif
+
+nif = normalizarnif("ES A-1234567-4")  # "A12345674"
+validarnif(nif)                        # True
+
+validarnif("12345678Z")             # True
+validarnif("X-1234567-L")          # True
+validarnif("12345678A")             # False
+```
+
+`normalizarnif()` elimina puntos, guiones, espacios y el prefijo internacional
+opcional `ES`, y convierte el texto a mayúsculas. `validarnif()` reutiliza esa
+normalización, por lo que acepta tanto identificadores normalizados como
+identificadores con separadores.
+
+La validación comprueba la estructura y el carácter de control. No confirma
+que el identificador haya sido emitido ni que pertenezca a una persona o
+entidad determinada.
+
+El alcance incluye DNI, NIE y NIF de entidades (tradicionalmente CIF). No
+incluye los NIF personales especiales que comienzan por `K`, `L` o `M` y
+contienen un cuerpo alfanumérico.
+
+## Compatibilidad
+
+Python 3.8 o posterior.
+
+## Pruebas
+
+```bash
+python -m unittest discover -v
+```
+
+## Licencia
+
+MIT.

niftools-0.1.0/README.md

@@ -0,0 +1,51 @@
+# niftools
+
+Validador mínimo y sin dependencias de identificadores fiscales españoles.
+Comprueba DNI, NIE y NIF de entidades (tradicionalmente llamado CIF) mediante
+su formato y carácter de control.
+
+## Instalación
+
+```bash
+pip install niftools
+```
+
+## Uso
+
+```python
+from niftools import normalizarnif, validarnif
+
+nif = normalizarnif("ES A-1234567-4")  # "A12345674"
+validarnif(nif)                        # True
+
+validarnif("12345678Z")             # True
+validarnif("X-1234567-L")          # True
+validarnif("12345678A")             # False
+```
+
+`normalizarnif()` elimina puntos, guiones, espacios y el prefijo internacional
+opcional `ES`, y convierte el texto a mayúsculas. `validarnif()` reutiliza esa
+normalización, por lo que acepta tanto identificadores normalizados como
+identificadores con separadores.
+
+La validación comprueba la estructura y el carácter de control. No confirma
+que el identificador haya sido emitido ni que pertenezca a una persona o
+entidad determinada.
+
+El alcance incluye DNI, NIE y NIF de entidades (tradicionalmente CIF). No
+incluye los NIF personales especiales que comienzan por `K`, `L` o `M` y
+contienen un cuerpo alfanumérico.
+
+## Compatibilidad
+
+Python 3.8 o posterior.
+
+## Pruebas
+
+```bash
+python -m unittest discover -v
+```
+
+## Licencia
+
+MIT.

niftools-0.1.0/niftools.egg-info/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: niftools
+Version: 0.1.0
+Summary: Validador mínimo y sin dependencias de DNI, NIE y NIF de entidades
+Author: Pablo Castelo
+License: MIT License
+        
+        Copyright (c) 2026 Pablo Castelo
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/pcastelovigo/validarnif
+Project-URL: Repository, https://github.com/pcastelovigo/validarnif
+Project-URL: Issues, https://github.com/pcastelovigo/validarnif/issues
+Keywords: nif,nie,cif,dni,spain,validation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# niftools
+
+Validador mínimo y sin dependencias de identificadores fiscales españoles.
+Comprueba DNI, NIE y NIF de entidades (tradicionalmente llamado CIF) mediante
+su formato y carácter de control.
+
+## Instalación
+
+```bash
+pip install niftools
+```
+
+## Uso
+
+```python
+from niftools import normalizarnif, validarnif
+
+nif = normalizarnif("ES A-1234567-4")  # "A12345674"
+validarnif(nif)                        # True
+
+validarnif("12345678Z")             # True
+validarnif("X-1234567-L")          # True
+validarnif("12345678A")             # False
+```
+
+`normalizarnif()` elimina puntos, guiones, espacios y el prefijo internacional
+opcional `ES`, y convierte el texto a mayúsculas. `validarnif()` reutiliza esa
+normalización, por lo que acepta tanto identificadores normalizados como
+identificadores con separadores.
+
+La validación comprueba la estructura y el carácter de control. No confirma
+que el identificador haya sido emitido ni que pertenezca a una persona o
+entidad determinada.
+
+El alcance incluye DNI, NIE y NIF de entidades (tradicionalmente CIF). No
+incluye los NIF personales especiales que comienzan por `K`, `L` o `M` y
+contienen un cuerpo alfanumérico.
+
+## Compatibilidad
+
+Python 3.8 o posterior.
+
+## Pruebas
+
+```bash
+python -m unittest discover -v
+```
+
+## Licencia
+
+MIT.

niftools-0.1.0/niftools.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+MANIFEST.in
+README.md
+niftools.py
+pyproject.toml
+niftools.egg-info/PKG-INFO
+niftools.egg-info/SOURCES.txt
+niftools.egg-info/dependency_links.txt
+niftools.egg-info/top_level.txt
+tests/__init__.py
+tests/test_validarnif.py

niftools-0.1.0/niftools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

niftools-0.1.0/niftools.egg-info/top_level.txt

@@ -0,0 +1 @@
+niftools

niftools-0.1.0/niftools.py

@@ -0,0 +1,15 @@
+def normalizarnif(nif: str) -> str:
+    nif=nif.upper().translate(str.maketrans("", "", ".- "))
+    return nif[2:] if nif.startswith("ES") else nif
+
+
+def validarnif(nif: str) -> bool:
+    nif=normalizarnif(nif)
+    if len(nif) != 9 or not nif.isascii() or not nif[1:8].isdigit(): return False
+    pr, nu, ct = nif[0],nif[1:8],nif[8]
+    lt = "TRWAGMYFPDXBNJZSQVHLCKE"
+    if pr.isdigit():return ct==lt[int(nif[:8]) % 23]
+    if pr in"XYZ":return ct==lt[(int(nu)+"XYZ".index(pr)*10000000)%23]
+    tt=sum(map(int,nu[1::2]))+sum(2*int(cf)-9*(cf>"4")for cf in nu[::2])
+    dg=-tt%10
+    return pr in"ABCDEFGHJNPQRSUVW"and ct in(str(dg),"JABCDEFGHI"[dg])

niftools-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "niftools"
+version = "0.1.0"
+description = "Validador mínimo y sin dependencias de DNI, NIE y NIF de entidades"
+authors = [{name = "Pablo Castelo"}]
+readme = "README.md"
+requires-python = ">=3.8"
+license = {file = "LICENSE"}
+keywords = ["nif", "nie", "cif", "dni", "spain", "validation"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/pcastelovigo/validarnif"
+Repository = "https://github.com/pcastelovigo/validarnif"
+Issues = "https://github.com/pcastelovigo/validarnif/issues"
+
+[tool.setuptools]
+py-modules = ["niftools"]

niftools-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

niftools-0.1.0/tests/test_validarnif.py

@@ -0,0 +1,75 @@
+import unittest
+
+from niftools import normalizarnif, validarnif
+
+
+class ValidarNifTests(unittest.TestCase):
+    def test_normalizar_nif(self):
+        self.assertEqual(normalizarnif("A-1234567-4"), "A12345674")
+        self.assertEqual(normalizarnif("12.345.678-z"), "12345678Z")
+        self.assertEqual(normalizarnif("ES A-1234567-4"), "A12345674")
+        self.assertEqual(normalizarnif("es12.345.678-z"), "12345678Z")
+
+    def test_validar_salida_normalizada(self):
+        nif = normalizarnif("X-1234567-L")
+        self.assertTrue(validarnif(nif))
+
+    def test_prefijo_es(self):
+        self.assertTrue(validarnif("ES A-1234567-4"))
+        self.assertTrue(validarnif("es12.345.678-z"))
+
+    def test_rechaza_digitos_no_ascii(self):
+        self.assertFalse(validarnif("A١٢٣٤٥٦٧4"))
+
+    def test_dni(self):
+        self.assertTrue(validarnif("12345678Z"))
+        self.assertFalse(validarnif("12345678A"))
+
+    def test_nie(self):
+        self.assertTrue(validarnif("X1234567L"))
+        self.assertFalse(validarnif("X1234567A"))
+
+    def test_cif_con_control_numerico_o_alfabetico(self):
+        self.assertTrue(validarnif("A12345674"))
+        self.assertTrue(validarnif("A1234567D"))
+
+    def test_control_cif_cero(self):
+        self.assertTrue(validarnif("A00000000"))
+        self.assertTrue(validarnif("A0000000J"))
+
+    def test_normalizacion(self):
+        self.assertTrue(validarnif("12.345.678-z"))
+        self.assertTrue(validarnif("X-1234567-L"))
+        self.assertTrue(validarnif("A 123 456 74"))
+
+    def test_formatos_invalidos(self):
+        self.assertFalse(validarnif(""))
+        self.assertFalse(validarnif("O12345674"))
+        self.assertFalse(validarnif("A12345675"))
+        self.assertFalse(validarnif("1234A678Z"))
+
+    def test_38000_combinaciones_validas(self):
+        letras = "TRWAGMYFPDXBNJZSQVHLCKE"
+        controles = "JABCDEFGHI"
+        prefijos = "ABCDEFGHJNPQRSUVW"
+
+        for numero in range(1000):
+            cuerpo = f"{numero:07d}"
+            total = sum(map(int, cuerpo[1::2]))
+            total += sum(
+                sum(divmod(2 * int(cifra), 10)) for cifra in cuerpo[::2]
+            )
+            control = -total % 10
+            for prefijo in prefijos:
+                self.assertTrue(validarnif(prefijo + cuerpo + str(control)))
+                self.assertTrue(validarnif(prefijo + cuerpo + controles[control]))
+
+            dni = f"{numero:08d}"
+            self.assertTrue(validarnif(dni + letras[numero % 23]))
+            for prefijo, valor in zip("XYZ", range(3)):
+                posicion = (valor * 10000000 + numero) % 23
+                self.assertTrue(validarnif(prefijo + cuerpo + letras[posicion]))
+
+
+if __name__ == "__main__":
+    unittest.main()