README

Dojo python pandas

En este repositorio se encuentra el codigo del Dojo python-pandas. El software esta desarrollado en el lenguaje de programacion Python a traves del framework flask usado para crear aplicaciones web.

Versiones

Python -> 3.6.x (La version 3.7.x aún presenta incompatibilidad con varias librerías usadas, e.g. celery)
flask -> 1.0.x
redis -> 4.0.x - 5.0.x (Se ha probado en esas versiones y funciona correctamente)
pandas -> 0.24.2

Para empezar

Ambiente virtual de python

Antes de empezar se recomienda usar un ambiente virtual de python. Para esto se pueden usar las librerias virtualenv y virtualenvwrapper. virtualenvwrapper es una libreria que ayuda a gestionar los ambientes creados con virtualenv. En la documentacion de cada una de ellas se explica como pueden ser instaladas.

Virtualenv: https://virtualenv.pypa.io/en/latest/

Virtualenvwrapper: https://virtualenvwrapper.readthedocs.io/en/latest/

sudo apt-get install virtualenv

sudo apt install python3-pip

pip3 install virtualenvwrapper

Editamos el archivo de configuración bashcr y agregarmos las siguientes lineas al final del archivo. Para esto nos paramos en la base del proyecto

cd /home/drai06
nano .bashrc

export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export WORKON_HOME=$HOME/.virtualenvs
export PROJECT_HOME=$HOME/Devel
source /home/drai06/.local/bin/virtualenvwrapper.sh

Parados en la carpeta base ejecutamos el siguiente comando para aplicar los cambios. cd /home/drai06

source ~/.bashrc

Importante: crear el ambiente con la version 3.6.x de Python. Para instalar las diferentes librerías y paquetes en python se debe tener instalador el manejadro de paquetes de python PIP. Normalmente viene instalado en sistemas UNIX. Si no se encuentra, en Linux se puede instalar con el respectivo manejador de paquetes del sistma operativo (yum, apt) y en MACOS puede ser instalado con brew al instalar la version de Python requerida.

Para crear el ambiente con virtualenvwrapper se usa el siguiente comando:

mkvirtualenv -p python3.6 dojopython

La version python3.6 debe estar instalada en el equipo para poder usarla en la creacion del ambiente.

Para trabajar con el ambiente de python creado se usa el comando:

workon dojopython

Para salir del ambiente y volver a la version local de python se usa el comando:

deactivate

Cuando se trabaja con un ambiente virtual se crea una version aislada de Python con su propio manejador de paquetes PIP. Las librerias instaladas con PIP estando activado el ambiente virtual, solo quedan disponibles en dicho ambiente. Esto sirve para no tener conflictos con versiones y otras librerías.

Instalación de dependencias

Ya creado y activado el ambiente virtual de python, con la version requerida, se pueden instalar las dependencias de la aplicación. Para instalar las dependencias se usa el siguiente comando dentro del ambiente virtual ubicando la consola en la carpeta base del proyecto: Descargamos el proyecto en el escritorio y accedemos a la carpeta por consola

cd /home/drai06/Escritorio/dojopython-master

pip install -e .

Todas las dependencias se encuentran en el archivo setup.py el cual es identificado por el comando anterior para poder instalar los paquetes requeridos.

Instalación gestor de paquetes

Es requerido administrar las librerias externas por medio de un gestor de paquetes, para ello debemos instalar webpack mediante npm y nodejs, ejecutamos los diguientes comandos.


sudo apt install nodejs

Posterior a la instalación nos ubicamos en la carpeta /app/static/ y ejecutamos los comandos

cd /home/drai06/Escritorio/dojopython-master/app/static
sudo apt install npm

Correr en ambiente de desarrollo

Para correr el software en ambiente de desarrollo se puede usar el servidor de aplicaciones que viene por defecto con flask. Según la documentación este servidor solo debe ser usado en desarrollo, para ambientes de produccion se deben usar servidores optimizados para dicho fin. En este caso se usa gunicorn que es un servidor Python WSGI HTTP.

Antes de iniciar cualquier tipo de servidor se deben especificar las variables de entorno necesarias. En sistemas UNIX se hace de la siguiente manera: