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).
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.
editor.save()💾 Créer un fichier de sauvegardeSnapshot(text)🔒 Une sauvegarde scellée qu'on ne peut pas modifiereditor.text = "changed"🎮 Continuer à jouer et changer des choseseditor.restore(saved)⏪ Charger la sauvegarde : retour à draftLe 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
Snapshotest une dataclass figée, donc un instantané enregistré ne peut plus être modifié.save()crée unSnapshotavec le texte actuel.- Le texte est ensuite changé en
"changed". 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
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)
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.
- Remplacez le domaine de l’exemple tout en conservant la structure du pattern.
- Comparez le pattern à une implémentation plus simple et expliquez les compromis.
- Écrivez des tests pour chaque participant avant d’ajouter une autre implémentation.
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.
def save(self):
return Snapshot(self.lines) # same list
def save(self):
return Snapshot(list(self.lines)) # a copy
Leçon terminée ?
Marquez-la comme apprise pour suivre votre progression.