La façade Flash

Objectif : regrouper les messages flash (un message affiché une seule fois,
puis consommé) sous une façade Flash.

Ce que vous allez apprendre : poser un message flash dans la session et le
lire ; comprendre pourquoi le flash est une préoccupation distincte de la
session brute, même s'il vit dans la session.

Là où nous en sommes

Vous avez _facade.py, session.py et cookies.py. Nous ajoutons la dernière
façade du parcours.

L'ajout

Créez mvc/helpers/flash.py :

# mvc/helpers/flash.py
"""Façade de confort pour les messages flash (helper applicatif)."""

from core.security.session import get_flash as _get_flash
from core.security.session import set_flash as _set_flash
from mvc.helpers._facade import Facade


class Flash(Facade):

    @staticmethod
    def set(session_id: str, message: str, level: str = "success") -> None:
        _set_flash(session_id, message, level)

    @staticmethod
    def get(session_id: str) -> dict | None:
        return _get_flash(session_id)

Comprendre ce code

• Un message flash est un message à usage unique : on le pose lors d'une
  action (« Enregistré », « Erreur »), il est affiché au chargement suivant, puis
  supprimé automatiquement. C'est le motif classique après un POST/redirect.
• set stocke {message, level} dans la session ; level
  ("success", "error", "warning"…) sert à choisir le style d'affichage.
• get lit et supprime le message d'un coup (lecture one-shot) : un
  second get renvoie None. C'est ce qui garantit qu'il n'apparaît qu'une fois.
• Pourquoi une façade à part : le flash vit dans la session, mais c'est une
  préoccupation différente (un message UI éphémère, pas l'état de session). Le
  séparer de Session garde chaque façade centrée sur un seul rôle ; c'est aussi
  pour ça qu'on ne l'avait pas mis dans Session.
• Le flash a besoin d'une session existante : on lui passe le session_id
  (obtenu via Session.current_id / Session.new).

Tester

Dans un shell Python du projet :

>>> from mvc.helpers.session import Session
>>> from mvc.helpers.flash import Flash
>>> sid = Session.new()
>>> Flash.set(sid, "Enregistré", "success")
>>> Flash.get(sid)
{'message': 'Enregistré', 'level': 'success'}
>>> Flash.get(sid)          # déjà consommé : plus rien
>>>

Le second appel ne renvoie rien (None) : le message est à usage unique.

À retenir

• Flash gère des messages à usage unique : set pose, get lit et
  supprime.
• Le flash vit dans la session, mais reste une façade distincte (un rôle =
  une façade).
• Il exige un session_id, fourni par Session.

Au palier suivant, nous câblons tout : l'import unique et l'usage en contrôleur.

Continuer avec Imports et usage