Skip to content

README.md

Latest commit

 

History

History
145 lines (97 loc) · 3.74 KB

README.md

File metadata and controls

145 lines (97 loc) · 3.74 KB

script-clima-v2

Un script de Python interactivo para consultar el clima en tiempo real desde la terminal, utilizando la API de WeatherAPI.com.

Weather data by WeatherAPI.com

📋 Descripción

script-clima-v2 es una aplicación de línea de comandos que permite consultar información meteorológica actual de cualquier ciudad del mundo. Utiliza la API gratuita de WeatherAPI.com para obtener datos precisos y actualizados, presentados en una interfaz visual atractiva con colores y emojis.

✨ Características

  • 🌡️ Consulta de temperatura actual y sensación térmica
  • 💧 Información de humedad
  • ☁️ Condición meteorológica con iconos descriptivos
  • ⏰ Última actualización de los datos
  • 🎨 Interfaz visual rica con tablas y paneles (usando Rich)
  • 🌍 Soporte para cualquier ciudad del mundo
  • ⚡ Respuesta rápida con manejo de errores
  • 🇦🇷 Ciudad por defecto: Buenos Aires

📋 Requisitos

  • Python ≥ 3.13
  • Conexión a internet
  • Cuenta gratuita en WeatherAPI.com para obtener API Key

📦 Instalación

  1. Clona o descarga el repositorio
  2. Instala las dependencias:
pip install -e .

O instala manualmente:

pip install rich>=14.3.3

⚙️ Configuración

Obtener API Key

  1. Ve a weatherapi.com
  2. Crea una cuenta gratuita
  3. Genera tu API Key desde el dashboard
  4. Copia la clave

Configurar el Script

Copia el archivo de ejemplo y configura tu API Key:

cp config_example.py info_clima/config.py

Edita info_clima/config.py y reemplaza "INSERTAR API KEY AQUÍ" con tu clave real:

API_KEY = "tu_api_key_aqui"

🚀 Uso

Ejecuta el script desde la terminal:

info_clima

El script te pedirá que ingreses una ciudad:

Ingrese una ciudad (deje vacío para Buenos Aires):
  • Escribe el nombre de una ciudad (ej: "Madrid", "Nueva York")
  • Presiona Enter sin escribir nada para usar Buenos Aires como predeterminado

📊 Ejemplo de Salida

╭─ ⛅ Clima en Buenos Aires ─╮
│ Temperatura:              27.4 °C │
│ Sensación térmica:        27.7 °C │
│ Humedad:                  62%     │
│ Condición:                Parcialmente nublado │
│ Última actualización:     2026-03-05 16:00 │
╰─────────────────────────────────────╯

📁 Estructura del Proyecto

script_clima_v2/
├── info_clima/
│   ├── __init__.py
│   ├── config.py          # Configuración de API Key
│   ├── dict_iconos.py     # Mapeo de iconos meteorológicos
│   └── info_clima.py      # Código principal del script
├── config_example.py      # Ejemplo de configuración
├── pyproject.toml         # Configuración del proyecto
├── LICENSE                # Licencia
└── README.md             # Este archivo

🛠️ Desarrollo

Dependencias

  • rich (≥ 14.3.3): Para la interfaz visual en terminal

Ejecutar en Modo Desarrollo

python -m info_clima.info_clima

📝 Notas Técnicas

  • Timeout de conexión: 10 segundos
  • Solo muestra clima actual (no pronóstico)
  • Requiere conexión a internet activa
  • API gratuita tiene límites de uso (ver WeatherAPI.com)

📄 Licencia

Ver archivo LICENSE para más detalles.

🙏 Créditos

¡Disfruta consultando el clima desde tu terminal! 🌤️