En este tutorial iremos desarrollando poco a poco una aplicación Django. Cada paso del tutorial explicará un nuevo concepto y en los ejercicios, el alumno aplicará los conceptos explicados para hacer su propia aplicación.
Tal y como se indica en la documentación podemos instalar Django a través de pip o a través de github. Lo más sencillo es hacerlo a través de pip:
$ sudo pip install Django
También es importante acostumbrarse a usar entornos virtuales para no tener problemas por incompatibilidades con distintas versiones de Python/Django.
Instala Django en un entorno virtual creado con virtualenv (si no tienes virtualenv instalado, usa pip para instalarlo). Ten en cuenta que una vez dentro del virtualenv no vas a tener que usar sudo para poder instalar Django.
Para ver la versión de Django que tenemos instalada ejecutamos el siguiente comando:
$ python -m django --version
Es importante destacar que este tutorial está pensado para Python 3. Por tanto, si la versión de Python por defecto en tu sistema operativo es Python2, tendrás que usar python3 en vez de python.
Una vez tengamos Django instalado en nuestro virtualenv pasamos a crear nuestro proyecto. Para ello, debemos usar el comando django-admin.
Busca en internet el uso del comando django-admin y crea tu proyecto Django en el entorno virtual en el que has instalado Django previamente.
Una vez tengamos nuestro proyecto creado, Django creará un directorio con los siguientes archivos
- manage.py: es un script que nos permite interactuar con nuestra aplicación Django. Puedes consultar más información sobre cómo usarlo en la documentación.
- Una carpeta con el nombre de tu aplicación: esta carpeta será el paquete Django correspondiente a nuestra aplicación. Suponiendo que nuestra aplicación se llama miapp, dentro tendremos:
- __miapp/init.py: Un fichero vacío que sólo sirve para que Python sepa que esta carpeta es un paquete Python.
- miapp/settings.py: Fichero con la configuración de nuestro proyecto Django. Tienes más información sobre la configuración de Django en la documentación.
- miapp/urls.py: Fichero que contiene expresiones regulares correspondientes a las distintas URLs de nuestra aplicación. Esto es algo que veremos más adelante en el tutorial pero que podéis consultar en la documentación.
- miapp/wsgi.py: Script python que contiene un pequeño servidor web para realizar pruebas. Este servidor sólo sirve para desarrollar y depurar nuestra aplicación y, para ponerla en producción debemos pasar a usar un servidor Apache, ngix, etc.
Para verificar que nuestra aplicación funciona, vamos a ejecutar el servidor de pruebas que nos facilita Django. Para ello, usamos el script manage.py.
¿Qué parámetros hay que pasarle al script manage.py para poder ejecutar el servidor de Django? ¿Y si quieres ejecutar el servidor en un puerto específico? Pista: todo está en la documentación.
Una vez hayamos ejecutado el servidor, tenemos que abrir la URL que nos indica en consola y veremos un mensaje indicándonos que todo ha funcionado correctamente.
Hasta ahora, lo único que hemos hecho ha sido crear un proyecto Django. Ahora vamos a pasar a crear una aplicación. ¿Cuál es la diferencia entre una aplicación y un proyecto? Una aplicación es un módulo que hace algo (por ejemplo, una base de datos, un formulario, etc) y un proyecto es un conjunto de aplicaciones con una configuración concreta para una web en particular. Una app puede estar en varios proyectos y un proyecto puede tener varias apps.
Las apps se suelen hacer de forma modular, para que puedan ser reusables. Aunque no hay nada definido en cuanto a cómo dividir un proyecto en apps, hay discusiones sobre el tema en la red.
Crea una aplicación para tu proyecto Django. ¿Qué parámetros hay que pasarle al script manage.py para ello?
El fichero settings.py de nuestro proyecto tiene todos los parámetros de configuración de nuestro proyecto. Por ejemplo, incluye el gestor de base de datos que Django usará en nuestra aplicación. Por defecto es SQLite3 pero si vas a hacer un proyecto más serio, se recomienda usar otro cliente. En la documentación encontrarás información sobre cómo instalar una base de datos.
Modifica el fichero settings.py con la configuración que necesites para tu proyecto. Consulta la documentación para saber los valores que puede tomar cada parámetro de la configuración.
En la configuración, podemos añadir las aplicaciones que queramos usar en nuestro proyecto. Por defecto, Django incluye unas cuantas. Algunas de estas aplicaciones usan la base de datos, por lo que debemos crear las tablas en la misma antes de poder usarlas. Para hacer esto, se utilizan las denominadas migrations.
¿Cómo se ejecuta una migración en Django? Ejecuta una para poder crear las tablas necesarias para las aplicaciones de nuestro proyecto.
Imagina que tu aplicación es un blog en el cual los post pueden recibir comentarios de cualquier usuario. En este caso, tendríamos dos elementos principales: un post y un comentario. Estas entidades se representan en Django en forma de modelos. Django nos ofrece la facilidad de definir nuestros modelos como si fuesen objetos Python, es decir, mediante clases. Esto es posible debido a que implementa un Object-Relational Mapping, una técnica que permite crear tablas de entidad-relación a partir de objetos.
Para definir los modelos de una aplicación usamos el fichero models.py de nuestra aplicación.
Define los modelos necesarios para tu aplicación y aplica una migración a la base de datos. Recuerda que antes de hacer la migración debes añadir la aplicación que creaste a las aplicaciones instaladas del proyecto en el fichero settings.py y que antes de hacer la migración sobre el proyecto, debes usar el comando makemigrations sobre la aplicación.
Ejecutando el siguiente comando, podrás entrar a un shell interactivo de Django:
$ python manage.py shell
En la shell de Django, importa los modelos que has creado en el paso anterior y crea varias instancias de las clases modelo. Usa la función save() para guardar estos objetos en la base de datos. ¿Cómo podríamos automatizar esta tarea con un script?
Añade un método __str__() a tus modelos para poder imprimir información sobre los mismos en el shell de Django. Consulta en la documentación qué más métodos puedes crear en los modelos.
En la documentación nos explican cómo hacer búsquedas en la base de datos. Prueba a hacer diferentes búsquedas usando las funciones get y filter.
Una de las aplicaciones instaladas que Django incluye por defecto en los proyectos es django.contrib.admin. Esta aplicación nos proporciona un panel de control web de nuestra base de datos. Nos permite añadir y eliminar objetos, entre otras cosas.
Pero para poder acceder al panel de administración, primero debemos crear un superusuario. Esto se hace usando el script python manage.py.
Dentro del panel de administración tendremos modelos ya creados: Groups y Users. Estos modelos son creados por otra de las aplicaciones por defecto de Django: django.contrib.auth.
Crea un super usuario y accede al panel de administración de Django. Recuerda que el panel de administración está en la URL /admin/.
¿Dónde están los modelos que has creado en tu aplicación? Debes añadirlos al panel de administración en el script admin.py de tu aplicación. Para ello, debes usar la función admin.site.register(<modelo>), donde <modelo> es el modelo que quieres registrar en el panel de administración (recuerda, por tanto, importar tus modelos en el script admin.py).
Django sigue una arquitectura similar al tradicional MVC, pero con algunas peculiaridades que lo hacen más fácil de modularizar, para poder reutilizar sus componentes más fácilmente. Esta arquitectura, se denomina MVT (model, view, template). En comparación con el MVC original, los views corresponderían con los controladores, y las plantillas con las vistas.
Los views, son funciones (aunque también se pueden construir con clases) encargadas de convertir un HttpRequest (petición web) en un HttpResponse (respuesta web). Para orquestar este funcionamiento, es necesario un listado de "urls" para que el dispatcher sepa qué función debe aplicar a cada petición, según la URL que esta contenga.
Además de construir una respuesta, cada view puede tener efectos colaterales sobre el sistema, como por ejemplo, la creación de nuevos objetos en la BD o la modificación de objetos ya existentes. En cualquier caso, los views siempre devolverán una respuesta HTTP. Esta no tiene por qué ser un fichero HTML, sino cualquier tipo de fichero (CSS, JS, JSON, XML...).
Por ejemplo, si quisiéramos hacer una vista para imprimir el contenido de una entrada de blog concreta usaríamos la siguiente vista:
from django.http import HttpResponse
from .models import BlogEntry
def entrada(request, id):
texto = BlogEntry.objects.get(entry_id=id)
return HttpResponse(texto)Modifica el ejemplo anterior usando los shortcuts de Django: render y get_object_or_404.
Crea una vista para tu proyecto, lanzando un error 404 si no existe el contenido solicitado.
Una vez hemos definido las diferentes vistas de nuestra aplicación, vamos a hacer una plantilla HTML. Estas plantillas son ficheros HTML normales que colocan llamadas a las vistas con una sintaxis especial. Para ver ejemplos de plantillas Django puedes consultar la documentación. También es importante que consultes las etiquetas y filtros que Django incorpora en las plantillas.
Para definir una plantilla, en primer lugar debemos crear un nuevo directorio llamado templates dentro de nuestra aplicación y, dentro del directorio templates debemos crear otro directorio con el nombre de nuestra aplicación. Dentro de este último directorio se encontrará nuestra plantilla HTML. Por tanto, siguiendo con el ejemplo del blog, tendríamos la siguiente estructura de directorios:
blog
|___ templates
|___ blog
|__ index.html
El parámetro TEMPLATES del settings.py de nuestro proyecto describe cómo Django busca y carga los templates. Por defecto, la opción APP_DIRS es verdadera, lo que significa que Django buscará plantillas en el directorio templates de cada aplicación instalada. Debido a este funcionamiento, podemos referinos a nuestro index.html simplemente como blog/index.html en Django.
¿Por qué es necesario crear un directorio con el nombre de la aplicación dentro del directorio templates? Es debido al Template namespacing. Si tenemos dos aplicaciones instaladas y ambas tienen una plantilla con el mismo nombre, Django no sabrá distinguir cuál es cuál y, por tanto, cogerá el primer template que encuentre. Para poder distinguir los templates entre aplicaciones, lo más sencillo es colocar los templates de cada aplicación dentro de un directorio con el nombre de la aplicación.
Define una plantilla index.html básica para tu proyecto usando elementos del Django Template System. Pon los enlaces usando la etiqueta url.
¿Cómo sabe Django cuando un navegador solicita un determinado contenido? Usando la URLconf. Cada vista necesita tener asociada una URL para poder ejecutarse.
Las URLs se definen en el archivo urls.py de nuestra aplicación dentro de una lista llamada urlpatterns.
Para definir una URL se utiliza la función url que toma como parámetros una expresión regular que define la URL y la vista para la cual estamos definiendo la URL. Como parámetros opcionales tenemos kwargs para pasar parámetros extra y name para darle un nombre a la URL.
¿Recuerdas que el panel de administración de administración estaba en la URL /admin/? Esto es debido a que su URL se ha definido de la siguiente forma:
url(r'^admin/', admin.site.urls)Las expresiones regulares que usamos para definir URLs no deben de ser muy complicadas, todo lo contrario, debemos intentar que sean lo más simple posibles. Las reglas para expresar patrones más básicas son:
^para empezar un texto.$para finalizar un texto.\dpara los dígitos.+para indicar que el item que precede el símbolo+se repetirá más de una vez. Por ejemplo, la expresión regular^(\d+)nos indica que hay uno o más dígitos.()para encapsular parte del patrón.
Volviendo al ejemplo del blog, podríamos definir la URL de un blog de la siguiente forma
url(r'^post/(\d+)/$', views.post)Así, cada post tendría asociado un número y para acceder a ellos, sólo tendríamos que usar una URL con dicho número.
Define las URLs de las vistas que has definido en tu aplicación en el fichero urls.py de tu aplicación. Después, incluye las URLs de tu aplicación en el fichero urls.py de tu proyecto usando la función include.
Te habrás dado cuenta que para incluir las URLs de la aplicación admin no ha sido necesario usar la función include. Esta es la única excepción, siempre que quieras referencias otros URLconfs debes usar esta función.
En este taller has aprendido a hacer lo básico con Django, pero aún queda mucho más por hacer. Te dejamos una serie de enlaces interesantes para que puedas seguir ampliando tus conocimientos: