Cómo Funcionan las Rutas en Django

Django utiliza un sistema basado en patrones para definir las rutas de las aplicaciones web. Estas rutas se configuran en archivos llamados urls.py y permiten enlazar las URLs con las vistas.

En Django, las rutas se definen en el archivo urls.py. La función principal utilizada es path, y opcionalmente, re_path para expresiones regulares.

Estructura de una ruta básica

python 
from django.urls import path
from . import views

urlpatterns = [

  path('ruta/', views.mi_vista, name='nombre_de_la_ruta'),

]
  Definiciones

  • ruta/: Define el patrón de la URL.
  • views.mi_vista: Especifica la vista que se ejecutará cuando se acceda a esta URL.
  • name: Permite referenciar la ruta en plantillas o vistas.

Configurar URLs en una aplicación

  • Crea un archivo urls.py en tu aplicación (si no existe).
  • Define las rutas locales.
python 
from django.urls import path
from . import views

urlpatterns = [

  path('', views.inicio, name='inicio'),
  path('about/', views.about, name='about'),

]

Incluye las rutas locales en el proyecto principal. En el archivo urls.py del proyecto:

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

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

Ruta simple

python 
urlpatterns = [
  path('saludo/', views.saludo, name='saludo'),
]

Vista en views.py

python 
from django.http import HttpResponse

def saludo(request):

  return HttpResponse("¡Hola, Mundo!")

Ruta con parámetros

python 
urlpatterns = [
  path('saludo/<str:nombre>/', views.saludo_personalizado, name='saludo_personalizado'),
]

Vista en views.py

python 
def saludo_personalizado(request, nombre):

  return HttpResponse(f"¡Hola, {nombre}!")

Ruta con expresiones regulares

Usando re_path:

python 
from django.urls import re_path

urlpatterns = [

  re_path(r'^numero/(?P<numero>[0-9]+)/$', views.mostrar_numero, name='mostrar_numero'),
]

Vista en views.py

python 
def mostrar_numero(request, numero):

  return HttpResponse(f"El número es: {numero}")

Rutas agrupadas

Cuando tienes varias rutas relacionadas:

python 
urlpatterns = [

  path('blog/', views.blog_list, name='blog_list'),

  path('blog/<int:id>/', views.blog_detail, name='blog_detail'),

]

Vistas en views.py

python 
def blog_list(request):
  return HttpResponse("Lista de publicaciones.")

def blog_detail(request, id):
  return HttpResponse(f"Detalles de la publicación con ID: {id}")

Uso de path y re_path

  • path: Usa rutas legibles y simples.
  • re_path: Utiliza expresiones regulares para patrones avanzados.

Ejemplo combinado:

python 
from django.urls import path, re_path

urlpatterns = [

  path('simple/', views.simple, name='simple'),

  re_path(r'^regex/(?P<slug>[-w]+)/$', views.regex_example, name='regex_example'),

]