Ver el código de «Curso Python DGA 2011/django/slides»

{{#widget:Slides}} 
<div class="slides layout-regular template-default">
<div class="slide">
= Introducción a Django =
==El framework para los exigentes con los plazos de entrega==
Luis Miguel Morillas &lt;lmorillas at xml3k.org&gt; 
identi.ca: lmorillas 
</div><div class="slide">
=== Evolución del desarrollo web ===
# Páginas HTML estáticas
# CGI:  código para generar páginas web dinámicas:
# Código embebido en páginas web (PHP, JSP, ASP, ...) 
# Frameworks web:
#* RoR, Struts, Symphony
#* Django, Pylons, Web2Py

</div><div class="slide">
=== Django ===
Django permite a los desarrolladores:
* crear de forma rápida sitios web de altas prestaciones 
* basados en información almacenada en bases de datos 
* bajo el principio de no repetición (Do Not Repeat Yourself: DRY).

* Adrian Holovaty, co-creador de Django, es un guitarrista inspirado por Django Reinhardt.

</div><div class="slide">
=== MVC / MVT ===
MTV: Desarrollo web según un patrón Modelo - Vista - Template (similar al patrón MVC)
* Modelo: capa de Datos. Describe los datos que gestiona la aplicación. Cada modelo enlaza una tabla en la base de datos.
* Vista: capa de Negocio. Describe a qué datos hay que acceder y los transforma.
* Template (plantillas): capa de Presentación. Describe cómo se van a presentar los datos al usuario.

</div><div class="slide">
=== Instalación ===
* https://docs.djangoproject.com/en/1.3/intro/install/

* Comprobamos que está instalado (y la versión)
<source lang="python">
>>> import django
>>> django.VERSION
(1, 3, 0, 'final', 0)
</source>

</div><div class="slide">
=== Creación de un proyecto ===
<source lang="python">
$ django-admin.py startproject sitio_encuestas
$ ls -l
sitio_encuestas/
    __init__.py
    manage.py
    settings.py
    urls.py
</source>
</div><div class="slide">
=== Creación de un proyecto (cont.) ===
Un proyecto en Django son '''4 ficheros''':
;__init__.py
: Indica que se trata de un paquete.
;manage.py
: Programa de gestión de django. A partir de ahora será el que usemos para interactuar con el proyecto.
;settings.py
: Fichero de configuración del proyecto.
;urls.py
: Gestiona la tabla de urls a las que responde el proyecto.

</div><div class="slide">
=== Servidor web de desarrollo ===
El proyecto incorpora un servidor web: 
<source lang="bash">
$ cd sitio_encuestas
$ python manage.py runserver
Validating models...

0 errors found
Django version 1.3, using settings 'sitio_encuestas.settings'
Development server is running at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
</source>
</div><div class="slide">
=== Servidor web de desarrollo ===
Comprobamos la dirección con el navegador o 
<source lang="bash">
$ curl -I  127.0.0.1:8000
HTTP/1.0 200 OK
Date: Mon, 22 Aug 2011 20:33:33 GMT
Server: WSGIServer/0.1 Python/2.7.1+
Content-Type: text/html
</source>
</div><div class="slide">
=== Servidor web de desarrollo (cont.)===
{{Tip| Podemos cambiar el puerto ejecutando:
  $ python manage.py runserver 8080
y También la ip:
  $ python manage.py runserver 0.0.0.0:8000
}}
* No está pensado para sitios en producción.
* Django en producción: https://docs.djangoproject.com/en/1.3/howto/deployment/
</div><div class="slide">
=== Configuración del proyecto ===
* Editar '''settings.py'''
* La configuración necesita rutas absolutas --> truco
<source lang="python">
import os
def ruta_abs(x):
    return os.path.join(os.path.abspath(os.path.dirname(__file__)), x)
</source>

</div><div class="slide">
=== Configuración de la base de datos===
Por defecto, tiene sopote para Postgresql, MySQL, Sqlite y Oracle.
<source lang="python">
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
        'NAME': '',                      # Or path to database file if using sqlite3.
        'USER': '',                      # Not used with sqlite3.
        'PASSWORD': '',                  # Not used with sqlite3.
        'HOST': '',                      # Set to empty string for localhost. Not used with sqlite3.
        'PORT': '',                      # Set to empty string for default. Not used with sqlite3.
    }
}
</source>
</div><div class="slide">
=== Configuración de la base de datos (cont.)===
Para usar sqlite:
<source lang="python">
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
        'NAME': ruta_abs('encuestas.db'),                      # Or path to database file if using sqlite3.
    }
}
</source>
Para usar otra base de datos: servidor, usuario y base de datos.
</div><div class="slide">
===configuración regional===
<source lang="python">
TIME_ZONE = 'Europe/Madrid'
LANGUAGE_CODE = 'es-es'
</source>

