Après cette leçon, tu seras capable de :

• Distinguer les attributs appartenant à la classe des attributs appartenant à chaque instance.
• Lire et mettre à jour un paramètre partagé de classe sans écraser accidentellement un seul objet.
• Reconnaître comment un attribut d'instance peut masquer un attribut de classe portant le même nom.
• Éviter de partager accidentellement des listes modifiables entre instances en les créant dans __init__.

Un attribut d'instance est stocké sur un objet particulier, généralement affecté dans __init__ sous la forme self.name = name. Un attribut de classe est écrit dans le corps de la classe et est partagé comme valeur par défaut par chaque instance de cette classe :

class Worker:
    region = "eu"

    def __init__(self, name):
        self.name = name

Worker.region lit le paramètre de classe. worker.region le lit également jusqu'à ce que cet objet particulier possède son propre attribut region. Si tu affectes worker.region = "us", cet objet masque désormais le paramètre de classe ; cela ne met pas à jour les autres workers.

Pour une configuration véritablement partagée, mets à jour Worker.region (la classe), et non une seule instance. Pour l'état propre à chaque objet tel que le nom d'un worker, ses tentatives ou son historique d'événements, utilise self.attribute dans __init__.

Piège important lié à l'état modifiable : une liste définie dans le corps de la classe peut être partagée par toutes les instances. Si chaque instance a besoin de sa propre liste, crée self.events = [] dans le constructeur.

1. Un attribut de classe fournit un paramètre partagé

class ApiClient:
    scheme = "https"

    def __init__(self, service):
        self.service = service

first = ApiClient("users")
second = ApiClient("billing")
print(f"{first.service}: {first.scheme}")
print(f"{second.service}: {second.scheme}")

Sortie :

users: https
billing: https

Les deux objets lisent le même paramètre de classe tout en conservant leurs propres noms de service.

2. Modifier le paramètre de classe affecte les instances non masquées

class Job:
    mode = "safe"

first = Job()
second = Job()
Job.mode = "fast"
print(first.mode)
print(second.mode)

Sortie :

fast
fast

Aucune instance ne définit son propre mode, donc les deux lisent toujours l'attribut de classe.

3. L'affectation sur une instance masque le paramètre de classe

class Storage:
    tier = "standard"

primary = Storage()
backup = Storage()
primary.tier = "premium"
print(primary.tier)
print(backup.tier)
print(Storage.tier)

Sortie :

premium
standard
standard

primary.tier est devenu un attribut d'instance ; la valeur par défaut partagée de la classe est restée inchangée.

4. Conserver des listes d'événements modifiables distinctes

class Monitor:
    def __init__(self, name):
        self.name = name
        self.events = []

    def record(self, event):
        self.events.append(event)

api = Monitor("api")
queue = Monitor("queue")
api.record("started")
print(api.events)
print(queue.events)

Sortie :

['started']
[]

Chaque appel de constructeur crée une nouvelle liste pour un moniteur donné.

• obj.setting = value ne modifie pas ClassName.setting ; cela crée ou met à jour un attribut d'instance.
• Une liste déclarée comme attribut de classe est une liste unique à moins que chaque instance ne la remplace par sa propre liste.
• Affecter self.name dans le corps de la classe n'est pas ainsi que fonctionne l'initialisation d'instance ; utilise __init__.
• Un attribut de classe n'est approprié que lorsque son comportement partagé est délibéré.