Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Collegare e scollegare i gestori di logging con addHandler

Ispeziona i gestori collegati direttamente a un logger, aggiungi un gestore configurato con `addHandler()` e svuota la lista tramite `removeHandler()` senza modificarla direttamente.

Versione: Python 3.12

Sintassi

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)

In Python 3.12, logger.handlers contiene i gestori collegati direttamente a quel logger, non quelli dei suoi antenati. Puoi consultare la lista, ad esempio con len(logger.handlers), ma trattala come di sola lettura. logger.addHandler(handler) collega un'istanza esistente di logging.Handler, come un logging.StreamHandler; la chiamata non registra di per sé alcun messaggio.

Non usare logger.handlers.clear(): svuota la lista, ma aggira i meccanismi di blocco usati da addHandler() e removeHandler(). Durante una riconfigurazione controllata, scorri tuple(logger.handlers) e chiama logger.removeHandler(handler) per ciascun elemento. La copia evita di scorrere la lista che stai modificando, ma non rende atomica l'intera operazione. Scollegare un gestore non lo chiude; chiama handler.close() separatamente se ne sei responsabile e non è più in uso.

Se propagate è attivo, un record può raggiungere anche i gestori dei logger antenati, producendo eventualmente un output duplicato. logger.propagate = False interrompe l'inoltro agli antenati. Una lista vuota di gestori diretti non garantisce l'assenza di output: se lungo il percorso di propagazione non viene trovato alcun gestore, logging.lastResort può elaborare il record.

Esempi

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

Risultato

0
1
INFO: ready
0

Esegui lo script in un nuovo processo Python 3.12. I valori `0`, `1` e `0` indicano quanti gestori diretti sono presenti prima del collegamento, dopo il collegamento e dopo la rimozione. Il gestore scrive `INFO: ready` sullo standard output.

Lezioni correlate

  • Python · Lezione 27 · Avanzato · Versione: 5

Fonti