</div><div class="slide">
=== Aplicar los cambios ===
<source lang="python">
$python manage.py syncdb
</source>
Crea las tablas necesarias para el desarrollo de proyecto, incluyendo todas las aplicaciones incuidas en INSTALLED_APPS

</div><div class="slide">
===Proyectos y aplicaciones===
* optimizar los recursos
* un proyecto puede tener varias aplicaciones
* las aplicaciones se pueden instalar en varios proyectos. 
* Por eso se dice que las aplicaciones de django son '''"pluglables"'''.

</div><div class="slide">
=== Creación de una aplicación===
<source lang="python">
$ python manage.py startapp encuestas
</source>
Esto creará el siguiente directorio:
<source lang="bash">
encuestas/
    __init__.py
    models.py
    views.py
</source>
</div><div class="slide">
=== Incluir la aplicación en el proyecto ===
Hay que añadir la nueva apliación a '''INSTALLED_APPS''' dentro de '''settings.py'''
<source lang="python">
INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.messages',
    'sitio_encuestas.encuestas',
)
</source>

</div><div class="slide">
=== Definición de modelos===
'''models.py'''
<source lang="python">
from django.db import models
 
class Encuesta(models.Model):
    pregunta = models.CharField(max_length=200)
    fecha_pub = models.DateTimeField(u'fecha de publicación')
 
    def __unicode__(self):
        return self.pregunta
</source>
</div><div class="slide">
=== Definición de modelos (cont.)=== 
<source lang="python">
class Opcion(models.Model):
    encuesta = models.ForeignKey(Encuesta)
    opcion = models.CharField(max_length=200)    
    votos = models.IntegerField()
 
    def __unicode__(self):
        return self.opcion
</source>

* Tipos de datos: https://docs.djangoproject.com/en/1.3/ref/models/fields/
* Más opciones

</div><div class="slide">
=== Ver sql ===
<source lang="python">
$ python manage.py sql encuestas
</source>

<source lang="sql">
BEGIN;
CREATE TABLE "encuestas_encuesta" (
    "id" integer NOT NULL PRIMARY KEY,
    "pregunta" varchar(200) NOT NULL,
    "fecha_pub" datetime NOT NULL
)
;
CREATE TABLE "encuestas_opcion" (
    "id" integer NOT NULL PRIMARY KEY,
    "encuesta_id" integer NOT NULL REFERENCES "encuestas_encuesta" ("id"),
    "opcion" varchar(200) NOT NULL,
    "votos" integer NOT NULL
)
;
COMMIT;
</source>
</div><div class="slide">
=== Syncdb ===
<source lang="bash">
$ python manage.py syncdb
Creating table encuestas_encuesta
Creating table encuestas_opcion

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no): yes
Username (Leave blank to use 'lm'): lm
E-mail address: lm@micorreo.com
Password: 
Password (again): 
Superuser created successfully.
Installing custom SQL ...
Installing indexes ...
No fixtures found.
</source>
Si las tablas tienen datos, ya no modificará la estructura. Soluciones: eliminar los datos de esa aplicación o usar South: http://south.aeracode.org/

</div><div class="slide">
=== Acceso a los datos ===
<source lang="python">
$ python manage.py shell
</source>

<source lang="python">
>>> from encuestas.models import Encuesta, Pregunta # Importa las clases del modelo

# No hay encuestas
>>> Encuesta.objects.all()
[]
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
<source lang="python">
# Creamos una nueva encuesta
>>> import datetime
>>> p = Encuesta(pregunta="¿Cómo va el curso?", fecha_pub=datetime.datetime.now())

# Guardamos el objeto en la base de datos
>>> p.save()

# Creación de ID automática
>>> p.id
1

# Acceso a los valores
>>> p.pregunta
"¿Cómo va el curso?"
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
<source lang="python">
>>> p.fecha_pub
datetime.datetime(2011, 7, 15, 12, 00, 53)

# Cambio de valores de los atributos
>>> p.pub_date = datetime.datetime(2011, 7, 20, 0, 0)
>>> p.save()

# objects.all() muestra todas las encuestas de la base de datos
>>> Encuesta.objects.all()
[<Encuesta: ¿Cómo va el curso?]
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
* método '''__unicode__'''. 
* Si no, veríamos '''<Encuesta: Encuesta object>'''
* Se crea el método __unicode__ y no __str__ porque los modelos de Django tratan con unicode por defecto.
</div><div class="slide">
=== Acceso a los datos (cont.)===
<source lang="python">
# API de búsquedas de Django
>>> Encuesta.objects.filter(id=1)
[<Encuesta: ¿Cómo va el curso?>]
>>> Encuesta.objects.filter(pregunta__startswith='¿Cómo')
[<Encuesta: ¿Cómo va el curso?>]

# Obtener las encuestas de 2011
>>> Encuesta.objects.get(fecha_pub__year=2011)
<Encuesta: ¿Cómo va el curso?>
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
<source lang="python">
>>> Encuesta.objects.get(id=2)
Traceback (most recent call last):
    ...
DoesNotExist: Encuesta matching query does not exist.

# Búsqueda por clave primaria
>>> Encuesta.objects.get(pk=1)
<Encuesta: ¿Cómo va el curso?>

# Vamos a insertar unas opciones para ver cómo funcionan las relaciones.
# Podemos crear las opciones desde la misma encuesta:

>>> p = Encuesta.objects.get(pk=1)
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
<source lang="python">
# Opciones relacionadas con nuestra encuesta:
>>> p.opcion_set.all()
[]

# Creamos tres opciones
>>> p.opcion_set.create(opcion='Muy bien', votos=0)
<Opcion: Muy bien>
>>> p.opcion_set.create(opcion='Bien', votos=0)
<Opcion: Bien>
>>> c = p.opcion_set.create(opcion='Regular', votos=0)

# Los objetos Opción tienen acceso desde la API a la encuesta a la que pertenecen:
>>> c.encuesta
<Encuesta: ¿Cómo va el curso?>
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
<source lang="python">
# Y viceversa. Los objetos Encuesta acceden a sus Opciones: 
>>> p.opcion_set.all()
[<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]
>>> p.opcion_set.count()
3

# La API sigue de forma automática las relaciones.
# Para separar las relaciones se usan dobles guiones bajos.
# Busca todas las Opciones para cualquier encuesta publicada en 2011
>>> Opcion.objects.filter(encuesta__fecha_pub__year=2011)
[<Opcion: Muy bien>, <Opcion: Bien>, <Opcion: Regular>]

# Elimina una de las opciones: 
>>> c = p.opcion_set.filter(opcion__startswith='Regular')
>>> c.delete()
</source>

</div><div class="slide">
=== Otros métodos en los modelos ===
Podemos añadir métodos normales a los modelos:
<source lang="python">
import datetime
class Encuesta(models.Model):
    #...
    def publicada_hoy(self):
        return self.fecha_pub.date() === datetime.date.today()
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
Y podemos usarlos así:
<source lang="python">
>>> p = Escuesta.objects.get(pk=1)
>>> p.publicada_hoy()
False
</source>
</div><div class="slide">
=== Acceso a los datos (cont.)===
* relaciones entre modelos: https://docs.djangoproject.com/en/1.3/ref/models/relations
* dobles guiones bajos para hacer búsquedas por campos mediante la API: http://docs.djangoproject.com/en/1.3/topics/db/queries/#field-lookups
* API de la base de datos: https://docs.djangoproject.com/en/1.3/topics/db/queries/
</div><div class="slide">
=== El poderoso Admin de Django ===
* El Admin es una herramienta pensada para el "backend"
* no para el acceso de los usuarios
* Simplifica la tarea de insertar, modificar y eliminar contenido de la web.
</div><div class="slide">
=== Activar el Admin ===
* Por defecto está desactivado.
* Añade '''django.contrib.admin''' a la lista de '''INSTALLED_APPS''' en  '''settings.py'''.
* Ejecuta
 $ python manage.py syncdb
* Siempre que añadimos una nueva aplicación hay que actualizar la base de datos
</div><div class="slide">
=== Activar el Admin (cont.)===
Archivo: urls.py
<source lang="python" line="GESHI_FANCY_LINE_NUMBERS" highlight="4, 5, 16">
from django.conf.urls.defaults import patterns, include, url

# Uncomment the next two lines to enable the admin:
from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    # Examples:
    # url(r'^$', 'sitio_encuestas.views.home', name='home'),
    # url(r'^sitio_encuestas/', include('sitio_encuestas.foo.urls')),

    # Uncomment the admin/doc line below to enable admin documentation:
    # url(r'^admin/doc/', include('django.contrib.admindocs.urls')),

    # Uncomment the next line to enable the admin:
    url(r'^admin/', include(admin.site.urls)),
)
</source>

</div><div class="slide">
=== Lanzar Admin ===
 $ python manage.py runserver

navegador: '''http://127.0.0.1:8000/admin/'''
<source lang="bash">
$ curl http://127.0.0.1:8000/admin/ -I
HTTP/1.0 200 OK
Date: Tue, 23 Aug 2011 15:33:25 GMT
Server: WSGIServer/0.1 Python/2.7.1+
Last-Modified: Tue, 23 Aug 2011 15:33:25 GMT
Expires: Tue, 23 Aug 2011 15:33:25 GMT
Content-Type: text/html; charset=utf-8
Vary: Cookie
Cache-Control: max-age=0
Set-Cookie:  csrftoken=b53bd036b15251d45ed07b15c60e5116; expires=Tue, 21-Aug-2012 15:33:25 GMT; Max-Age=31449600; Path=/
Set-Cookie:  sessionid=2d639f8c86e4e380698c1991fec9d848; expires=Tue, 06-Sep-2011 15:33:25 GMT; Max-Age=1209600; Path=/
</source>

</div><div class="slide">
=== Usuarios ===
Tendrás que entrar con el '''superurser''' que creaste la hacer '''syncdb'''. 
Si no recuerdas, puedes crear otro superusuario:
 $ python manage.py createsuperuser

</div><div class="slide">
===Hacer el proyecto modificable por el Admin===
La aplicación Encuestas no aparece. Hay que activarla dentro del admin:

* Crea un fichero '''admin.py''':
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from encuestas.models import Encuesta
from django.contrib import admin

admin.site.register(Encuesta)
</source>
</div><div class="slide">
===Hacer el proyecto modificable por el Admin (cont.)===
* Reinicia el servidor de desarrollo. El servidor no detecta la creación de un nuevo archivo.

Se ha creado un completo entorno [http://es.wikipedia.org/wiki/CRUD CRUD] para nuestras encuestas:
* Se genera un formulario automático para el modelo
* Incluye validación de campos

</div><div class="slide">
=== Configuración del formulario ===
La configuración se hace mediante el archivo '''admin.py''' creado. 
* Preparamos una clase especial para las encuestas ('''EncuestaAdmin''')
* Indicamos a admin que use esa clase para gestionar nuestro modelo
 admin.site.register(Encuesta, EncuestaAdmin)
</div><div class="slide">
===Fieldsets===
Vamos a cambiar el orden en que aparecen los datos:

<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from encuestas.models import Encuesta
from django.contrib import admin

class EncuestaAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['pregunta']}),
        ('Publicación', {'fields': ['fecha_pub']}),
    ]

admin.site.register(Encuesta, EncuestaAdmin)
</source>
</div><div class="slide">
===Classes: collapse===
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
class PollAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['question']}),
        ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),
    ]
</source>
</div><div class="slide">
=== Añadir objetos relacionados ===
Tenemos dos opciones:
* Registrar Opcion con el admin como hemos hecho con las Encuestas
 from polls.models import Choice 
 admin.site.register(Choice)
: '''<select> box''' para la clave foránea
</div><div class="slide">
=== Añadir objetos relacionados: inlines ===
* Podemos crear las Opciones desde la misma encuesta. 
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from encuestas.models import Encuesta, Opcion
from django.contrib import admin

class OpcionInline(admin.TabularInline):
    model = Opcion
    extra = 3

class EncuestaAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['pregunta']}),
        ('Publicación', {'fields': ['fecha_pub'], 'classes': ['collapse']}),
    ]
    inlines = [OpcionInline]

admin.site.register(Encuesta, EncuestaAdmin)
</source>
</div><div class="slide">
=== Añadir objetos relacionados: inlines ===
Con el inline indicamos a Django:
* que los objetos Opcion se editan en la página de administración de Encuestas
* que por defecto añade los campos suficientes para añadir 3 Opciones más.

Admin ofrece dos tipos de inlines: StackedInline y TabularInline.

</div><div class="slide">
=== Modificar la página de listados ===
* Por defecto Django muestra el str() de cada objeto. 
* más usable mostrar campos individuales. 
* '''list_display''':tupla de nombres de campos (y +)

<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
class EncuestaAdmin(admin.ModelAdmin):
    # ...
    list_display = ('pregunta', 'fecha_pub', 'publicada_hoy')
</source>
</div><div class="slide">
=== Listados (cont.) ===
Podemos especificar el nombre de la columna:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
    def publicada_hoy(self):
        return self.fecha_pub.date() === datetime.date.today()
    publicada_hoy.short_description = '¿Publicada hoy?'
</source>
</div><div class="slide">
=== Filtros ===
Añade a EncuestaAdmin
 list_filter = ['fecha_pub']

Añade una columna de '''filtro'''

</div><div class="slide">
=== Búsqueda ===
 search_fields = ['pregunta']
* Añade una caja de búsqueda en la parte superior de los listados. 
* Usa '''LIKE''' en las búsquedas.
</div><div class="slide">
=== Fechas ===
Como las encuestas tienen un campo con fechas podemos facilitar la navegación cronológica:
 date_hierarchy = 'fecha_pub'

</div><div class="slide">
=== Paginación ===
  list_per_page = 100

