Instalación y Configuración Básica de Django

Antes de comenzar a usar Django, es necesario configurar el entorno e instalar las herramientas necesarias.

1. Requisitos Previos

Antes de instalar Django, asegúrate de tener lo siguiente instalado en tu máquina:

  • Python 3.x: Django es compatible con Python 3. Verifica si tienes Python instalado ejecutando:
python --version

Si no está instalado, puedes descargar e instalar Python desde python.org.

  • pip: Es el instalador de paquetes de Python. Verifica si está instalado ejecutando:
pip --version

2. Configuración de un Entorno Virtual

Es recomendable crear un entorno virtual para gestionar las dependencias de cada proyecto Django por separado. Un entorno virtual aísla los paquetes de Python de tu proyecto de los paquetes instalados a nivel del sistema.

Para crear y activar un entorno virtual:

Instala el módulo venv si no lo tienes instalado:

python -m pip install --user virtualenv

Crea un entorno virtual:

python -m venv mi_entorno

Sustituye mi_entorno por el nombre de tu entorno virtual.

Activa el entorno virtual:

  • En Windows:
mi_entorno\Scripts\activate
  • En macOS y Linux:
source mi_entorno/bin/activate

Cuando el entorno virtual esté activado, verás su nombre en el prompt del terminal, indicando que todas las instalaciones ahora están aisladas dentro del entorno virtual.

3. Instalación de Django

Con el entorno virtual activado, puedes instalar Django utilizando pip:

pip install django

Para verificar la instalación, ejecuta:

django-admin --version

Esto debería mostrar la versión de Django instalada.

4. Creación de tu Primer Proyecto Django

Ahora que Django está instalado, puedes crear un nuevo proyecto Django. Dirígete al directorio donde quieres crear el proyecto y ejecuta:

django-admin startproject miproyecto

Esto creará un nuevo directorio llamado miproyecto con la siguiente estructura:

miproyecto/
    manage.py
    miproyecto/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py
  • manage.py: Utilidad de línea de comandos para interactuar con tu proyecto (e.g., ejecutar el servidor, crear migraciones).
  • settings.py: Contiene toda la configuración de tu proyecto.
  • urls.py: Define el enrutamiento de URLs para tu proyecto.
  • wsgi.py y asgi.py: Puntos de entrada para servidores web compatibles con WSGI/ASGI.

5. Creación de una Aplicación Django

Django promueve un enfoque modular, permitiendo que una única instalación de Django contenga múltiples aplicaciones. Para crear una nueva aplicación dentro de tu proyecto, sigue estos pasos:

Navega al directorio de tu proyecto:

cd miproyecto

Crea una nueva aplicación utilizando el siguiente comando:

python manage.py startapp mi_aplicacion

Esto creará un nuevo directorio llamado mi_aplicacion con la siguiente estructura:

mi_aplicacion/
    migrations/
        __init__.py
    __init__.py
    admin.py
    apps.py
    models.py
    tests.py
    views.py
  • migrations/: Carpeta para manejar las migraciones de la base de datos.
  • admin.py: Archivo para registrar modelos en el panel de administración de Django.
  • apps.py: Archivo de configuración de la aplicación.
  • models.py: Aquí defines los modelos de datos de tu aplicación.
  • tests.py: Aquí puedes escribir pruebas para tu aplicación.
  • views.py: Contiene las vistas de tu aplicación.

Registrar la Aplicación

Para que Django reconozca tu nueva aplicación, debes agregarla a la configuración del proyecto. Abre el archivo settings.py y busca la sección INSTALLED_APPS. Agrega tu aplicación a la lista:

INSTALLED_APPS = [
    ...
    'mi_aplicacion',
]

6. Ejecutar el Servidor de Desarrollo

Para verificar que todo está configurado correctamente, navega a la carpeta de tu proyecto:

cd miproyecto

Ejecuta el siguiente comando para iniciar el servidor de desarrollo:

python manage.py runserver

Deberías ver una salida como esta:

Watching for file changes with StatReloader
Performing system checks...

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

Abre tu navegador web y dirígete a http://127.0.0.1:8000/. Deberías ver la página de "¡Funciona!" de Django, lo que confirma que tu proyecto está en ejecución.

7. Configuración Básica

Antes de continuar con el desarrollo, es recomendable ajustar algunas configuraciones básicas en settings.py:

  • Zona Horaria: Configura la zona horaria local:
TIME_ZONE = 'America/Lima'

Sustituye 'America/Lima' con tu zona horaria local.

  • Idioma: Configura el idioma por defecto:
LANGUAGE_CODE = 'es-es'

Por ejemplo, para inglés, usa 'en-us'.

  • Allowed Hosts: Cuando despliegues tu proyecto, especifica los dominios o direcciones IP que pueden acceder a tu sitio:
ALLOWED_HOSTS = ['127.0.0.1', 'localhost']

Estas configuraciones básicas preparan tu proyecto para el desarrollo local. A medida que avances, harás más ajustes para la seguridad, bases de datos y otras configuraciones.