Virtualenv es una herramienta que nos ayuda a crear ambientes aislados para Python en palabras mas simples instala las bibliotecas e intérprete en una carpeta separada a la de nuestra instalación en el sistema operativo, la ventajas están en que nos provee una manera fácil, rápida, segura y reproducible de hacer desarollo y pruebas de diversas aplicaciones.

Por otra parte pip es una herramienta para instalar paquetes de Python desde el Python Package Index que es el repositorio comunitario de paquetes. En conjunto con virtualenv, pip nos ayuda a tener todo organizado y limpio.

Usando Virtualenv

Primeramente lo instalamos con nuestro manejador de paquetes favorito, en caso de ubuntu el paquete se llama “python-virtualenv” luego procedemos a crear nuestro primer ambiente virtual.


virtualenv primer_ambiente --no-site-packages


Donde primer_ambiente es el nombre que deseamos ponerle y –no-site-packages es un parámetro para que se cree un ambiente totalmente limpio tal y como fuera una instalación básica de python sin ninguna biblioteca extra. La ejecución de este comando creará una carpeta en el directorio en donde lo ejecutamos, recomiendo crear en su directorio $HOME una carpeta llamada virtualenvs para guardar todos los que vayamos creando en un solo lugar. Para activarlo hacemos lo siguiente:


source /path/a/primer_ambiente/bin/activate

Sabremos que está activo por que en nuestra consola aparecerá (primer_ambiente) en el prompt, ya en nuestro ambiente podremos usar pip para confirugrarlo a nuestro gusto.

Para volver a la normalidad usamos el comando:

deactivate

Usando pip

La función principal de pip: instalar, actualizar y eliminar paquetes nos enfocaremos en esas tres funciones.

Instalar:

pip install django
pip install django==1.3.1


La primera línea instalaría django en la versión mas actual del pypi, mientras que en la segunda con el operador de igualdad podemos forzar la instalación de una versión específica de django o cualquier paquete requerido, esto es muy útil a la hora de tener incompatibilidades o código legacy.

Desinstalar

pip uninstall django

Simplemente elimina el paquete especificado.

Actualizar

pip install django --upgrade

Instalará la versión mas actual del paquete ya instalado previamente.

Congelar

pip freeze > requirements.txt

Esto produce un archivo de requemientos en el formato que pip puede entender, el archivo de requerimientos detalla las dependencias que tiene un ambiente, su formato acepta tanto origenes del pypi, paquetes en formato tar.gz repositorios en git, mercurial y svn. Comúnmente nos encontraremos de un requirements.txt en muchos proyectos.

Si ejecutamos este comando  en primer_ambiente seguramente tendremos un par de requerimientos, django que hemos instalado manualmente y distribute, que viene por defecto.

Instalar desde un archivo de requerimiento.

pip install -r requirements.txt

Esto leerá el archivo de requerimientos y lo instalará en el ambiente actual.

¿De qué nos sirve todo esto?

Simple: orden, orden, orden! Ventajas de usar virtualenv + pip:

1. reproducible
2. fácil de compartir por medio del archivo de requerimiento
3. no afecta los paquetes del sistema
4. nos ayuda a la hora de hacer deployments con django.

Django usa archivos Python para guardar configuraciones, aprovecha la manera de trabajar del lenguaje para hacer archivos de configuración fáciles de leer, extender y utilizar dentro de nuestros proyectos.

Normalmente al iniciar una aplicación creamos un proyecto en blanco con el comando startproject que nos crea una carpeta con los archivos necesarios para iniciar.

Por defecto estas configuraciones tienen ciertos valores de los cuales normalmente nos molestaremos en cambiar sólo algunas, como configuración de bases de datos, ubicación de archivos estáticos y servidor de correo.

Acá algunos trucos para hacer estas configuraciones de manera dinámica y distribuibles para usarse en sistemas de control de versiones:

Separación del archivo settings.py

Este archivo contiene muchas veces datos sensibles que no pueden  ser publicados o simplemente varían de una estación de trabajo a otra, por lo que conviene separarlo con un archivo extra que por convención lo llamamos“settings_local.py” acá deberán ir estas configuraciones:

• DATABASES
• ADMINS
• DEBUG
• TEMPLATE_DEBUG
• SECRET_KEY (si lo vas a hacer código libre y público)
• Claves privadas en caso de usarse( ej. alguna clave de API de terceros)
• Configuraciones de correo.

Como prodrán ver acá incluyo una configuración extra llamada PROJECT_DIR que usaremos luego. Para mandar a llamar este nuevo archivo en el inicio de nuestros settings.py incluimos la siguiente línea:

from settings_local import *

Dinamizando las rutas de archivos estáticos.

Django requiere rutas de archivos para cargar archivos estáticos y definir donde estarán nuestras plantillas, para hacer esto de manera dinámica y distribuible usamos un poco de Python. En el archivo settings_local definimos PROJECT_DIR, que no es mas que la ruta del directorio donde se encuentra dicho archivo, a partir de éste armaremos MEDIA_ROOT, TEMPLATE_DIRS y STATIC_ROOT

Ejemplo:

gitignore

Si vas a usar git u otro sistema de control de versiones recomiendo agregar ciertos archivos al ignore de tu SCM para git tengo un ejemplo acá será similar para otros sistemas.

Presentando django-initkit.

Para no hacer todo estas configuraciones cada vez que tengamos que iniciar un proyecto he creado django-initkit que es un proyecto simple que sobrecarga el comando startproject para hacer automáticamente todo lo que describí en este post. Para instalarlo puedes hacerlo desde Pypi (pip install django-initkit) o haciendo checkout desde github.

Su uso es igual a django-admin.py, nada más que el nombre del comando es django_initkit.py

Ejemplo:

django_initkit.py startproject foo

Espero que les haya gustado el post de hoy, pueden sugerir mas temas en los comentarios.

Para el primer movimiento empezaré con lo básico el inicio, no voy a realizar un tutorial de como iniciar en Django por que hay muchos ya en internet que son útiles pero debido a que muchas personas me preguntan cual es la mejor manera de iniciar con Django hago este post para guiarlos un poco sobre lo que las guías dan por hecho pero que nos pueden hacer perder algo de tiempo buscando por ahí.

Sinceramente no hay bala de plata para lograr cabalgar al pony sino por que el proceso de aprendizaje varía de quien en quien, lo que si puedo decir es que Django es uno de los proyectos mejor documentados que existen, casi todo el framework menos algunas funciones internas muy poco usadas están descritas en https://docs.djangoproject.com/ en la dirección anterior puedes navegar fácilmente todos los temas.

La documentación es muy buena pero no te servirá de nada si no tienes un conocimiento básico de Python lo bueno es que existen libros como este y tutoriales completos como este otro. Cosas a tener muy en cuenta para conocer en python primero:

1. Definición, uso y construcción de módulos en Python.
2. Definición y uso de funciones del tipo genérica, uso de parámetros *args y *kwargs.
3. Uso y construcción de expresiones regulares básicas.
4. Programación orientada a objetos y herencia de clases.
5. Como instalar paquetes de python desde PyPi.

Herramientas

<img src="{{video.url|youthumbnail: 's'}}"/>

Tiene dos parámetros de tamaño ‘s’ para un thumbnail pequeño y ‘l’ para un thumbnail grande.

Ver en DjangoSnippets

Para esto tenemos disponibles una gran cantidad de editores hechos en javascript libres y gratuitos disponibles en la red. En este caso usaremos mi preferido TinyMCE el cual es muy popular y es el editor por defecto de WordPress. Este editor funciona con los campos definidos como TextField

Paso 1: Bajar TinyMCE

Paso 2. En un proyecto de Django agregar la carpeta de TinyMCE a la locación donde guarden su javascript

Paso 3. Agregar el siguiente archivo para configurar el aspecto dentro de una carpeta llamada editores (o como quieran ponerle) en la misma ubicación del paso 2.
Paso 4. En el admin.py de la aplicación en la cual desean tener el editor hacer algo como esto: (ver comentarios)
Paso 5. Probarlo!!! y si hicieron todo bien sale asi:

Bajar projecto de Django de demostración