</div><div class="slide">
=== Personalizar la presentación ===
* No tiene sentido ver '''"Django administration"''' en la parte superior de las páginas.
Es fácil cambiar usando el sistema de plantillas de Django:
* Configura TEMPLATE_DIRS (tupla de rutas donde busca plantillas Django) en el fichero '''settings.py'''. 
  TEMPLATE_DIRS = (
      "/home/my_username/mytemplates", # configura la ruta: rutas absolutas.
  )
</div><div class="slide">
=== Personalizar la presentación (cont.) ===
* Copia la plantilla '''admin/base_site.html''' 
* del directorio de plantillas de Django''(django/contrib/admin/templates)''' 
* a un directorio '''admin''' dentro de una de las rutas de tus templates.
* Edita la plantilla. 
</div><div class="slide">
=== Configurar la página índice===
* Por defecto aparecen todas las aplicaciones de INSTALLED_APPS por orden alfabético. 
* Para eso hay que cambiar la plantilla '''admin/index.html'''. 
* En lugar de usar la variable '''app_list''', puedes forzar las aplicaciones como quieras.
</div><div class="slide">
=== Creación de la interfaz pública ===
'''Una vista es un tipo de página web que sirve para una función específica y tiene una plantilla específica.'''
Por ejemplo en un blog podemos tener:
* La página inicial del Blog (muestra las últimas entradas)
* El detalle de una entada
* Página de las entradas por ffechas (día, mes, año) 
* Comentarios
</div><div class="slide">
=== Creación de la interfaz pública (cont.) ===
En la aplicación de las encuestas:
* Página índice de Encuestas, que muestre las últimas encuestas
* Página de detalle de encuestas: Muestra una pregunta con el formulario para votar
* Página de resultados de una encuesta.

</div><div class="slide">
=== Diseño de URLs===
* El primer paso para escribir una vista es diseñar la estructura de la URL. 
* Django asocia una URL con código Python mediante el módulo URLconf.
* Las urls se controlan con la variable urlpatterns, 
* que es una secuencia de tuplas con el siguiente formato:
 (expresión regular, function python [, diccionario opcional])
* Django busca por orden y lanza la primera función que cumple el patrón. 
* Cuando Django la encuentra, llama a la función Python con un objeto '''HttpRequest''' como primer argumento, valores capturados de la url como argumentos por clave y otros argumentos opcionales (tercer elemento de la tupla)
</div><div class="slide">
=== Diseño de URLs (cont.)===
* URLconf por defecto en '''urls.py''' 
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.conf.urls.defaults import patterns, include, url

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    (r'^encuestas/$', 'encuestas.views.index'),
    (r'^encuestas/(?P<encuesta_id>\d+)/$', 'encuestas.views.detalle'),
    (r'^encuestas/(?P<encuesta_id>\d+)/resultado/$', 'encuestas.views.resultado'),
    (r'^encuestas/(?P<encuesta_id>\d+)/votar/$', 'encuestas.views.votar'),
    url(r'^admin/', include(admin.site.urls)),
)
</source>
</div><div class="slide">
=== Diseño de URLs (cont.)===
Según nuestro ejemplo si el usuario pide
 /encuestas/23

Django ejecutará 
 detalle((request=<HttpRequest object>, encuesta_id='23')
  
Los paréntesis de la expresión regular capturan el texto que coincide con el patrón.

El módulo URLconf compila las expresiones regulares para que se ejecuten más rápidas.

</div><div class="slide">
=== Primera vista===
 python manage.py runserver
Navedador: http://localhost:8000/encuestas/
  Exception Type: 	ViewDoesNotExist
</div><div class="slide">
=== Primera vista (cont.)===
Escribimos las vistas en '''encuestas/views.py'''
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.http import HttpResponse

def index(request):
    return HttpResponse(u"Hola, este es el índice de las encuestas.")

def detalle(request, encuesta_id):
    return HttpResponse(u"Estás viendo la encuesta %s." % encuesta_id)

def resultado(request, encuesta_id):
    return HttpResponse(u"Estás viendo el resultado de la encuesta %s." % encuesta_id)

def votar(request, encuesta_id):
    return HttpResponse(u"Estás votando la encuesta %s." % encuesta_id)
</source>
</div><div class="slide">
=== Vistas que hacen algo ===
Ahora vamos a escribir vistas que hagan algo realmente
Las vistas tienen que devolver:
* El objeto HttpResponse con el contenido de la página solicitada o
* Una excepción (por ej. Http404)
</div><div class="slide">
=== Vistas que hacen algo (cont.)===
'''index'''
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
def index(request):
    # Extrae 5 últimas encuestas de la bbdd. Orden: la última primero.
    listado_ultimas = Encuesta.objects.all().order_by('-fecha_pub')[:5]
    # prepara el resultado para mostrarlo
    output = ', '.join([p.pregunta for p in listado_ultimas])
    return HttpResponse(output)
</source>
</div><div class="slide">
=== Vistas que hacen algo (cont.)===
* '''Problema: el diseño de la página está integrado en la vista'''. 
* Si queremos cambiar el aspecto de la página, hay que editar código python. 
* Idea: separar código y presentación usando el sistema de plantillas de Django
</div><div class="slide">
=== Vistas que hacen algo (cont.)===
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.http import HttpResponse
from django.template import Context, loader
from encuestas.models import Encuesta

def index(request):
    # Extrae 5 últimas encuestas de la bbdd. Orden: la última primero.
    listado_ultimas = Encuesta.objects.all().order_by('-fecha_pub')[:5]
    t = loader.get_template('encuestas/index.html')
    c = Context({
        'listado_ultimas': listado_ultimas,
        })
    return HttpResponse(t.render(c))
</source>
</div><div class="slide">
===Primera plantilla ===
* plantilla en una ruta incluida en TEMPLATE_DIRS. 
* '''[directorio_plantillas]/encuestas/index.html" 
* Por seguridad no se extraen las plantillas de la raíz del proyecto.
</div><div class="slide">
===Primera plantilla (cont.) ===
<source lang="html4strict">
{% if listado_ultimas %}
    <ul>
    {% for encuesta in listado_ultimas %}
        <li><a href="/encuestas/{{ encuesta.id}}/">{{ encuesta.pregunta }}</a></li>
    {% endfor %}
    </ul>
{% else %}
    <p>No hay encuestas disponibles.</p>
{% endif %}
</source>
</div><div class="slide">
===Atajo: render_to_response()===
* ¿Para qué repetir tanto? 
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.shortcuts import render_to_response
from encuestas.models import Encuesta

