Logger

class Logger

Bases: object

Classe du journal d’activité.

Notes

• L’ouverture est idempotente : si un fichier est déjà ouvert, il est fermé avant de rouvrir.

• La fermeture est idempotente : close() peut être appelée plusieurs fois sans erreurs.

• La classe implémente le protocole context manager pour garantir la fermeture.

Attributs

Logger.filename: str = ''

Chemin du fichier de log ouvert (vide si aucun).

Logger.file_handle: TextIO | None

Handle du fichier ouvert (None si fermé).

Méthodes

Divers

Logger.open(filename: str | Path)

Ouvre le fichier de log en mode ajout.

Parameters:

filename (str | Path) – Chemin du fichier de log.

Note

Si un fichier était déjà ouvert, il est fermé avant la réouverture afin d’éviter les handles orphelins (particulièrement problématiques sous Windows).

Logger.close()

Ferme le fichier de log.

Note

Méthode idempotente : peut être appelée plusieurs fois. Force un flush + fsync pour limiter les surprises d’I/O (notamment sous Windows).

Logger.add(msg: str)

Ajoute un message au log.

Parameters:

msg (str)