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 = Falselogging.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