Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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