Django Guía

2. Configuración del Entorno

Prerrequisitos

  • Python 3.8 o superior instalado.
  • pip (gestor de paquetes de Python).

Paso 1: Crear un Entorno Virtual

Es recomendable usar entornos virtuales para aislar las dependencias de tu proyecto.

# En Linux/macOS
python3 -m venv venv
source venv/bin/activate

# En Windows
python -m venv venv
venv\Scripts\activate

Paso 2: Instalar Django

Con el entorno virtual activado:

pip install django

Paso 3: Crear un Proyecto

Django distingue entre un "Proyecto" y una "Aplicación" (App):

  • Proyecto: La configuración global y colección de aplicaciones (ej. "SitioWeb").
  • Aplicación: Un módulo que hace algo específico (ej. "Blog", "Foro", "Tienda").

Primero, crea el proyecto:

django-admin startproject mi_proyecto
cd mi_proyecto

Estructura generada

  • manage.py: Una utilidad de línea de comandos para interactuar con el proyecto.
  • mi_proyecto/settings/: Paquete de configuración modular (base, local, production).
  • mi_proyecto/urls.py: Declaración de rutas (URL dispatcher).
  • mi_proyecto/wsgi.py y asgi.py: Puntos de entrada para servidores web.

Nota de Arquitectura: En este repositorio, hemos reemplazado el archivo único settings.py por una estructura modular para separar entornos. Consulta la sección de Arquitectura Moderna para más detalles.

Paso 4: Gestión de Dependencias

Es fundamental registrar las librerías que usa tu proyecto para que otros desarrolladores (o el servidor de producción) puedan instalarlas.

# Guardar dependencias actuales en un archivo
pip freeze > requirements.txt

# Instalar dependencias desde el archivo
pip install -r requirements.txt

Paso 5: Configuración de Git

Nunca debes subir archivos temporales, bases de datos locales o secretos al repositorio. Crea un archivo .gitignore en la raíz:

# .gitignore básico para Django
__pycache__/
*.py[cod]
db.sqlite3
venv/
.env
.DS_Store

Ejecutar el servidor de desarrollo

Django incluye un servidor web ligero para pruebas. No uses este servidor en producción.

python manage.py runserver

Visita http://127.0.0.1:8000/ para ver tu web funcionando.