Django 'Hola Mundo'

Antes de que podamos hacer que Django funcione, necesitarás Python 3.8+ y pip (el instalador de paquetes de Python) en tu sistema. La mayoría de los sistemas operativos modernos vienen con Python preinstalado, pero siempre es bueno verificar.

Abre tu terminal y mira qué versión de Python hay instalada:

python3 --version

Si no ves algo como Python 3.8.x o superior, o si Python no se encuentra, una visita rápida a python.org te solucionará el problema. Asegúrate de descargar la última versión estable de la serie 3.x: a Django le encanta.

Mira, meterse con los paquetes globales de Python es como soltar a un niño pequeño en una biblioteca impoluta: las cosas se vuelven un desastre rápido. Por eso usamos entornos virtuales. Son burbujas ordenadas y autocontenidas para las dependencias de tu proyecto, manteniendo todo organizado y evitando conflictos.

Primero, decide dónde quieres que viva tu proyecto de Django. Navega hasta allí en tu terminal, y luego crea un nuevo entorno virtual:

python3 -m venv .venv

Ahora, vamos a activarlo. El comando difiere ligeramente según tu sistema operativo:

# En macOS/Linux
source .venv/bin/activate

# En Windows (usa Símbolo del sistema)
.venv\Scripts\activate

Sabrás que está funcionando cuando el prompt de tu terminal obtenga un pequeño prefijo (.venv). Es como una pequeña insignia de honor, que significa tu reino de desarrollo aislado.

Con nuestro entorno virtual funcionando, es hora del evento principal: incorporar Django. Esto es sorprendentemente fácil: solo un comando.

En tu entorno virtual activo, ejecuta:

pip install django

Pip descargará Django y todos sus compañeros necesarios. Una vez que termine, eres oficialmente un desarrollador habilitado para Django. El framework está instalado y listo para ser puesto a trabajar.

¡Ahora, un poco de magia de Django! Usaremos el comando django-admin, que viene incluido con Django, para generar un proyecto completamente nuevo. Piensa en ello como si Django pusiera los planos fundamentales para tu aplicación web.

Desde el directorio raíz de tu proyecto (donde vive tu .venv), ejecuta este comando:

django-admin startproject mysite .

El . al final es importante; le dice a Django que cree los archivos del proyecto en tu directorio actual, en lugar de anidarlo en otra carpeta mysite. Ahora tendrás una estructura básica de proyecto de Django, una especie de esqueleto para tus sueños web.

Una vez que hayas ejecutado el comando startproject, tu directorio habrá florecido con algunos archivos nuevos y un subdirectorio. Vale la pena echar un vistazo rápido para entender qué es qué:

.
├── .venv/                  # Tu entorno virtual
├── manage.py               # Una utilidad de línea de comandos para Django
└── mysite/                 # El paquete Python real para tu proyecto
    ├── __init__.py         # Hace que mysite sea un paquete Python
    ├── asgi.py             # Punto de entrada ASGI para servidores asíncronos
    ├── settings.py         # Configuración y ajustes del proyecto
    ├── urls.py             # Declaraciones de URL de tu proyecto
    └── wsgi.py             # Punto de entrada WSGI para servidores síncronos
                                

manage.py es tu fiel compañero para todo lo relacionado con la línea de comandos de Django. Dentro de mysite/, settings.py es donde ajustarás las configuraciones, y urls.py es el controlador principal de tráfico de tu proyecto.

Antes de que siquiera pensemos en ver una página web, Django necesita configurar sus tablas de base de datos predeterminadas. Viene con algunas características incorporadas, como autenticación de usuarios y una interfaz de administración, y estas necesitan un lugar para almacenar sus datos.

Aquí es donde entran las migraciones. Son esencialmente instrucciones para tu base de datos. Ejecuta esto desde la raíz de tu proyecto (donde vive manage.py):

python manage.py migrate

Verás una ráfaga de actividad mientras Django crea tablas para la autenticación, sesiones y su panel de administración en la base de datos SQLite predeterminada. Es como preparar la base antes de construir las paredes.

