Projet, applications et première vue

Django en bref

Django est un framework web Python « batteries incluses » : ORM pour la base de données, système de gabarits, formulaires, authentification, interface d’administration, protections de sécurité… Il est utilisé pour des sites de contenu, des back-offices, des SaaS et des API. Ce cours utilise Django 6.1 (qui demande Python 3.12 ou plus récent) ; les notions présentées sont les mêmes dans la version à support long terme 5.2 LTS.

Créer un projet

python -m venv .venv && source .venv/bin/activate
python -m pip install Django            # dernière version stable (6.1)
django-admin startproject config .     # le point : crée le projet dans le dossier courant
python manage.py runserver              # http://127.0.0.1:8000

Arborescence obtenue :

manage.py            outil de commande du projet
config/
    settings.py      configuration (applications, base de données, langue...)
    urls.py          table des URL principale
    wsgi.py, asgi.py points d'entrée pour les serveurs de production

Dans settings.py, passe LANGUAGE_CODE = "fr-fr" et TIME_ZONE = "Europe/Paris".

Créer une application

Un projet est un site ; une application est un module qui gère une fonctionnalité (catalogue, blog, comptes). Un projet en contient plusieurs.

python manage.py startapp catalogue

Puis déclare-la dans config/settings.py :

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    # ... applications fournies par Django ...
    "catalogue",            # notre application
]

Première vue

Une vue est une fonction qui reçoit une requête (HttpRequest) et renvoie une réponse (HttpResponse).

# catalogue/views.py
from django.http import HttpResponse


def accueil(request):
    return HttpResponse("<h1>Bienvenue dans le catalogue</h1>")


def detail_produit(request, pk):        # pk vient de l'URL, déjà converti en int
    return HttpResponse(f"Produit n°{pk}")

Relier des URL aux vues

# catalogue/urls.py (fichier à créer)
from django.urls import path
from . import views

app_name = "catalogue"                   # espace de noms des URL de l'application
urlpatterns = [
    path("", views.accueil, name="accueil"),
    path("produits/<int:pk>/", views.detail_produit, name="detail"),
]

# config/urls.py
from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path("admin/", admin.site.urls),
    path("catalogue/", include("catalogue.urls")),   # délègue tout ce qui commence par catalogue/
]

<int:pk> est un convertisseur : il n’accepte que des chiffres et passe un int à la vue. Les autres : str (par défaut, tout sauf /), slug (lettres, chiffres, tirets, soulignés), uuid, path (accepte aussi les /). /catalogue/produits/abc/ ne correspond à aucun motif : Django renvoie 404.

Le paramètre name permet de générer les URL sans les écrire en dur : reverse("catalogue:detail", args=[3]) donne /catalogue/produits/3/.

Le parcours d’une requête

1. Le navigateur demande /catalogue/produits/3/.
2. Django parcourt config/urls.py dans l’ordre, trouve catalogue/, puis continue dans catalogue/urls.py avec produits/3/.
3. Le premier motif qui correspond gagne : Django appelle detail_produit(request, pk=3).
4. La vue renvoie un HttpResponse (souvent construit à partir d’un modèle et d’un gabarit).

C’est l’architecture MTV : le Modèle gère les données, le Template la présentation, la Vue la logique. L’aiguillage des URL est assuré par le framework.

À retenir

• startproject une fois, startapp par fonctionnalité, sans oublier INSTALLED_APPS.
• Vue = fonction request → HttpResponse.
• path() + convertisseurs + name, et include() pour chaque application.