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

¿Necesitamos otra biblioteca?

El Toolkit Dojo está maduro e incluye hasta el los hielos del whisky. Es ampliamente popular y muchas interfaces UI fueron construidas sobre este toolkit, incluyendo script.aculo.us, Rico, y otros. Por supuesto, no podemos dejar afuera a mootools. Su biblioteca UI, moo.fx, puede apoyarse sobre Prototype si lo deseas. Tambiñen está Y!UI the Yahoo! User Interface library. Y tenemos ExtJs, un robusto framework de interfaz que se basa en Y!UI, Prototype, o jQuery.

jQuery

Lo que nos trae a... jQuery. Sí, otro framework JavaScript. jQuery, sin embargo, es a mi criterio el más rápido y elegante del montón. Soporta CSS3, detección del navegador, encadenamiento de métodos, plugins, Ajax, selectores flexibles, y efectos UI basicos. Todo en menos de 30Kb.

Pues bien, engolosinemos los ojos un poco. Hacé click acá para ver lo que jQuery puede hacer con un par de líneas de código.

Wow! Jquery en acción. ¿Lo ves? Ese efecto se logra con este sencillo código:

$("a.intro").click( function() {
    $("div.introtarget").toggle(100);return false;

Github ♥ Nikola

Este blog que estás leyendo está hospedado en Github Pages , el servicio de hosting gratuito de contenido estático que ofrece Github.

A diferencia de cuando se usa Gh-pages para proyectos, donde se sirve el contenido del branch gh-page del proyecto en cuestión, para usar gh-pages por usuario hay que crear un repo llamado <username>.github.com (donde <username> es el tuyo) y lo que sirve en http://<username>.github.com es directamente el branch master (referencia)

Por este motivo creé otro branch (que sin mucha imaginación denominé writing ) donde tengo todo el mi "proyecto" hecho con Nikola

Allí escribo, intento mejorar mi theme, y corro nikola build.

El branch master es el de deploy y sirve todo lo que haya en la carpeta output/ del branch writing. Para hacer esto hay que ir a master, borrar todo y leer desde el árbol del otro branch con read-tree

git checkout master
git rm *    # sólo la primera vez
git read-tree writing:output
git commit -m 'deploying last build'
git push

Migrando desde Spip

Uno de los motivos que me llevaron a migrar desde Spip es que el markup que usa es ad hoc y muy feo. Algo así

{{{ Un intertítulo }}}

Esto es {{negrita}} y este [mi twitter->http://twitter.com/tin_nqn_]

Hasta ahí no se ve tan mal, pero es muy limitado cuando se trata de mostrar código, necesario en todo blog mas o menos técnico.

Para migrar esquivé la idea de convertir el markup de spip y opté por un scrapping, limpieza y conversión a restructuredText usando el mágico Pandoc (y la ayuda de PyQuery)

El script que hice está acá . No es perfecto, pero está lo importante: contenidos, imágenes, adjuntos, convertido a restructuredText bastante decente que mejoraré poco a poco a mano.

Estilos

Es mentira que a los ñoños no nos gustan las cosas (los blogs, entre otras) que se ven bonitos. Sucede, en realidad, que la mayoría de las veces no venimos con esa habilidad y el esfuerzo que nos implica intentarlo preferimos ponerlo en otra cosa. No gusta, pero no es lo más importante.

No obstante, yo quiero que este espacio sea lindo y legible. Y como hay muchos otros ñoños con sitios lindos y legibles que son tan amables de compartir sus estilos (y existe bootstrap, claro) voy a ir intentándolo, incrementalmente.

Por ahora tomé ideas y CSS de stevelosh.com [1] y de la documentación de Flask [2] basado en el theme Readable de bootswatch.com

Disqus

El blog viejo usaba Disqus, con un plugin que hice hace algun tiempo. Para migrar los comentarios utilicé el método de subir un CSV con el formato que genera el mismo script de migración:

URL_POST_X_OLD, URL_POST_X_NEW
URL_POST_Y_OLD, URL_POST_Y_NEW

En cuestión de minutos los (pocos) comentarios estaban migrados.

Redirección

Como mantuve el slug de los viejos artículos, una redirección 301 via .htaccess redirige del viejo blog al nuevo:

# nqnwebs.com blog rules
RewriteCond %{HTTP_HOST} ^nqnwebs [nc]
RewriteRule ^blog[/]?$ http://mgaitan.github.com/ [R=301]
RewriteRule ^blog/article/(.*)$ http://mgaitan.github.com/posts/$1.html [R=301]

¿Cómo se va viendo?