CKTIS / Python
Gestionnaires d’un logger : consulter, détacher et attacher
Dans Python 3.12, `logger.handlers` ne montre que les gestionnaires attachés directement au logger. Consultez la liste et modifiez-la avec `addHandler()` et `removeHandler()`.
Version : Python 3.12
Syntaxe
logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)
# Detach every handler in the snapshot of this logger's direct attachments.
for handler in list(logger.handlers):
logger.removeHandler(handler)logging.Logger.handlers est un attribut d’instance : il contient la liste des gestionnaires attachés directement à ce logger. Il ne contient pas ceux des loggers ancêtres et ne désigne pas le module logging.handlers. len(logger.handlers) ne compte que les gestionnaires attachés directement.
Traitez la liste comme si elle était en lecture seule. Appelez logger.addHandler(handler) pour attacher un gestionnaire et logger.removeHandler(handler) pour le détacher. N’utilisez ni logger.handlers.clear(), ni append(), ni une affectation : ces opérations contournent les verrous employés par les méthodes. Pour vider la liste, parcourez une copie, list(logger.handlers), et appelez removeHandler() pour chaque élément. La copie évite de modifier la liste que vous parcourez, mais l’opération complète n’est pas atomique.
Détacher un gestionnaire ne le ferme pas. Appelez séparément handler.close() pour un gestionnaire dont vous êtes responsable lorsqu’il n’est plus utilisé nulle part. Ne le fermez pas simplement parce que vous l’avez détaché d’un logger : il peut encore être partagé.
Une liste vide ne garantit pas l’absence de sortie. logger.hasHandlers() examine aussi les loggers ancêtres accessibles par propagation ; il vérifie la présence d’un gestionnaire, pas l’émission d’un enregistrement précis. logger.propagate = False arrête la transmission aux ancêtres. Si aucun gestionnaire n’est trouvé sur ce parcours, logging.lastResort peut intervenir ; par défaut, il écrit les enregistrements de niveau WARNING ou supérieur sur la sortie d’erreur standard.
Exemples
import logging
import sys
logger = logging.getLogger('cktis.lesson27')
logger.setLevel(logging.INFO)
logger.propagate = False
old_handler = logging.NullHandler()
logger.addHandler(old_handler)
print('before:', len(logger.handlers))
for handler in list(logger.handlers):
logger.removeHandler(handler)
old_handler.close()
print('cleared:', len(logger.handlers))
new_handler = logging.StreamHandler(sys.stdout)
new_handler.setFormatter(logging.Formatter('%(message)s'))
logger.addHandler(new_handler)
try:
print('attached:', len(logger.handlers))
logger.info('ready')
finally:
logger.removeHandler(new_handler)
new_handler.close()Résultat
before: 1 cleared: 0 attached: 1 ready
Exécutez l’exemple dans un nouveau processus. Les compteurs indiquent un gestionnaire attaché directement, une liste vide, puis un gestionnaire de remplacement. Le nouveau `StreamHandler` écrit `ready`, puis le bloc `finally` le détache et le ferme.
Leçons associées
- Python · Leçon 27 · Avancé · Version : 5
Sources
- Python 3.12 logging reference: Logger.handlers
- Python 3.12 logging reference: Logger.addHandler
- Python 3.12 logging reference: Logger.removeHandler
- Python 3.12 logging reference: Logger.propagate
- Python 3.12 logging reference: Logger.hasHandlers
- Python 3.12 logging reference: Handler.close
- Python 3.12 logging reference: logging.lastResort
- Python 3.12 logging handlers reference: StreamHandler
- Python 3.12 logging handlers reference: NullHandler