def index(request):
    listado_ultimas = Encuesta.objects.all().order_by('-fecha_pub')[:5]
    return render_to_response('encuestas/index.html',
        {'listado_ultimas': listado_ultimas,})
</source>

</div><div class="slide">
=== Lanzando una respuesta 404 (no encontrado) ===
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.shortcuts import render_to_response
from django.http import Http404
from encuestas.models import Encuesta
# ...
def detalle(request, encuesta_id):
    try:
        enc = Encuesta.objects.get(pk=encuesta_id)
    except Encuesta.DoesNotExist:
        raise Http404  # Si la encuesta no existe, lanza un httpresponse: 404
    return render_to_response('encuestas/detalle.html', {'encuesta': enc})
</source>
</div><div class="slide">
=== Lanzando una respuesta 404 (no encontrado) ===
Creamos una plantilla para encuestas/detalle.html:
<source lang="html4strict">
{{encuesta}}
</source>
Resultado:

<source lang="bash">
$ curl -I http://127.0.0.1:8000/encuestas/12/
HTTP/1.0 404 NOT FOUND
Date: Wed, 24 Aug 2011 05:27:20 GMT
Server: WSGIServer/0.1 Python/2.7.1+
Content-Type: text/html
</source>
</div><div class="slide">
===Otro atajo: get_object_or_404()===
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.shortcuts import render_to_response, get_object_or_404
# ...
def detalle(request, encuesta_id):
    enc = get_object_or_404(Encuesta, pk=encuesta_id)
    return render_to_response('encuestas/detalle.html', {'encuesta': enc})
</source>
* Si buscamos una secuencia de objetos, podemos usar '''get_list_or_404()'''
</div><div class="slide">
=== Escribir una vista 404 (página no encontrada) ===
* Cuando DEBUG está activado, la vista 404 no se usa y Django muestra el error. 
* Cuando DEBUG está a False, va a buscar un template 404.html en la raíz del directorio de templates. 
* Si no lo encuentra, lanza un Http500. También hay que escribir una plantilla para 500.html.
</div><div class="slide">
=== Detalle.html ===
Plantilla de detalle.html
<source lang="html4strict">
<h1>{{ encuesta.pregunta }}</h1>
<ul>
{% for opcion in encuesta.opcion_set.all %}
    <li>{{ opcion.opcion }}</li>
{% endfor %}
</ul>
</source>
</div><div class="slide">
=== Sintaxis del punto ===
* El sistema de plantillas usa la sintaxis del punto para accceder a los atributos. 
* accede a las opciones desde el objeto encuestas
 encuesta.opcion_set.all
* equivale a 
 encuesta.opcion_set.all()
* Que devuelve el iterable que recorre el for.
* Más información en la https://docs.djangoproject.com/en/1.3/topics/templates

