AeroClima

AeroClima es una aplicación web desarrollada con Django que permite a los usuarios consultar el clima actual de un lugar de origen y un lugar de destino, ya sea ingresando el nombre de las ciudades o a través de un número de ticket.

Demo en vivo

aero-clima.vercel.app

Índice

1. Descripción General
2. Configuración
3. Estructura del Proyecto
4. Funcionalidad
5. Contribuciones
6. Requisitos previos
7. Instalación
8. Desactivar el entorno virtual
9. Desactivar redis-server

Descripción General

AeroClima es una herramienta intuitiva diseñada para aquellos que desean obtener información climática rápida y precisa para sus viajes. No se requiere experiencia previa en programación para usar o configurar esta aplicación.

Configuración

Requisitos

• Python 3.x
• Django 4.2.5
• requests: Necesario para realizar llamadas API.
• pandas: Utilizado para el manejo de datos.
• Levenshtein: Herramienta para la comparación de cadenas.

Configuración del Proyecto

El archivo settings.py es el corazón de la configuración del proyecto. Por razones de seguridad, nunca expongas la SECRET_KEY en repositorios públicos. Además, para que la aplicación funcione correctamente, debes agregar tu llave personal de la API de OpenWeatherMap en OPENWEATHERMAP_API_KEY.

Estructura del Proyecto

Aplicaciones

El proyecto tiene una aplicación principal denominada clima.

Clima

• Modelos: Aunque no se definen modelos específicos, se utiliza un diccionario CODIGOS_IATA para relacionar códigos IATA con nombres de ciudades.
• Vistas: La vista inicio es la principal y se encarga de la lógica para consultar el clima usando nombres de ciudades o números de ticket.
• URLs: La ruta principal path("", views.inicio, name="inicio") dirige a la vista inicio.
• Templates: La template clima.html muestra formularios para ingresar nombres de ciudades o números de ticket y desplegar el clima correspondiente.

Estilos

Los estilos del proyecto se encuentran en style.css dentro de la carpeta static. Estos estilos determinan la apariencia general de la aplicación, incluyendo colores, fuentes y diseño.

Funcionalidad

1. Consulta de Clima: Los usuarios pueden consultar el clima ingresando el nombre de las ciudades en los campos "Origen" y "Destino" o mediante un número de ticket.
2. Caché: Para optimizar el rendimiento y minimizar las llamadas a la API, se utiliza un sistema de caché.
3. Búsqueda de Ciudades por Código IATA: Si el código IATA no se encuentra en el diccionario CODIGOS_IATA, se busca la ciudad más parecida usando la distancia de Levenshtein.

Contribuciones

Si estás interesado en mejorar AeroClima o agregar nuevas funcionalidades, ¡tu ayuda es bienvenida! Simplemente clona el repositorio desde GitHub y sigue las instrucciones de instalación y configuración.

Requisitos previos

• Python 3.x

Instalación

1. Clonar el repositorio:

   Antes de comenzar la instalación, debes clonar el repositorio de AeroClima a tu máquina local.

   git clone https://github.com/Zhatra/AeroClima.git

   Una vez clonado, navega al directorio del proyecto:

   cd AeroClima

2. Configurar la llave de OpenWeatherMap:

   Antes de ejecutar el proyecto, necesitas configurar tu llave de la API de OpenWeatherMap. Para hacerlo:

   • Ve al archivo AeroClima/settings.py.
   • Busca la línea que dice OPENWEATHERMAP_API_KEY = config('OPENWEATHERMAP_API_KEY', default='tu_llave_aqui').
   • Coloca tu llave de la API entre las comillas simples del texto tu_llave_aqui. Por ejemplo, si tu llave es 1234567890abcdef, debería quedar así: OPENWEATHERMAP_API_KEY = config('OPENWEATHERMAP_API_KEY', default='1234567890abcdef').

3. Instalar Python: Si no tienes Python, descárgalo desde el sitio oficial de Python.

   # Dependiendo de tu sistema operativo, el comando puede variar.

   Instalación de pip

   pip es el sistema de gestión de paquetes de Python que te permitirá instalar paquetes de software escritos en Python, y lo ocuparemos para nuestro proyecto.

   En sistemas basados en Debian y Ubuntu:

   sudo apt update
   sudo apt install python3-pip

   En sistemas basados en Red Hat y Fedora:

   sudo yum install python3-pip

   En sistemas basados en Arch Linux:

   sudo pacman -S python-pip

   En macOS:

   Si tienes instalado Homebrew:

   brew install python3

   Con la instalación de Python a través de Homebrew, pip también debería instalarse.

   En Windows:

   Si ya tienes Python instalado desde la página oficial de Python, pip debería haberse instalado por defecto. De lo contrario, puedes descargar get-pip.py para instalar la versión más reciente de pip:

   1. Descarga get-pip.py desde https://bootstrap.pypa.io/get-pip.py en tu computadora.
   2. Abre una ventana de terminal y navega hasta la ubicación donde guardaste get-pip.py.
   3. Ejecuta python get-pip.py.

   ---

4. Instalar Redis: Es necesario para algunas funcionalidades. Descárgalo desde el sitio oficial de Redis.

   # El proceso de instalación varía según el sistema operativo.

5. Instalar virtualenv: Esta herramienta te permite crear entornos virtuales en Python.

   pip3 install virtualenv

6. Crear y activar un entorno virtual: Esto asegura que los paquetes necesarios no interfieran con otros proyectos.

   virtualenv nombre_del_entorno

   • Activar el entorno virtual:

     • En Windows:

       .\nombre_del_entorno\Scripts\activate

     • En macOS y Linux:

       source nombre_del_entorno/bin/activate

7. Instalar dependencias: Estas son las bibliotecas y herramientas necesarias para que AeroClima funcione correctamente, recuerda ejecutar este comando teniendo el entorno virtual activado.

   pip install -r requirements.txt

8. Ejecutar servidor Redis: Inicia el servidor Redis.

   redis-server

9. Ejecutar el proyecto Django: Con esto, tendrás AeroClima funcionando en tu máquina local.

   python manage.py runserver

Desactivar el entorno virtual

Una vez que hayas terminado de usar AeroClima, es una buena práctica desactivar el entorno virtual.

deactivate

Desactivar redis-server

Si ya no necesitas usar Redis, puedes detener el servidor fácilmente.

redis-cli shutdown