Por Mapachana

Durante la pandemia es difícil encontrar toda la información necesaria sobre el covid-19, mantenerse al día con todas las noticias y entender los datos que nos dan. Por tanto, el propósito de este proyecto es facilitar la comprensión de los datos epidemiológicos diarios y proporcionar un fácil acceso a toda la información y el significado de esta.

Así, cualquier usuario tendrá un acceso rápido, sencillo y directo a toda la información actualizada y ayuda para su interpretación desde el móvil.

Para ejecutar este proyecto, comienza por descargar los archivos fuente del repositorio. Esto puede hacerse descargando el repositorio directamente desde la web de github o clonando el repositorio (más información sobre cómo clonar un repositorio aquí).

Una vez clonado o descargado, nos situamos en la carpeta raíz del repositorio y abrimos una terminal.

Ahora, instalamos Invoke abriendo una terminal y usando:

pip install invoke

Para más información sobre cómo instalar invoke se puede consultar la documentación oficial.

También es necesario instalar poetry, para ello puede consultarse este enlace.

Primero, instalamos las dependencias ejecutando el siguiente comando:

invoke installdeps

Si queremos trabajar con el repositorio como desarrolladores debemos añadir el flag --dev para instalar las dependencias de desarrollador también.

Una vez hecho esto, lanzamos los tests para comprobar que todo funciona correctamente ejecutando:

invoke test

También podemos comprobar la correcta sintaxis de todos los ficheros del módulo ejecutando:

invoke check

Si no quisiéramos instalar las dependencias en nuestro ordenador personal, se puede usar un contenedor docker que puede construirse y lanzarse usando la orden:

invoke docker

O puede encontrarse el contenedor aquí

Y ejecutar los tests en este contenedor ejecutando:

docker run -t -v `pwd`:/app/test mapachana/predictor-covid

• Se puede encontrar documentación adicional sobre los tipos de usuario aquí
• La justificación sobre la elección de invoke para el Objetivo 3 puede encontrarse aquí
• La justificación de la elección del test runner y biblioteca de aserciones puede consultarse aquí
• La justificación de las decisiones tomadas respecto al contenedor docker se encuentran aquí
• La justificación de las decisiones tomadas respecto a los sistemas de integración continua se encuentra aquí
• En estos enlaces podrá ver los distintos issues creados como programador en el proyecto de Mapachana:
  • HU-P1: Elección de lenguaje de programación
  • HU-P2: Organización de las clases
• Los datos usados para el proyecto están sacados del repositorio de datadista.