Patrons de conception Python

Le patron de conception Memento en Python

Dans cette leçon, vous allez utiliser le patron Memento pour sauvegarder et restaurer l'état d'un objet, comme une fonction annuler (undo).

  • Avancé
  • 3 min de lecture
  • 1 exemple exécutable

Introduction

Le problème

Annuler, les points de sauvegarde dans les jeux et « restaurer les valeurs par défaut » ont tous besoin d'enregistrer l'état d'un objet et de le restaurer plus tard, sans qu'un autre code fouille dans les détails internes de l'objet.

Imaginez-le ainsi

Le pattern Memento, c'est comme sauvegarder une partie. Le jeu crée un fichier de sauvegarde contenant son état ; vous gardez ce fichier sans avoir besoin de comprendre ce qu'il contient. Plus tard, charger la sauvegarde remet le jeu exactement où il en était.

De la sauvegarde de partie au code
editor.save()💾 Créer un fichier de sauvegarde
Snapshot(text)🔒 Une sauvegarde scellée qu'on ne peut pas modifier
editor.text = "changed"🎮 Continuer à jouer et changer des choses
editor.restore(saved)⏪ Charger la sauvegarde : retour à draft
Enregistrez un instantané, changez des choses, restaurez l'instantané.
En une phrase

Le pattern Memento capture l'état d'un objet dans un objet instantané qui pourra le restaurer plus tard, sans exposer les détails internes de l'objet au code qui stocke l'instantané.

Points clés

  1. Snapshot est une dataclass figée, donc un instantané enregistré ne peut plus être modifié.
  2. save() crée un Snapshot avec le texte actuel.
  3. Le texte est ensuite changé en "changed".
  4. restore(saved) remet le texte enregistré, donc "draft" est affiché.

Quand l’utiliser ?

  • Annuler et rétablir dans les éditeurs et outils de dessin.
  • Les points de sauvegarde et les parties sauvegardées.
  • Revenir en arrière après une opération échouée.

Quand s'en passer

  • Les très gros états sauvegardés souvent : les instantanés consomment beaucoup de mémoire ; ne stockez que les changements.
  • Les valeurs simples : stocker une copie de la variable suffit.

Code d’exemple

Exécuter le code →
main.py
from dataclasses import dataclass


@dataclass(frozen=True)
class Snapshot:
    # Memento: store a restorable snapshot without exposing internals.
    text: str


class Editor:
    def __init__(self): self.text = ""
    def save(self): return Snapshot(self.text)

    def restore(self, snapshot):
        # Restore state without exposing representation details.
        self.text = snapshot.text


editor = Editor()
editor.text = "draft"
saved = editor.save()
editor.text = "changed"
editor.restore(saved)
print(editor.text)
Obtenir un bouton Run pour cet exemple

Résultat de l’exécution

draft

Explication du code

La méthode save() d'Editor crée un instantané contenant le contenu actuel, draft. Après que le contenu est passé à changed, la méthode restore() récupère le contenu de l'instantané enregistré, c'est pourquoi le résultat affiché est draft.

Modifiez les valeurs et exécutez le programme avec le compilateur Python en ligne CodeUtility, sans installation locale.

Exercices d’approfondissement

Essayez de modifier le code en suivant les pistes ci-dessous. Changer le code et observer le résultat vous fera bien mieux comprendre la leçon que la simple lecture.

  1. Remplacez le domaine de l’exemple tout en conservant la structure du pattern.
  2. Comparez le pattern à une implémentation plus simple et expliquez les compromis.
  3. Écrivez des tests pour chaque participant avant d’ajouter une autre implémentation.
Exécuter dans le compilateur Python →

Erreurs fréquentes

Enregistrer une référence vers un état mutable

Si l'instantané contient la même liste que l'éditeur continue de modifier, l'état enregistré change aussi.

Problème
def save(self):
    return Snapshot(self.lines)  # same list
Correction
def save(self):
    return Snapshot(list(self.lines))  # a copy

Leçon terminée ?

Marquez-la comme apprise pour suivre votre progression.