Patrons de conception Python

Le patron de conception Singleton en Python

Dans cette leçon, vous allez implémenter le patron Singleton pour garantir qu'une classe n'ait qu'un seul objet partagé.

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

Introduction

Le problème

Certaines choses ne doivent exister qu'une fois dans un programme : les réglages de l'application, un pool de connexions, un logger qui écrit dans un seul fichier. Si chaque partie du code crée sa propre copie, les réglages divergent et des ressources sont gaspillées.

Imaginez-le ainsi

Un singleton est comme l'unique sonnerie d'une école. Chaque classe utilise la même sonnerie ; personne n'installe la sienne. Demander « la sonnerie » n'importe où vous donne toujours cette sonnerie-là.

De la sonnerie d'école au code
_instance = None🔔 Aucune sonnerie installée pour l'instant
if cls._instance is None:🔧 L'installer à la première demande
return cls._instance🔁 Ensuite, tout le monde reçoit la même sonnerie
first is second✅ Deux demandes, un seul objet : True
Chaque appel renvoie le même objet.
En une phrase

Le pattern Singleton fait qu'une classe renvoie la même instance unique à chaque création, ce qui donne au programme un seul objet partagé.

Points clés

  1. _instance est un attribut de classe qui stocke l'unique objet partagé.
  2. __new__ est la méthode que Python appelle pour créer un objet ; elle ne crée l'objet que si _instance vaut encore None.
  3. cls._instance.theme = "dark" configure une seule fois l'objet partagé.
  4. first is second vaut True : les deux noms désignent exactement le même objet.

Quand l’utiliser ?

  • La configuration de toute l'application, lue par chaque module.
  • Une ressource partagée unique comme un cache, un logger ou un pool de connexions.
  • Apprendre comment __new__ contrôle la création d'objets.

Quand s'en passer

  • La plupart du code Python : un objet au niveau du module (les modules ne sont créés qu'une fois) est plus simple et fait le même travail.
  • Le code que vous voulez tester facilement : un état global caché rend les tests dépendants les uns des autres ; passez plutôt l'objet en argument.

Code d’exemple

Exécuter le code →
main.py
class AppConfig:
    # Singleton: every caller receives one shared configuration object.
    _instance = None

    def __new__(cls):
        # Create the shared instance only on the first call.
        if cls._instance is None:
            cls._instance = super().__new__(cls)
            cls._instance.theme = "dark"
        return cls._instance


first = AppConfig()
second = AppConfig()
print(first is second)
Obtenir un bouton Run pour cet exemple

Résultat de l’exécution

True

Explication du code

La méthode __new__ est appelée avant __init__ à chaque création d'objet. Au premier appel, _instance vaut encore None, l'objet est donc créé et mémorisé. Lors des appels suivants, __new__ renvoie simplement l'objet mémorisé, c'est pourquoi la comparaison des deux objets avec is donne True.

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

Configurer l'état dans __init__

__init__ s'exécute à chaque appel, donc il réinitialise l'objet partagé à chaque fois.

Problème
def __init__(self):
    self.theme = "dark"  # runs again for every AppConfig()
Correction
if cls._instance is None:
    cls._instance = super().__new__(cls)
    cls._instance.theme = "dark"

Leçon terminée ?

Marquez-la comme apprise pour suivre votre progression.

S'entraîner avec un défi

Utilisez le contenu de cette leçon pour résoudre un vrai problème. Chaque défi s'exécute dans le navigateur, avec des tests instantanés et une revue par l'IA.

Tous les défis