</div><div class="slide">
===Simplificando URLconfs ===
Podemos usar patrones para evitar repeticiones:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
urlpatterns = patterns('encuestas.views',
    (r'^encuestas/$', 'index'),
    (r'^encuestas/(?P<encuesta_id>\d+)/$', 'detalle'),
    (r'^encuestas/(?P<encuesta_id>\d+)/resultado/$', 'resultado'),
    (r'^encuestas/(?P<encuesta_id>\d+)/votar/$', 'votar'),
    )

urlpatterns += patterns('',
    (r'^admin/', include(admin.site.urls)),)
</source>
</div><div class="slide">
===Simplificando URLconfs (cont.)===
También se pueden desacoplar: 
* Movemos sitio_encuestas/urls.py a encuestas/urls.py
* Cambiamos sitio_encuestas/urls.py para eliminar las urls de encuestas e insertamos un include():
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.conf.urls.defaults import *

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    (r'^encuestas/', include('encuestas.urls')),
    (r'^admin/', include(admin.site.urls)),
)
</source>
</div><div class="slide">
===Desacoplado===
Así quedará encuestas/urls.py
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.conf.urls.defaults import *

urlpatterns = patterns('encuestas.views',
    (r'^$', 'index'),
    (r'^(?P<encuesta_id>\d+)/$', 'detalle'),
    (r'^(?P<encuesta_id>\d+)/resultado/$', 'resultado'),
    (r'^(?P<encuesta_id>\d+)/votar/$', 'votar'),
    )
</source>
'''Importante''': ahora tienen una ruta relativa:
* podemos instalar la aplicación en distintas URLs
* ... y la aplicación seguirá funcionando.
</div><div class="slide">
===Primer formulario===
* actualizar la plantilla del detalle ('''encuesta/detalle.html''')
<source lang="html4strict">
<h1>{{ encuesta.pregunta }}</h1>

{% if mensaje_error %}<p><strong>{{ mensaje_error }}</strong></p>{% endif %}

<form action="/encuestas/{{ encuesta.id }}/votar/" method="post">
{% csrf_token %}
{% for opcion in encuesta.opcion_set.all %}
    <input type="radio" name="opcion" id="opcion{{ forloop.counter }}" value="{{ opcion.id }}" />
    <label for="opcion{{ forloop.counter }}">{{ opcion.opcion }}</label><br />
{% endfor %}
<input type="submit" value="Votar" />
</form>
</source>
</div><div class="slide">
===Primer formulario===
Mirando el código: 
* Se usa un '''radio button''' para cada opción de la encuesta. 
* El valor de cada opción está asociado al de su id. 
* El nombre de los radio es '''opcion''', 
* así cuando un usuario selecciona una opción 
* y pulsa el botón de votar, envia por POST la información '''opcion=3''' (con el número de id elegido)
* La acción del formulario es '''/encuestas/{{encuesta.id}}/votar'''. 
</div><div class="slide">
===Primer formulario (cont.)===
* Los datos se envían por POST. 
* Muy importante porque enviar datos al servidor puede alterar el estado (a diferencia de GET)
* el forloop.counter indica cuántas veces ha entrado en el bucle. 
* Se usa {% csrf_token %}  para evitar '''Cross Site Request Forgeries'''. 
* Importante usarlo siempre con POST. 
</div><div class="slide">
===Primer formulario (cont.)===
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.template import RequestContext
# ...
def detalle(request, encuesta_id):
    enc = get_object_or_404(Encuesta, pk=encuesta_id)
    return render_to_response('encuestas/detalle.html',
        {'encuesta': enc},
        context_instance=RequestContext(request))
</source>

</div><div class="slide">
===Acción del formulario=== 
* La acción se decide desde URLconf
* cuando ejecutamos la acción de votar, se llama a la función '''votar'''
* que gestiona los datos enviados y hace algo con ellos:
 (r'^(?P<encuesta_id>\d+)/votar/$', 'votar')
</div><div class="slide">
===Acción del formulario (cont.)=== 
La acción puede quedar así:
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.shortcuts import render_to_response, get_object_or_404
from django.http import HttpResponseRedirect, HttpResponse
from django.core.urlresolvers import reverse
from django.template import RequestContext
from encuestas.models import Encuesta, Opcion

def votar(request, encuesta_id):
    enc = get_object_or_404(Encuesta, pk=encuesta_id)
    try:
        opcion_seleccionada = enc.opcion_set.get(pk=request.POST['opcion'])
    except (KeyError, Opcion.DoesNotExist):
        # Vuelve a mostrar el formulario de votación
        return render_to_response('encuestas/detalle.html', {
            'encuesta': enc,
            'mensaje_error': "No has seleccionado ninguna opción.",
        }, context_instance=RequestContext(request))
    # continua ...
