Django desde cero

Django es un framework web de tercera generación, de código abierto, escrito en Python, lo que hace que sea mucho más poderoso que otros frameworks escritos en PHP o JSP. Algunos de los superpoderes de Django son:

- Agilidad.
- Dinamismo.
- Interacción directa con la consola.
- Levantar servicios.

Para descubrir los más oscuros secretos de Django puedes recurrir a su guarida secreta, en dónde te explicarán en detalle este mágico framework.

Las capas de un framework 

El manejo de las capas permite que  puedas separar la lógica de la app de forma más estructurada. Te mostramos cómo debes usar cada una:

Web App: será tu principal zona de trabajo, la esencia de la aplicación.
Framework: te da conectividad con el mundo real (API).
MVC: modelo vista controlador (en Django se utiliza MTV <<Modelo Vista Template>>, una adaptación de MVC).
Persistencia: comunicación a una base de datos relacional.
Manejo de Request: GET - POST.

Flujo de trabajo de Django (arquitectura)

* Web Client: es el navegador (FireFox - Chrome - Opera) → se conecta al web server → el server se Conecta a Django → controladores : vistas → modelo. Cuando ese proceso termina pintas la vista que renderiza a texto html, para luego ser interpretado por los navegadores (HTML - Javascript).

* Server: puede ser Apache, pero es recomendable usar Nginx o Celery.

En detalle:



URLS.py →  le dice al Web client a qué rutas va a escuchar y qué vistas (Views.py) va a ejecutar.

En su caso se pueden utilizar modelos (Models.py).  Finalmente, se conectan a un template que se regresa al web client.

¿Cómo iniciar tu proyecto?

Para arrancar con tu proyecto ejecutas en terminal o cmd:

$ django-admin.py startproject _NombreDeTuProyecto_

Si tienes problemas en Windows puedes usar:

$ C:\Python27\Scripts\django-admin.py startproject _NombreDeTuProyecto_

Estos comandos te generan una carpeta en el lugar desde donde ejecutes la línea con la siguiente estructura:



A diferencia de otros frameworks Django es súper minimalista porque encapsula todo lo que necesita en estos pocos archivos .py.

Configuraciones generales

* manage.py  es tu brazo derecho, es el que te permite ejecutar líneas de comando. Si ejecutas python manage.py en la consola podrás descubrir los múltiples comandos que tiene. Dentro de ellos está el cambio de contraseña del súper usuario, administrar la base de datos,  crear aplicaciones, entre otros.

* wsgi.py es la configuración que se utiliza para conectarnos al sistema en producción (Apache - nginx).

* Para activar tus superpoderes usas en la consola el comando RUNSERVER + el archivo manage.py:

$ python manage.py runserver

Así levantas el servidor en la ruta http://127.0.0.1:8000/ o http://localhost:8000.

Aparecerá un mensaje diciendo: It Works!. Después desde la consola puedes supervisar todo lo que pasa con tu servidor.

Configuración de Django: settings.py

Defines cómo va a funcionar tu proyecto (configuración del servidor, aplicaciones, lenguaje, etc.) en el archivo settings.py. Este viene por defecto con una configuración básica (lo mínimo que necesitas y hasta más) para que funcione tu app Django, pero le puedes agregar lo que quieras para que tus poderes se ajusten a lo que necesitas.

* ADMINS: administradores del servidor a los que les mandan correos si tienes algún problema.

* DATABASES: configuración a la conexión con el motor de base de datos.

* ALLOWED_HOSTS: cuáles hosts tienen permitido acceder al sitio o tener solicitudes.

* LANGUAGE_CODE: el lenguaje en el cual está hecho Django. Django está traducido a muchos lenguajes, en esta variable lo puedes cambiar.

* USE_L10N: te sirve para manejar el formato calendario (dates).

* MEDIA_ROOT: acá almacenas toda la información que generó el usuario.

* STATIC_ROOT: acá pones las rutas de los archivos estáticos que pueden estar enlazados a los templates como archivos de formato CSS, Javascript, imágenes, etc.

* SECRET_KEY: es la llave que utilizas para codificar (hashear) las contraseñas o sesiones (no compartir con nadie).

* INSTALLED_APPS: aquí instalas las aplicaciones de tu proyecto, tanto las que has estado creando como los paquetes externos que necesitas.

Nota: existen múltiples paquetes que pueden resolver el mismo problema pero está en ti decidir cuál usar, depende de lo que necesites y con cuál te sientes cómodo.

En https://pypi.python.org/pypi y https://www.djangopackages.com/ tienes un directorio de paquetes que puedes usar en tus proyectos.

Aplicaciones en Django

Las aplicaciones son carpetas con código (módulos) que alimentan tu proyecto. Estas aplicaciones pueden ser empacadas y distribuidas para que las uses en otros proyectos.

* Para crear una aplicación en el proyecto debes ir al directorio del proyecto y ejecutar:
 

$ python manage.py startapp _NombreDeLaApp_

Esto te crea una nueva carpeta dentro de tu proyecto con tres archivos .py que son los que manejan las funcionalidades de la app.

* Al crear tu app debes instalarla en INSTALLED_APPS de settings.py:

INSTALLED_APPS = (
   ‘_NombreDeLaApp_’,
)

URLs - Vistas

Las urls son las que reciben las peticiones del web client y se resuelven con expresiones regulares. Estas urls apuntan a vistas en las que se define el comportamiento de la aplicación.

¿Cómo puedes crear una url? →  en el archivo urls.py dentro de urlpatterns.

Ejemplo:

    url(r'^$', 'app.views.home', name='home')

r'^$' es la raíz del sitio que llama a app.views.home, que es la vista que define el comportamiento de esa ruta (como enviar un template .html). Luego en name pones el nombre de la url, en este caso home.

Las urls pueden recibir parámetros en forma de expresiones regulares

Ejemplo:

    url(r'^post/(\d+)$', 'app.views.post', name='post')

En este caso la url recibe un dígito → \d+

Las views siempre reciben un HttpRequest y devuelven un objeto HttpResponse. Para usar HttpResponse en views.py debes importar HttpResponse:
 

>>> from django.http import HttpResponse

Ejemplo:

>>> def home(request):   
…   return HttpResponse("Hola Mundo este es el Home")

request es el HttpRequest y home devuelve como HttpResponse "Hola Mundo este es el home".

Las vistas pueden recibir múltiples parámetros, estos llegan en forma de un string (así se manden como un dígito).

Ejemplo:

>>> def post(request,id_post):
…     if int(id_post) > 10 :
…         return HttpResponse("Este es mayor que 10 : %s" % id_post)
…     else:
…         return HttpResponse("Este es menor que 10 : %s" % id_post)

Dado que las vistas son funciones pueden tener adentro lo que tu quieras como en este caso en el que estás usando estructuras de control if - else para analizar el parámetro id_post que mandaste en la url.