En este artículo instalaremos el framework MVC Django en Windows y veremos ejemplos de su uso tanto en forma standalone como bajo Eclipse

Damos por supuesto que tenemos ya instalado Python para Windows, en nuestro caso ya disponemos de una carpeta d:\Python25. Bajamos la versi&ocuate;n estable de Django desde http://www.djangoproject.com/download/1.1.1/tarball/ y seguimos los siguientes pasos:

  • Descomprimir (con winrar o 7zip el archivo Django-1.1.1.tar.gz
  • Entramos en el directorio Django-1.1.1
  • Ejecutamos el siguiente comando: python setup.py install

Esto nos instalará un directorio django dentro de d:\Python25\Lib\site-packages. Damos por supuesto que en el path tenemos definido d:\Python25. Luego de la instalación de Django, agregamos también a d:\Python25\Lib\site-packages\django. Esto sirve para poder ejecutar scripts específicos en python que usará dicho framework.

Para saber si todo lo anterior fué correcto ejecutamos desde la línea de comandos "python" :

D:\>python
Python 2.5.4 (r254:67916, Dec 23 2008, 15:10:54) [MSC v.1310 32 bit (Intel)] on
win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import django
>>> django.VERSION
(1, 1, 1, 'final', 0)
>>> exit()
D:\>

Django sobre Eclipse

Por una cuestión de comodidad crearemos nuestro proyecto django un nivel debajo de nuestro espacio de trabajo (workspace) en Eclipse. Por ejemplo, en mi caso el workspace está definido en d:\proyectos\eclipse (en realidad uso Netbeans, pero eso es otra historia). Abrimos una ventana de cmd, y hacemos:

  1. d:
  2. cd \proyectos\eclipse
  3. Ejecutamos el siguiente comando: python setup.py install
  4. django-admin.py startproject misitio

Esto nos genera la siguiente estructura de archivos dentro del directorio (creado por el script django-admin.py) d:\proyectos\eclipse\misitio:

  1. __init__.py: Este archivo le avisa al intérprete Python que este directorio debe ser considerado un paquete (package) Python
  2. manage.py: Script que nos permite interactuar con Django de distintas formas.
  3. settings.py: Archivo de configuración de nuestro proyecto.
  4. urls.py: Declaraciones de URLs a usar por nuestro proyecto django.

Es interesante el uso de manage.py. Si abrimos una ventana de cmd y ejecutamos python manage.py runserver, ya tendremos una simple aplicación funcionando, la que podremos ver abriendo con un navegador la dirección http://localhost:8000

Configuración de Pydev

Otro supuesto es que tenemos instalado Pydev. Luego hacer File + New + Pydev Project y se nos abrirá la ventana de Pydev Project.
Bajo Project Name escribir el nombre del directorio que creamos con django-admin.py startproject. Revisemos que en Projects content esté tildado el espacio de trabajo y que usemos la gramática 2.5. No hace falta usar la generación de la carpeta src.

Configuración de Run y Debug

Estos pasos son similares tanto para Run como para Debug. Ir a Run + Run Configurations... (o Run + Debug Configuration...) + Python Run. Click derecho y creamos una nueva configuración, por ejemplo el nombre del proyecto.

  1. En Project buscamos el directorio que creamos bajo el espacio de trabajo
  2. En Main Module debe decir ${workspace_loc:misitio/manage.py}
  3. En la solapa (x)= Arguments runserver --noreload 8000

Y ya estamos en condiciones de correr o depurar nuestro programa con Run o Debug

Proyectos y aplicaciones

En Django llamamos app a una aplicación Web que hace algo (un blog, un reporte de incidencias). Un project es una colección de aplicaciones y configuraciones para un sitio Web en particular, que puede contener varias apps, y a su vez una app puede ser usada por varios projects.