</source>
</div><div class="slide">
===Acción del formulario (cont.)=== 
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
    else:
        opcion_seleccionada.votos += 1
        opcion_seleccionada.save()
        # Siempre devuelve un HttpResponseRedirect después de tratar con éxito
        # un formulario POST. Así se evita enviar dos veces la información cuando
        # el usuario pulsa el botón retroceder.
        return HttpResponseRedirect(reverse('encuestas.views.resultado', args=(enc.id,)))
    return HttpResponse(u"Estás votando la encuesta %s." % encuesta_id)
</source>
</div><div class="slide">
===Acción del formulario (cont.)=== 
Algunas cosas que todavía no hemos visto:
* request.POST : objeto tipo diccionario
* permite acceder a los datos enviados por su clave
* request.POST['opcion'] devuelve el ID de la opción seleccionada como una cadena
* Los valores de request.POST son siempre cadenas.
</div><div class="slide">
===Acción del formulario (cont.)=== 
* Django también proporciona request.GET
* request.POST['opcion'] lanza una excepción KeyError si no se envía esa información en POST. 
* Después de incrementar el contador de la opción, el código devuelve un HttpResponseRedirect
* Se usa la función reverse() para evitar escribir a mano la URL en la vista.
</div><div class="slide">
===Vista resultado=== 
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
def resultado(request, encuesta_id):
    enc = get_object_or_404(Encuesta, pk=encuesta_id)
    return render_to_response('encuestas/resultado.html', {'encuesta': enc})
</source>
</div><div class="slide">
===Plantilla resultado.html=== 
<source lang="html4strict">
<h1>{{ encuesta.pregunta}}</h1>
<ul>
{% for opcion in encuesta.opcion_set.all %}
    <li>{{ opcion.opcion }} -- {{ opcion.votos }} voto{{ opcion.votos|pluralize }}</li>
{% endfor %}
</ul>
<a href="/encuestas/{{ encuesta.id }}/">¿Votar otra vez?</a>
</source>
</div><div class="slide">
===Vistas genéricas: ¡todavía menos código!!===
* tareas muy repetitivas en el desarrollo web: 
** obtener datos de la base de datos, 
** según unos parámetros de una URL, 
** cargar una plantilla y 
** devolver la plantilla procesada. 
Django proporciona un atajo llamado sistema de '''generic views'''.
</div><div class="slide">
===Vistas genéricas: (cont.)===
Para convertir nuestra aplicación al uso de vistas genéricas hay que:
* Convertir el URLconf.
* Eliminar algunas vistas innecesarias.
* Corregir la gestión de las URLs por la nuevas vistas

En un proyecto decidiremos antes si es conveniente el uso de vistas genéricas (mejor que refactorizar)

</div><div class="slide">
===Modificar encuestas/urls.py URLconf ===
<source lang="python" line="GESHI_NORMAL_LINE_NUMBERS">
from django.conf.urls.defaults import *
from django.views.generic import DetailView, ListView
from encuestas.models import Encuesta

urlpatterns = patterns('',
    (r'^$',
        ListView.as_view(
            queryset=Encuesta.objects.order_by('-fecha_pub')[:5],
            context_object_name='listado_ultimas',
            template_name='encuestas/index.html')),
    (r'^(?P<pk>\d+)/$',
        DetailView.as_view(
            model=Encuesta,
            template_name='encuestas/detalle.html')),
    url(r'^(?P<pk>\d+)/resultado/$',
        DetailView.as_view(
            model=Encuesta,
            template_name='encuestas/resultado.html'),
        name='resultado_encuesta'),
    (r'^(?P<encuesta_id>\d+)/votar/$', 'encuestas.views.votar'),
)
</source>
</div><div class="slide">
===Vistas genéricas: (cont.)===
Vamos a usar dos vistas genéricas: ListView y DetailView. 
Cada vista tiene que conocer:
* el modelo sobre el que actúa (model)
* DetailView necesita la clave primaria, llamada pk.(hay que cambiar encuesta_id a pk)
* El nombre resultado_encuesta de la vista resultado sirve para referirse a esta URL después. 
* Por defecto la plantilla de DetailView se llama '''<nombre aplic.>/<nombre modelo>_detail.html'''. en nuestro caso será: encuestas/encuesta_detail.html Se puede usar el argumento '''template_name'''
* La plantilla de ListView se llama por defecto <nombre_modelo>_list.html
* El contexto lo gestiona de forma autmática generando '''encuesta_list'''. La copción context_object_name permite especificar ultimas_encuestas.
* Podemos eliminar ya las vistas creadas: index, detalle, resultado. 
* Sobre la redicrección:
 return HttpResponseRedirect(reverse('resultado_encuesta', args=(enc.id,)))
</div>
</div>

<div id="weSlideLogo" class="nav">
'''Inmersión en Python''' [[image:Python-logo.png|200px]]
</div>