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

CKTIS / Python

Associer et retirer des gestionnaires de journalisation avec addHandler

Consultez les gestionnaires directement associés à un journaliseur, ajoutez un gestionnaire configuré avec `addHandler()` et videz la liste via `removeHandler()` sans la modifier directement.

Version : Python 3.12

Syntaxe

logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)

# Detach all directly attached handlers during controlled reconfiguration:
for handler in tuple(logger.handlers):
    logger.removeHandler(handler)

Dans Python 3.12, logger.handlers contient les gestionnaires directement associés à ce journaliseur, pas ceux de ses ancêtres. Vous pouvez consulter la liste, par exemple avec len(logger.handlers), mais traitez-la comme une liste en lecture seule. logger.addHandler(handler) associe une instance existante de logging.Handler, par exemple un logging.StreamHandler ; cet appel ne journalise aucun message à lui seul.

N’utilisez pas logger.handlers.clear() : cet appel vide la liste, mais contourne les verrous employés par addHandler() et removeHandler(). Lors d’une reconfiguration maîtrisée, parcourez tuple(logger.handlers) et appelez logger.removeHandler(handler) pour chaque élément. La copie évite de parcourir la liste que vous modifiez, mais ne rend pas l’ensemble de l’opération atomique. Retirer un gestionnaire ne le ferme pas ; appelez handler.close() séparément si vous en êtes responsable et qu’il n’est plus utilisé.

Si propagate est activé, un enregistrement peut aussi atteindre les gestionnaires des journaliseurs ancêtres, ce qui peut produire des doublons. logger.propagate = False bloque cette transmission. Une liste de gestionnaires directs vide ne garantit pas l’absence de sortie : si aucun gestionnaire n’est trouvé le long du chemin de propagation, logging.lastResort peut traiter l’enregistrement.

Exemples

import logging
import sys

logger = logging.getLogger("cktis.lesson27")
logger.setLevel(logging.INFO)
logger.propagate = False

console = logging.StreamHandler(sys.stdout)
console.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))

print(len(logger.handlers))
try:
    logger.addHandler(console)
    print(len(logger.handlers))
    logger.info("ready")
finally:
    for attached in tuple(logger.handlers):
        logger.removeHandler(attached)
    console.close()

print(len(logger.handlers))

Résultat

0
1
INFO: ready
0

Exécutez le script dans un nouveau processus Python 3.12. Les nombres `0`, `1` et `0` indiquent le nombre de gestionnaires directs avant l’ajout, après l’ajout et après le retrait. Le gestionnaire écrit `INFO: ready` sur la sortie standard.

Leçons associées

  • Python · Leçon 27 · Avancé · Version : 5

Sources