Aquí tienes un README combinado que incluye todos los elementos mencionados, con instrucciones claras sobre cómo configurar, compilar y ejecutar el proyecto tanto desde una IDE como desde la línea de comandos. También he añadido detalles sobre el uso de Eclipse para aquellos que prefieran trabajar en una IDE.

Consulta DNI Java

Este es un pequeño programa hecho en Java que consulta el DNI y obtiene los nombres de las personas. La API utilizada es proporcionada por un tercero: apiperu.dev.

Características

Consulta información de una persona por su DNI.
Muestra los nombres completos, apellido paterno y materno.
Uso de una API externa para obtener los datos.

Requisitos

Java 8 o superior
Maven
Una IDE como Eclipse o IntelliJ (opcional, pero recomendado)

Instalación

1. Clona este repositorio:

git clone https://github.com/BrayanDaga/BuscadorDNI.git
cd BuscadorDNI

2. Configura las variables de entorno:

Crea un archivo .env en el directorio raíz del proyecto con el siguiente contenido:

# Token de la API
API_TOKEN=your_bearer_token_here

3. Construye el proyecto con Maven:

mvn clean install

Ejecución

Opción 1: Ejecutar desde la línea de comandos

Compila el proyecto usando Maven:
```
mvn clean package
```
Esto generará un archivo JAR en el directorio target/, como target/buscadorDNI.jar.
Asegúrate de que el archivo .env esté en la raíz del proyecto (junto al directorio target).
Ejecuta el JAR con el siguiente comando:
```
java -jar target/buscadorDNI.jar
```

Opción 2: Ejecutar en Eclipse

Importa el proyecto en Eclipse:
- Abre Eclipse.
- Selecciona File > Import > Existing Maven Projects.
- Navega a la ubicación del proyecto clonado y selecciona la carpeta del proyecto.
- Haz clic en Finish para importar el proyecto.
Configura las variables de entorno:
- Asegúrate de que el archivo .env esté en la raíz del proyecto.
- Si Eclipse no reconoce automáticamente las variables de entorno del archivo .env, puedes configurar el Run Configuration para que use el archivo .env o manualmente agregar las variables en la configuración.
Ejecuta el proyecto:
- Haz clic derecho en el archivo Launcher.java.
- Selecciona Run As > Java Application.

Opción 3: Ejecutar con doble clic (solo Windows)

Crea un archivo start-app.bat en la raíz del proyecto con el siguiente contenido:
```
@echo off
javaw -jar target/buscadorDNI.jar
```
Haz doble clic en start-app.bat para iniciar la aplicación. Esto lanzará la aplicación sin abrir la consola de comandos.

Opción 4: Crear un ejecutable `.exe`

Si prefieres un ejecutable nativo de Windows:

Usa Launch4j o JSmooth para crear un archivo .exe a partir del JAR.
Configura la herramienta para usar javaw para que la consola no se muestre.

Uso

Ingresa un DNI de 8 dígitos en el campo correspondiente.
Haz clic en el botón "Consultar".
La información de la persona será mostrada en el área de resultados.

Contribuciones

Las contribuciones son bienvenidas. Siéntete libre de abrir un issue o enviar un pull request.

Licencia

Este proyecto está bajo la Licencia MIT. Para más detalles, consulta el archivo LICENSE.

Este README ahora cubre cómo clonar el proyecto, configurarlo, y ejecutarlo utilizando diferentes métodos, incluyendo el uso de Eclipse, la línea de comandos y la creación de un ejecutable .exe para una experiencia de usuario más sencilla.

BrayanDaga/BuscadorDNI