Metadata-Version: 2.4
Name: PyDNI
Version: 0.2.0
Summary: Verificador de DNIs y CIFs españoles
Home-page: https://github.com/agonzalezla/PyDNI
Author: Alberto Gonzalez
Author-email: agonzalezla@protonmail.com
License: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: Spanish
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

![Estado](https://img.shields.io/badge/Estado-En%20desarrollo-blue)
# PyDNI

Es un módulo educativo de Python que permite validar DNIs y CIFs españoles de forma sencilla y rápida.  
Ideal para proyectos que necesiten comprobar la validez de identificadores fiscales o personales en España.


## Características

- Verificación de DNI (Documento Nacional de Identidad)
- Verificación de CIF (Código de Identificación Fiscal)
- Función unificada `verificar_identificador()` que detecta el tipo automáticamente
- Estructura modular, fácil de integrar en otros proyectos
- Código limpio y compatible con Python 3.10 o superior


## Instalación

```bash
pip install .
```

(Ejecuta este comando en la carpeta donde esté el `setup.py` del paquete.)

Si prefieres usarlo directamente sin instalarlo, puedes importarlo desde el directorio:

```python
from PyDNI import verificar_dni, verificar_cif, verificar_identificador
```


## Uso básico

```python
from PyDNI import verificar_dni, verificar_cif, verificar_identificador

# Verificar un DNI
print(verificar_dni("12345678Z"))   # True

# Verificar un CIF
print(verificar_cif("A58818501"))   # True

# Detección automática
print(verificar_identificador("12345678Z"))   # "DNI válido"
print(verificar_identificador("A58818501"))   # "CIF válido"
```

## Instalacion con pip desde PyPI
```bash
pip install PyDNI
```

https://pypi.org/project/PyDNI/

## Estructura del paquete

```
PyDNI/
├── PyDNI/
│   ├── __init__.py
│   ├── dni.py
│   ├── cif.py
│   ├── nie.py       
│   ├── nif.py        
│   └── utils.py
├── setup.py
├── test.py
└── CHANGELOG.md
```


## Requisitos

- Python 3.10 o superior
- No requiere dependencias externas


## Test rápido

Ejecuta el archivo `test.py` incluido:

```bash
python test.py
```

Deberías ver algo como:

```
DNI 12345678Z: True
CIF A58818501: True
Auto (DNI): DNI válido
Auto (CIF): CIF válido
```


## Próximas mejoras
- Pruebas unitarias automáticas (pytest)

## Autor

**Alberto Gonzalez**  
agonzalezla@protonmail.com  

## Licencia

Este proyecto se distribuye bajo la licencia MIT.  
Consulta el archivo `LICENSE`
