Conversor de Monedas Avanzado 💱

Una aplicación de consola desarrollada en Java que permite realizar conversiones entre diferentes divisas utilizando tasas de cambio en tiempo real. Este proyecto forma parte de los desafíos de programación y está diseñado siguiendo los principios de la Programación Orientada a Objetos (POO) e integrando el consumo de APIs REST.

🚀 Características Principales

• Múltiples proveedores de datos: Permite al usuario elegir qué API utilizar para obtener las tasas de cambio:
  1. ExchangeRate-API
  2. APILayer API
• Conversión en tiempo real: Las tasas de cambio se obtienen en el momento de realizar la solicitud.
• Pares de monedas soportados en el menú rápido:
  • Dólar estadounidense (USD) 🇺🇸
  • Peso argentino (ARS) 🇦🇷
  • Real brasileño (BRL) 🇧🇷
  • Peso colombiano (COP) 🇨🇴
• Manejo de entorno: Configuración segura de credenciales mediante el uso de archivos .env.

🛠️ Tecnologías y Dependencias

El proyecto fue construido utilizando las siguientes tecnologías:

• Java 17: Lenguaje de programación principal.
• Maven: Herramienta de gestión de dependencias y construcción del proyecto.
• Gson (v2.10.1): Librería de Google utilizada para la serialización y deserialización de objetos Java a JSON.
• Dotenv-java (v3.0.0): Librería para cargar variables de entorno desde un archivo .env, manteniendo seguras las claves de acceso a las APIs.

📋 Requisitos Previos

Antes de ejecutar el proyecto, asegúrate de tener instalado:

• Java Development Kit (JDK) 17 o superior.
• Maven (Para compilar y descargar las dependencias).
• Al menos una clave de API (API Key) vigente de los proveedores mencionados (ExchangeRate o APILayer).

⚙️ Configuración del Entorno

1. Clona o descarga el repositorio en tu máquina local.
2. Navega a la carpeta principal del proyecto:

   cd /ruta/a/tu/proyecto/Convesor

3. Crea un archivo llamado .env en directorio raíz del proyecto (a la misma altura que el archivo pom.xml).
4. Abre el archivo .env e ingresa tus llaves API de la siguiente manera:

   EXCHANGE_RATE_API_KEY=tu_api_key_de_exchangerate_aqui
   API_LAYER_KEY=tu_api_key_de_apilayer_aqui

Warning

Nunca compartas ni subas tu archivo .env a repositorios públicos (como GitHub). Asegúrate de que el archivo se encuentre listado en tu .gitignore.

🏃 Cómo Ejecutar la Aplicación

Puedes ejecutar el programa directamente desde tu entorno de desarrollo (IDE) preferido como IntelliJ IDEA, Eclipse o VS Code, ejecutando la clase Principal.java.

Si prefieres usar la terminal con Maven, ejecuta los siguientes comandos en el directorio raíz:

1. Limpiar y compilar el proyecto:

   mvn clean compile

2. Ejecutar la clase principal:

   mvn exec:java -Dexec.mainClass="com.alura.conversor.Principal"

🎮 Uso del Programa

Al correr la aplicación, verás un flujo interactivo en consola:

1. Selección de API: El sistema te pedirá ingresar 1 o 2 para seleccionar de dónde obtener las tasas de conversión.
2. Menú de Divisas: Verás un menú numérico del 1 al 7 con las opciones de conversión posibles.
3. Cantidad: Una vez elegida la opción (por ejemplo: Dólar a Peso Argentino), ingresa el valor a convertir.
4. Resultado: El sistema consumirá la API, calculará el monto y mostrará el valor ya formateado en consola.
5. Para salir, selecciona la opción 7 en el menú principal.

📂 Estructura del Proyecto

src/main/java/com/alura/conversor/
├── Principal.java                   # Punto de entrada de la aplicación
└── servicios/
    ├── ConversorService.java        # Interfaz base para los servicios de conversión
    ├── ExchangeRateService.java     # Implementación para consumir ExchangeRate-API
    └── ApiLayerService.java         # Implementación para consumir APILayer API