Lister des enregistrements¶

Objectif : lire plusieurs lignes en base et les afficher dans une vue.

Ce que vous allez apprendre : lire toute une table avec core.database.db.fetch_all, qui retourne une liste de dictionnaires, puis l'itérer dans la vue avec une boucle Jinja {% for %}.

Un mini-projet autonome

Le niveau intermédiaire est un tutoriel continu : vous construisez à la main un seul petit projet, le « Carnet de notes », qui grandit palier après palier.
C'est un projet indépendant du niveau débutant, pas besoin de l'avoir suivi.

Comme au débutant, vous écrivez le code vous-même, à la main, sans génération automatique.

Démarrer le niveau¶

Créez un projet neuf et placez-vous dedans :

forge new carnet-de-notes
cd carnet-de-notes

Une base MariaDB est nécessaire dès ce palier.
Voir Préparer MariaDB si ce n'est pas déjà fait.

Documentations

Pour bien comprendre ce palier :

Document	Ce qu'il apporte
Migrations SQL	comment créer la table `notes` et appliquer la migration

Migrations

Avant la première migration, initialisez la base de données (une seule fois pour ce mini-projet) :

forge db:init

forge db:init crée la base, l'utilisateur applicatif et la table forge_migrations qui enregistre les migrations déjà appliquées.
Sans cette étape, forge migration:apply n'a ni base ni table de suivi et échoue.

Générez ensuite le fichier de migration ; Forge l'horodate pour vous :

forge migration:make create_notes

Forge crée mvc/migrations/<timestamp>_create_notes.sql.
Ouvrez ce fichier et placez-y le SQL suivant :

CREATE TABLE IF NOT EXISTS notes (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    content VARCHAR(255) NOT NULL,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

INSERT INTO notes (content)
SELECT seed.content FROM (
    SELECT 'Première note' AS content
    UNION ALL SELECT 'Deuxième note'
    UNION ALL SELECT 'Troisième note'
) AS seed
WHERE NOT EXISTS (SELECT 1 FROM notes);

L'INSERT est idempotent : il ne pose les notes de départ que si la table est vide, donc rejouer la migration ne crée pas de doublon.
Appliquez la migration avec forge migration:apply avant de tester.

Contrôleurs

Créez le fichier mvc/controllers/note_controller.py :

# mvc/controllers/note_controller.py
from core.database.db import fetch_all
from core.http.request import Request
from core.http.response import Response
from core.mvc.controller.base_controller import BaseController

SELECT_ALL = "SELECT id, content FROM notes ORDER BY id"


class NoteController(BaseController):

    @staticmethod
    def index(request: Request) -> Response:
        notes = fetch_all(SELECT_ALL)
        return BaseController.render(
            "note/index.html",
            request=request,
            context={"notes": notes},
        )

Élément	Rôle
`fetch_all(SELECT_ALL)`	Exécute le `SELECT` et retourne une liste de dictionnaires, une entrée par ligne (là où `fetch_one` ne renvoie qu'une ligne ou `None`).
`SELECT id, content FROM notes ORDER BY id`	Le SQL reste visible, déclaré comme une constante de module, sans ORM.

Vues

Créez la vue mvc/views/note/index.html :

<!-- mvc/views/note/index.html -->
<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="utf-8">
    <title>Carnet de notes</title>
</head>
<body>
    <h1>Mes notes</h1>

    {% if notes %}
    <ul>
        {% for note in notes %}
        <li>#{{ note.id }} : {{ note.content }}</li>
        {% endfor %}
    </ul>
    {% else %}
    <p>Aucune note en base.</p>
    {% endif %}
</body>
</html>

La vue boucle sur la liste avec {% for note in notes %} et gère le cas d'une table vide avec {% if notes %}.

Routes

Ajoutez l'import du contrôleur et la route /note dans mvc/routes.py :

# mvc/routes.py
from core.http.router import Router
from mvc.controllers.home_controller import HomeController
from mvc.controllers.note_controller import NoteController

router = Router()

with router.group("", public=True) as public:
    public.add("GET", "/", HomeController.index, name="home-index")
    public.add("GET", "/note", NoteController.index, name="note-index")

Tests

URL	Résultat
`https://localhost:8000/note`	la liste des trois notes de départ

À retenir

fetch_all renvoie une liste de lignes ; fetch_one renvoie une ligne.
Une table se crée par une migration appliquée avec forge migration:apply.
Une vue affiche une collection avec {% for %} ; pensez au cas vide.

Au palier suivant, nous factorisons l'enveloppe HTML de cette page dans un gabarit partagé.

Continuer avec Héritage de gabarit