Creando un nuevo proyecto Python

Las herramientas

• Virtualenv: es una herramienta para aislar tu entorno de desarrollo python. Es muy pero muy útil para evitar conflictos entre las dependencias de tus distintos proyectos.

• virtualenvwrapper: es un conjunto de extensiones que hacen la vida del usuario virtualenv aun más feliz, permitiendo crear y borrar entornos virtuales, asociarlos a un proyecto, automatizar tareas al activar o desactivar uno, etc.

• pip: es la herramienta moderna, correcta y recomendada para administrar los paquetes python instalados en tu sistema/virtualenv. Es un reemplazo de easy_install

• Distribute: es la herramienta moderna y recomendada para distribuir tu paquete python. Es un fork de setuptools (que es, a su vez, una mejora sobre el módulo estándar distutils)

• skeleton es una herramienta que define plantillas para iniciar un proyecto, generando la estructura básica necesaria. Es similar a PasteScript pero enfocado en esta tarea concreta, sin dependencias y compatible con Python 3.x

La receta

1. Instalá pip:

   $ sudo apt-get install python-pip

   o bien directamente:

   $ sudo curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python

2. Instalá virtualenwrapper y skeleton:

   $ sudo pip install virtualenwrapper
   $ sudo pip install git+git://github.com/stumitchell/skeleton.git#egg=skeleton

3. Configurá virtualenvwrapper

   $ mkdir ~/.virtualenvs           # acá se van a guardar tus entornos virtuales
   $ mkdir ~/proyectos              # acá se van a guardar tus proyectos
   $ mkdir ~/.pip_download_cache     # para no bajar paquetes cada vez
   

   Luego editá tu ~/.bashrc agregando las siguientes líneas

   export WORKON_HOME=$HOME/.virtualenvs
   export PROJECT_HOME=$HOME/proyectos
   export VIRTUALENV_DISTRIBUTE=true
   export PIP_DOWNLOAD_CACHE=$HOME/.pip_download_cache
   source /usr/local/bin/virtualenvwrapper.sh
   

   y recargá tus cambios:

   $ source ~/.bashrc

4. Inicializá tu proyecto. Por ejemplo el proyecto zaraza

   $ mkproject -t package zaraza

   Se te solicitarán algunos datos (nombre del proyecto, autor, licencia, etc.) y ¡(casi) listo! Estarás trabajando en tu proyecto zaraza. Tu prompt se verá así

   (zaraza)tin@morocha:~/proyectos/zaraza$

   ¿Qué sucedió? Se creó un directorio ~/proyectos/zaraza para tu proyecto, asociado a un virtualenv ubicado en ~/.virtualenvs/zaraza. skeleton automáticamente creó una estructura básica de paquete python en ~/proyectos/zaraza/src incluyendo un setup.py basado en distribute.

5. Instalá tu paquete en el virtualenv, para poder importarlo desde cualquier lado:

   (zaraza) $ cd  ~/proyectos/zaraza/src
   (zaraza) $ pip install -e .

   Esto agrega el directorio de desarrollo de tu proyecto al PYTHONPATH del virtualenv, de modo que puedes importar zaraza desde cualquier lado dentro del virtualenv (por ejemplo, cuando hagas una carpeta src/test al nivel de '/src/zaraza'

¿Y ahora?

Cada vez que quieras trabajar en tu proyecto zaraza ejecutás:

$ workon zaraza

Para salir del virtualenv:

(zaraza) $ deactivate

Algunos tips más a modo de despedida

Virtualenwrapper es totalmente hookeable y extensible. Esta receta propone usar skeleton (que funciona como plugin de virtualenvwrapper.project) para crear una estructura de paquete estándar básica, pero hay plugins para proyectos más específicos. Por ejemplo virtualenwrapper.django

El comando mkproject es un wrapper sobre el comando principal de virtualenvwrapper mkvirtualenv, que acepta muchos parámetros opcionales. Ejecutá mkproject_help o mkvirtualenv --help para saber más.

Y ya sabés ...

Este artículo lo escribí originalmente para el Recetario de PyAr