Episodio 2, Capítulo 8

Creación y Ejecución del Proyecto Django

⏱️ Tiempo de lectura: 10 minutos
🧩 Actividades: 2 (Crear y correr proyecto)
📚 Nivel: Principiante

💻 ¡Manos al Código! Creando Nuestro Primer Proyecto Django

¡Llegó el momento de la verdad! Ya tenemos nuestro entorno preparado, Python listo, Django instalado y nuestro editor de código (Visual Studio Code) esperando. Ahora vamos a dar el paso fundamental: crear nuestro primer proyecto Django y verlo funcionar por primera vez.

1. Abriendo Nuestro Espacio de Trabajo en VS Code

Primero, abre Visual Studio Code. Luego, necesitas abrir la carpeta donde creaste tu entorno virtual (por ejemplo, la carpeta "MisProyectosDjango" que mencionamos antes, donde adentro está tu carpeta venv).

Puedes hacerlo de dos maneras:

  • Ve a "Archivo" (o "File") en el menú superior, luego "Abrir Carpeta..." (o "Open Folder...") y selecciona tu carpeta principal de proyecto.
  • O, más fácil aún, ¡simplemente arrastra la carpeta de tu proyecto directamente a la ventana de Visual Studio Code!

Una vez abierta, verás los archivos y carpetas de tu proyecto en el panel lateral izquierdo de VS Code.

Visual Studio Code con carpeta de proyecto abierta

Así se vería VS Code con tu carpeta de proyecto abierta (ejemplo).

2. La Terminal Integrada: Nuestra Aliada

Visual Studio Code tiene una funcionalidad genial: una terminal integrada. Esto significa que no necesitas tener una ventana de terminal separada; puedes ejecutar todos tus comandos directamente desde el editor.

Para abrirla, ve al menú superior "Terminal" y selecciona "Nueva terminal" (o "New Terminal"). Se abrirá un panel en la parte inferior de VS Code, ¡y es exactamente igual a la terminal de tu sistema operativo!

¡Importantísimo! Asegúrate de que tu entorno virtual esté activado en esta nueva terminal de VS Code. Si al abrirla no ves el nombre de tu entorno entre paréntesis (ej: (venv)), necesitas activarlo nuevamente como aprendimos en el capítulo anterior (ej: venv\Scripts\activate en Windows o source venv/bin/activate en Mac/Linux).

3. El Nacimiento del Proyecto: django-admin startproject

Con la terminal abierta en VS Code y tu entorno virtual activado, ¡es hora de crear el proyecto! Django nos da una herramienta de línea de comandos llamada django-admin para realizar varias tareas administrativas. Para crear un nuevo proyecto, usamos el comando startproject.

Escribe lo siguiente en la terminal y presiona Enter:

Terminal (entorno activado)
django-admin startproject agenda .

Desglosemos este comando:

  • django-admin: La herramienta de línea de comandos de Django.
  • startproject: La orden para iniciar un nuevo proyecto.
  • agenda: ¡Este es el nombre que le daremos a nuestro proyecto! Puedes elegir otro si quieres (por ejemplo, "mi_primera_app", "gestor_tareas", etc.), pero para seguir el tutorial, usemos "agenda".
  • . (un punto al final): Este punto es importante. Le dice a Django que cree los archivos del proyecto directamente en la carpeta actual (que debería ser "MisProyectosDjango" o como la hayas llamado, donde ya está tu venv). Si omites el punto, Django creará una carpeta extra llamada "agenda" y meterá todo ahí, lo cual puede ser un poco redundante.

Después de ejecutar el comando, ¡verás que aparecen nuevos archivos y carpetas en tu panel lateral de VS Code! Miremos qué se creó:

Estructura de carpetas de un proyecto Django inicial

Estructura típica de un proyecto Django recién creado.

  • Una carpeta llamada agenda (la carpeta interna): Esta es la carpeta principal de la aplicación de tu proyecto. Contiene archivos importantes como:
    • settings.py: Aquí van todas las configuraciones de tu proyecto Django (base de datos, aplicaciones instaladas, etc.).
    • urls.py: Define las "direcciones" o rutas de tu aplicación web.
    • wsgi.py y asgi.py: Archivos relacionados con cómo tu aplicación se comunica con los servidores web (no te preocupes mucho por ellos ahora).
  • Un archivo llamado manage.py: ¡Este archivo es tu mejor amigo en Django! Es una utilidad de línea de comandos que te permite interactuar con tu proyecto de muchas maneras: correr el servidor de desarrollo, crear aplicaciones, aplicar cambios a la base de datos (migraciones), crear usuarios, y mucho más. Es como el "comandante en jefe" de tu proyecto.

La carpeta exterior (donde están manage.py y la carpeta interna agenda, y también tu carpeta venv) es la carpeta raíz de tu proyecto.

4. ¡A Correr se Ha Dicho! El Servidor de Desarrollo

Django viene con un servidor web liviano incorporado, perfecto para desarrollar y probar tu aplicación localmente en tu computadora. Para ponerlo en marcha, asegúrate de estar en la terminal, dentro de la carpeta raíz de tu proyecto (la que contiene el archivo manage.py) y con tu entorno virtual activado.

Luego, ejecuta el siguiente comando:

Terminal (en la carpeta del proyecto, entorno activado)
python manage.py runserver

(Nuevamente, si usas python3, sería python3 manage.py runserver).

Desglosemos:

  • python (o python3): Le decimos que vamos a ejecutar un script de Python.
  • manage.py: El script "comandante" de nuestro proyecto.
  • runserver: La orden específica que le damos a manage.py para que inicie el servidor de desarrollo.

Si todo va bien, verás unos mensajes en la terminal, y uno de ellos te dirá algo como:

Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

¡Esa dirección http://127.0.0.1:8000/ es la puerta de entrada a tu aplicación! Copia esa dirección, pégala en tu navegador web (Chrome, Firefox, Edge, el que uses) y presiona Enter.

Página de inicio por defecto de Django

¡Felicidades! Esta es la página de bienvenida de Django. Significa que tu proyecto está funcionando.

¡Y voilà! Deberías ver una página de bienvenida de Django, usualmente con un cohete y un mensaje de felicitaciones. ¡Significa que tu proyecto Django está creado y el servidor de desarrollo está funcionando correctamente!

Para detener el servidor de desarrollo, simplemente vuelve a la terminal donde se está ejecutando y presiona Control + C.

El video de este capítulo te mostrará todo este proceso visualmente.

Pequeño Resumen del Capítulo 8 (Episodio 2)

Para crear un nuevo proyecto Django, abre la terminal en la carpeta deseada (con el entorno virtual activado) y ejecuta django-admin startproject nombre_proyecto .. Esto creará la estructura básica del proyecto, incluyendo el importante archivo manage.py. Luego, para ver tu proyecto en acción, navega a la carpeta raíz del proyecto en la terminal y ejecuta python manage.py runserver. Abre la dirección que te indica la terminal (usualmente http://127.0.0.1:8000/) en tu navegador para ver la página de bienvenida de Django.

¡Acabas de crear y correr tu primer proyecto Django! Aunque todavía no hemos añadido nuestra propia lógica, este es un hito fundamental. En los próximos capítulos, empezaremos a darle forma a nuestra aplicación "agenda".

← Capítulo anterior