Escribe tu primera vista¶

Vamos a escribir la primera vista. Abre el archivo calc/views.py y pon el siguiente código Python en ella:

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hola, mundo. Estás en la página de inicio de tu app llamada calc.")

Esta es la vista más simple posible en Django. Nótese que una vista es una función, cuyo primer parámetro, request, es una variable que contiene la información de la petición de manera que podamos acceder fácilmente a la misma (como veremos más adelante). Las vistas han de responder HTTP; en este caso, devolvemos un objeto HttpResponse (que hemos importado de django.http) al cual le podemos pasar como parámetro el contenido de lo que se va a mostrar en el navegador (o sea, la página web).

Para conseguir llamar esta vista, tenemos que asignarle a una URL -- y para ello necesitamos lo que en Django se conoce como una URLconf. Una URLconf es un mecanismo mediante el cual ligamos una URL a una vista. En otras palabras, es una manera de decir que si nos piden la /, se ejecute la vista llamada index. O, como veremos más adelante, habrá una URL que será /sumar/1/2. Pues entonces tendremos que crear una URLconf que haga que se ejecute la función suma con los sumandos 1 y 2. Pero eso lo veremos más adelante.

La URLconf puede ser a nivel de proyecto (por defecto), para lo cual todas las URLs de todas las aplicaciones se encontrarán en proyecto/urls.py. Pero lo mejor es distribuir la URLconf entre las aplicaciones, de manera que cada una de las aplicaciones que creemos tengan la suya propia. Nosotros utilizaremos la segunda opción, por lo que necesitaremos hacer dos cosas: (1) crear una URLconf en calc y (2) indicar en la URLconf del proyecto (la URLconf raíz) que habrá ciertas URLs que las tratará la URLconf de calc.

Para crear una URLconf en el directorio calc, crea un archivo nuevo llamado urls.py. El directorio de tu aplicación debe verse ahora así:

calc/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

Incluye el siguiente código en el archivo calc/urls.py (recuerda que este fichero lo vas a tener que crear):

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index),
]

El siguiente paso es señalar la URLconf de calc en el raíz. Así, en proyecto/urls.py añade un import para django.urls.include e introduce un include() en la lista urlpatterns, para obtener:

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('calc/', include('calc.urls')),
    path('admin/', admin.site.urls),
]

La función include() permite hacer referencia a otros URLconfs. Cada vez que Django encuentra include() corta cualquier parte de la URL que coincide hasta ese punto y envía la cadena restante a la URLconf incluida para seguir el proceso, que es justo lo que queremos hacer ahora, que vaya a la URLconf de nuestra app calc. En otras palabras, lLaa idea detrás de include() es facilitar la conexión y ejecución inmediata de las URLs. Dado que la calculadora estará en tu propia URLconf (calc/urls.py) se pueden ubicar en «/calc/», «/fun_calc /», «/content/calc/» o en cualquier otra ruta raíz , y la aplicación todavía seguirá funcionando.

Hecho esto, hemos conectado la vista index en URLconf. Veamos si funciona correctamente. Lancemos el servidor:

$ python manage.py runserver

...\> py manage.py runserver

Y ve a http://localhost:8000/calc/ con tu navegador. Deberías ver el texto «Hola, mundo. Estás en la página de inicio de tu app llamada calc.» que pusimos en la vista index.

El método path() función puede recibir hasta cuatro argumentos, dos requeridos route y view, que veremos ahora; y dos opcionales kwargs y name, que veremos más adelante:

• route es una cadena que contiene un patrón de URL. Cuando Django procesa una petición comienza por el primer patrón en urlpatterns y continua hacia abajo por la lista comparando la URL solicitada con cada patrón hasta encontrar aquel que calza. Ten en cuenta que estas expresiones regulares no buscan parámetros GET y POST o el nombre de dominio. Por ejemplo en una petición a la dirección URL https://www.example.com/myapp/, la URLconf buscará myapp/. En una petición a https://www.example.com/myapp/?page=3 la URLconf también buscará myapp/.
• Cuando Django encuentra una coincidencia de expresiones regulares llama a la función de la vista especificada con un objeto HttpRequest como primer argumento y cualquiera de los valores «capturados» de la ruta como argumentos de palabra clave. Veremos un ejemplo de esto en un momento.

Hacia la calculadora¶

Una vez que hemos visto cómo hacer que Django reaccione a partir de una petición del navegador, pongámonos manos a la obra para termimar nuestra calculadora. Lo primero que haremos es definir las URLs (en calc/urls.py):

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index),
    path('sumar/<int:op1>/<int:op2>', views.add),
    path('restar/<int:op1>/<int:op2>', views.sub),
    path('multiplicar/<int:op1>/<int:op>', views.multi),
    path('dividir/<int:op1>/<int:op2>', views.div),
]

Y ahora vayamos a por las vistas. En calc/views.py pondremos lo siguiente:

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hola, mundo. Estás en la página de inicio de tu app llamada calc.")

def add(request, op1, op2):
    return HttpResponse(op1+op2)

def sub(request, op1, op2):
    return HttpResponse(op1-op2)

def multi(request, op1, op2):
    return HttpResponse(op1*op2)

def div(request, op1, op2):
    try:
        result = op1/op2
    except ZeroDivisionError:
        result = "No division by zero allowed!"
    return HttpResponse(result)

Prueba a ir a http://localhost:8000/calc/sumar/1/2 con tu navegador... si todo ha ido bien, debería dar 3.

Si has llegado hasta aquí y todavía tienes tiempo, prueba a resumir las cuatro vistas en una única vista (que haga sumar, restar, multiplicar y dividir -- si int es para enteros en URLconf, str lo será para cadenas de caracteres). Puedes para ello también cambiar el URLconf y tener sólo dos líneas (la de index y la de calcular).