Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Aggiungere un handler e interrompere la propagazione

Usa `addHandler()` per aggiungere un handler a un logger specifico e `propagate = False` per impedire che i record raggiungano gli handler dei logger antenati, incluso il logger radice.

Versione: Python 3.12

Sintassi

logger.addHandler(hdlr)
logger.propagate = False

logging.Logger.addHandler associa un oggetto handler esistente a un logger specifico. Ottieni il logger con logging.getLogger(name) e passa a logger.addHandler(hdlr) un oggetto, per esempio un’istanza di logging.StreamHandler, non la classe stessa. L’handler determina la destinazione e il suo formatter determina l’aspetto del testo. Per scollegare l’handler, chiama logger.removeHandler(hdlr) invece di modificare direttamente logger.handlers.

Il logger di origine applica prima il suo livello effettivo e i suoi filtri. Un record accettato viene sottoposto agli handler locali e, con l’impostazione predefinita propagate = True, agli handler dei logger antenati via via più in alto, finché la propagazione non si arresta. In questa fase non si controllano i livelli né i filtri dei logger antenati, ma ogni handler applica comunque la propria soglia e i propri filtri.

logger.propagate = False interrompe l’inoltro verso l’alto dopo che gli handler locali hanno avuto la possibilità di elaborare il record. Non disattiva il logger e non riconfigura il logger radice: nessun handler situato più in alto nello stesso ramo riceve il record. Se gli handler locali e quelli dei logger antenati scrivono nella stessa destinazione, la propagazione può far apparire voci duplicate. Se basta una destinazione condivisa, aggiungi l’handler solo al logger antenato adatto e lascia attiva la propagazione.

Esempi

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")

Risultato

local: first
root: first
local: second

Esegui lo script in un nuovo processo Python 3.12. `first` compare due volte, con `local:` e con `root:`. Il livello `WARNING` del logger radice non blocca il record `INFO` propagato perché questo arriva direttamente al suo handler. Dopo aver disattivato la propagazione, `second` compare solo con `local:`.

Lezioni correlate

  • Python · Lezione 24 · Intermedio · Versione: 3

Fonti