En Django, un "proyecto" es una colección de configuraciones y "apps". Una "app" es una aplicación web que hace una cosa específica: un blog, una encuesta, un simple "Hola Mundo". Esta modularidad es uno de los superpoderes de Django, permitiéndote reutilizar apps en diferentes proyectos.

Creemos nuestra primera app. La llamaremos hello_world_app. Ejecuta este comando:

python manage.py startapp hello_world_app

Ahora verás un nuevo directorio, hello_world_app/, anidado dentro de tu proyecto. Aquí es donde ocurrirá la magia de nuestro "Hola Mundo".

Django no sabe mágicamente sobre las nuevas apps que creas. Tienes que decirle explícitamente a la configuración de tu proyecto que esta nueva app existe y debe incluirse. Es como añadir un nuevo miembro a un club: necesitas actualizar el registro.

Abre mysite/settings.py y busca la lista INSTALLED_APPS. Añade tu nueva hello_world_app a ella:

# mysite/settings.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world_app',  # <-- Agrega esta línea
]
                                

Sin esto, Django no se molestaría en buscar dentro de tu nueva app vistas, modelos o cualquier otra cosa. Es un apretón de manos crucial entre tu proyecto y su flamante nuevo componente.

Una "vista" en Django es una función o clase de Python que toma una solicitud web y devuelve una respuesta web. Esencialmente, es la lógica principal que decide qué contenido mostrar cuando alguien visita una URL particular.

Abre hello_world_app/views.py y reemplaza su contenido con esta simple función:

# hello_world_app/views.py

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django World!")
                                

Esta función, index, es notablemente sencilla: simplemente arroja el texto "Hello, Django World!" cuando se llama. Bastante genial para un primer paso, ¿verdad?

Para que tu nueva vista sea accesible a través de una dirección web, necesita un patrón de URL. Crearemos un archivo urls.py dedicado *dentro* de nuestra hello_world_app para gestionar sus rutas específicas. Esto mantiene las cosas modulares, tal como le gusta a Django.

Crea un nuevo archivo: hello_world_app/urls.py, y dale este contenido:

# hello_world_app/urls.py

from django.urls import path
from . import views

urlpatterns = [
    path("", views.index, name="index"),
]
                                

Aquí, path("", views.index, name="index") significa que un path vacío (es decir, la raíz del espacio de URLs de nuestra app) activará nuestra vista index. Simple, ¿verdad?

Hemos informado a nuestra app sobre sus propias URLs, pero el principal despachador de URLs del proyecto (mysite/urls.py) aún necesita ser informado de que nuestra hello_world_app tiene paths que le interesan. Es como tener una sucursal, pero la sede principal necesita saber que existe para reenviar el correo.

Abre mysite/urls.py y añade un include para vincular las URLs de tu app:

# mysite/urls.py

from django.contrib import admin
from django.urls import path, include # <-- Agrega 'include'

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("hello_world_app.urls")), # <-- Agrega esta línea
]
                                

Ahora, cuando alguien visite la URL raíz de tu proyecto (/), Django "incluirá" los patrones de URL de hello_world_app/urls.py y encontrará tu vista "Hello World". ¡Las piezas están encajando!

Hemos sentado las bases, cosido el código y definido las rutas. ¡Ahora el momento de la verdad! Django viene con un servidor de desarrollo ligero que es perfecto para probar cosas localmente.

Desde el directorio raíz de tu proyecto (donde vive manage.py), ejecuta:

python manage.py runserver

Verás una gran cantidad de salida en la terminal, que termina con algo como Starting development server at http://127.0.0.1:8000/. Eso significa que tu servidor Django está en funcionamiento y esperando pacientemente las solicitudes.

¡Ha llegado el momento! Abre tu navegador web y navega a la dirección que proporcionó Django, generalmente http://127.0.0.1:8000/.

Si todos los cables están conectados correctamente, deberías ser recibido por una página web simple que muestra con orgullo:

Y ahí lo tienes: tu primera aplicación "Hola Mundo" de Django, ¡en vivo y sirviendo contenido! Es un pequeño paso, pero confirma que todo está configurado correctamente, desde Python hasta el enrutamiento de URLs de Django. Oficialmente has lanzado tu viaje al desarrollo de Django.