Ampliando tu código con Django

1. Instalación Django

  1. Crear y activar un entorno virtual
python -m venv env
  1. Activar entorno

    1. Desde Windows
    \env\Scripts\activate
    
    1. Desde macOS o Linux
    source env/bin/activate
    

2. Estructura básica de un proyecto Django

  1. Crear un nuevo proyecto
django-admin startproject mi_sitio
  1. Se genera la siguiente estructura inicial:
mi_sitio/ ├── manage.py ├── mi_sitio/ │ ├── init.py │ ├── settings.py │ ├── urls.py │ ├── asgi.py │ └── wsgi.py
ArchivoDescripción
manage.pyScript de utilidad para administrar el proyecto. Permite ejecutar comandos como iniciar el servidor, migrar bases de datos o crear aplicaciones
mi_sitio/Carpeta principal del proyecto. Contiene la configuración central
__init__.pyIndica que esta carpeta es un paquete de python
settings.pyArchivo clave que define la configuración del proyecto: base de datos, aplicaciones instaladas, zona horaria, idioma, rutas de archivos estáticos, etc.
urls.pyDefine las rutas (URL) principales del sitio. Es el punto de entrada para la navegación y el enrutamiento de vistas
asgi.pyArchivo que actúa como interfaz entre el proyecto. Es una alternativa moderna, diseñada para manejar aplicaciones asincrónicas (WebSockets, tareas en tiempo real, etc.)
wsgi.pyArchivo que actúa como interfaz entre el proyecto. Se utiliza con servidores tradicionales como Gunicorn (Green Unicorn) o uWSGI (Web Server Gateway Interface)

3. Creación de una aplicación

En Django, una aplicación (app) representa una parte funcional y reutilizable del sistema. Cada app se enfoca en una tarea o módulo específico, como un blog, un carrito de compras, un sistema de autenticación o un panel de administración. Un proyecto puede contener múltiples apps y una app puede ser usada en varios proyectos.

  1. Desde la raíz del proyecto, ejecutar:
python manage.py startapp blog

Esto crea una nueva carpeta llamada blog/, que incluye la estructura básica para comenzar a desarrollar funcionalidades:

blog/ ├── admin.py ├── apps.py ├── migrations/ │ └── init.py ├── models.py ├── tests.py ├── views.py └── init.py
ArchivoDescripción
models.pyAquí se definen los modelos, es decir, las estructuras de datos que Django convierte en tablas en las bases de datos
views.pyContiene las funciones o clases que controlan la lógica de las respuestas HTTP: qué mostrar cuando un usuario accede a determinada URL
admin.pyPermite registrar modelos para gestionarlos desde el panel de administración de Django
apps.pyArchivo de configuración de la app, utilizado por Django para registrar la aplicación dentro del proyecto
tests.pyArchivo destinado a pruebas automatizadas de las funcionalidades de la app
migrations/Carpeta donde Django guarda los archivos que representan cambios en los modelos (estructuras de bases de datos)
urls.py (no se crea por defecto)Si quieres que la app gestione sus propias rutas, es recomendable crear este archivo manualmente. Esto permite modularizar las URL y mantener una mejor organización

5. Registro de la aplicación

Para que Django reconozca una nueva app, es necesario agregarla en el archivo settings.py del proyecto, dentro de la lista INSTALLED_APPS:

#mi_sitio/settings.py

INSTALLED_APPS = [
    ...
    'blog'
]

4. Rutas y Vistas

Definición de rutas

Django utiliza un sistema llamado URLconf para mapear las URL que recibe el navegador con las vistas que deben ejecutarse

  1. Crear un archivo urls.py en la app
#blog/urls.py
from . import views

urlpatterns = [
    path('', views.inicio, name='inicio'),
] 

Esto define una ruta vacía (”, es decir, la raíz de la app) que se vincula con una vista llamada inicio.

  1. Conectar las rutas de la app en el archivo principal
#mi_sitio/urls.py
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('blog.urls')), # ruta base para la app blog
]

Con esto, cualquier solicitud al sitio (por ejemplo, http://localhost:8000/) será derivada a las rutas definidas en blog/urls.py

Vistas

Las vistas en Django son funciones o clases que procesan una solicitud HTTP y devuelven una respuesta. Su función principal es manejar la lógica del servidor: acceder a datos, procesarlos y determinar qué mostrar al usuario.

  1. En el archivo views.py se la app blog/, se puede crear una vista simple que devuelva un texto plano:
#blog/views.py
from django.http import HttpResponse

def inicio(request):
    return HttpResponse("¡Hola! Esta es la página de inicio del blog.") 

Esta vista toma una solicitud (request) y responde con un texto que será mostrado directamente en el navegador.

Cuando accedas a la URL raíz del sitio (\), se ejecutará esta vista gracias al enrutamiento definido en los pasos anteriores.

Actividad de Práctica 02

1.
¿Cuál es la forma recomendada de instalar Django?
2.
¿Qué archivo es esencial para que los usuarios puedan acceder a las vistas de una app Django a través del navegador?
3.
Una app en Django puede funcionar sin estar registrada en settings.py
4.
El archivo urls.py dentro de la app debe crearse manualmente si quieres modularizar las rutas
BUSCARCtrl K