Aplicaciones¶

Django básico

Un proyecto Django está formado por aplicaciones. En este contexto podemos entender una aplicación como un «módulo» o «sección» de nuestro sitio web.

flowchart TB
    P[Proyecto Django] e1@--> app1[App 1]
    P e2@--> app2[App 2]
    P e3@--> app3[App 3]
    e1@{ animate: true }
    e2@{ animate: true }
    e3@{ animate: true }
    app1 --> url1(("<tt>/app1</tt>"))
    app2 --> url2(("<tt>/app2</tt>"))
    app3 --> url3(("<tt>/app3</tt>"))

Hay una serie de aplicaciones que ya vienen incluidas en la propia instalación de Django. En el primer arranque vimos que se aplicaron migraciones de:

• admin
• auth
• contenttypes
• sessions

Crear una aplicación¶

Para crear una nueva aplicación en un proyecto Django usaremos el subcomando startapp.

Supongamos un ejemplo en el que queremos crear una aplicación para gestionar los «posts» de nuestro «blog». Para ello ejecutamos el siguiente comando:

$ ./manage.py startapp posts

$ uv run manage.py startapp posts

Estructura de una aplicación¶

La estructura de una aplicación Django es la siguiente:

.
├── __init__.py#(1)!
├── admin.py#(2)!
├── apps.py#(3)!
├── migrations#(4)!
│   └── __init__.py
├── models.py#(5)!
├── tests.py#(6)!
└── views.py#(7)!

1. Este tipo de archivos se utilizan para indicar que la carpeta actual es un paquete en Python.
2. Este archivo permite especificar las características de los modelos de cara a la interfaz administrativa de Django.
3. Este archivo permite «registrar» la aplicación creada y definir algunas configuraciones a nivel global.
4. Esta carpeta contendrá las migraciones (como ficheros) realizadas sobre los modelos de la aplicación actual.
5. Este archivo permite definir los modelos para la aplicación actual.
6. Este archivo permite escribir las pruebas («tests») de la aplicación actual.
7. Este archivo permite definir las vistas para la aplicación actual.

Instalar la aplicación¶

Para que Django reconozca una nueva aplicación en nuestro proyecto, necesitamos darla de alta («instalarla») en el fichero settings.py.

Existe una variable INSTALLED_APPS que contiene una lista con todas las aplicaciones dadas de alta en el proyecto. Si miramos su contenido actual veremos lo siguiente:

INSTALLED_APPS = [
    'django.contrib.admin',#(1)!
    'django.contrib.auth',#(2)!
    'django.contrib.contenttypes',#(3)!
    'django.contrib.sessions',#(4)!
    'django.contrib.messages',#(5)!
    'django.contrib.staticfiles',#(6)!
]

1. Interfaz administrativa.
2. Sistema de autenticación.
3. Herramientas para trabajar con los modelos del proyecto.
4. Sistema para almacenar información en sesiones.
5. Notificaciones.
6. Gestión de archivos estáticos.

Siguiendo con el ejemplo anterior vamos a «instalar» nuestra aplicación posts. Basta con añadir su fichero de configuración a settings.py:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # CUSTOM
    'posts.apps.PostsConfig',#(1)!
]

1. /posts/apps.py clase PostsConfig

Como regla general, lo que debemos añadir a la lista INSTALLED_APPS de settings.py es la «ruta» a la clase que configura la aplicación.

Aplicación compartida¶

En cualquier proyecto hay una gran cantidad de recursos que se comparten por todas las aplicaciones. Por tanto resulta interesante crear una aplicación que centralice dichos recursos y sirva de referencia para ellos.

En este sentido es recomendable crear una aplicación shared que contenga artefactos compartidos: plantillas base, estáticos comunes, funciones genéricas, etc.

$ ./manage.py startapp shared

$ uv run manage.py startapp shared

Tendremos igualmente que instalar la aplicación shared en settings.py:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # CUSTOM
    'posts.apps.PostsConfig',#(1)!
    'shared.apps.SharedConfig',#(2)!
]

1. /posts/apps.py clase PostsConfig
2. /shared/apps.py clase SharedConfig