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

CKTIS / Python

Associer un gestionnaire de journalisation et arrêter la propagation

Utilisez `addHandler()` pour associer un gestionnaire à un journaliseur précis, puis `propagate = False` pour empêcher la transmission aux gestionnaires des journaliseurs ancêtres, y compris le journaliseur racine.

Version : Python 3.12

Syntaxe

logger.addHandler(hdlr)
logger.propagate = False

logging.Logger.addHandler associe un objet gestionnaire existant à un journaliseur précis. Récupérez le journaliseur avec logging.getLogger(name) et passez à logger.addHandler(hdlr) un objet tel qu’une instance de logging.StreamHandler, et non la classe elle-même. Le gestionnaire détermine la destination et son formateur détermine la présentation du texte. Pour le détacher, appelez logger.removeHandler(hdlr) au lieu de modifier directement logger.handlers.

Le journaliseur d’origine applique d’abord son niveau effectif et ses propres filtres. Un enregistrement accepté est proposé aux gestionnaires locaux et, avec propagate = True par défaut, à ceux des journaliseurs ancêtres successifs tant que la propagation n’est pas interrompue. Les niveaux et les filtres de ces journaliseurs ancêtres ne sont alors pas consultés, mais chaque gestionnaire applique toujours son propre seuil et ses propres filtres.

logger.propagate = False arrête la remontée après que les gestionnaires locaux ont eu la possibilité de traiter l’enregistrement. Cela ne désactive pas le journaliseur et ne reconfigure pas le journaliseur racine : aucun gestionnaire situé plus haut dans cette branche ne reçoit l’enregistrement. Si des gestionnaires locaux et ancêtres écrivent vers la même destination, la propagation peut donner l’impression de doublons. Si une destination commune suffit, associez le gestionnaire uniquement à l’ancêtre approprié et laissez la propagation activée.

Exemples

import logging
import sys

logging.basicConfig(
    level=logging.WARNING,
    stream=sys.stdout,
    format="root: %(message)s",
)

logger = logging.getLogger("cktis.demo")
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("local: %(message)s"))
logger.addHandler(handler)

logger.info("first")
logger.propagate = False
logger.info("second")

Résultat

local: first
root: first
local: second

Exécutez le script dans un nouveau processus Python 3.12. `first` apparaît deux fois, avec `local:` puis `root:`. Le niveau `WARNING` du journaliseur racine ne bloque pas l’enregistrement `INFO` transmis, car celui-ci est remis directement à son gestionnaire. Une fois la propagation désactivée, `second` apparaît uniquement avec `local:`.

Leçons associées

  • Python · Leçon 24 · Intermédiaire · Version : 3

Sources