CKTIS / Python
Handler di un logger: consultare, scollegare e collegare
In Python 3.12, `logger.handlers` mostra solo gli handler collegati direttamente al logger. Consulta la lista e usa `addHandler()` e `removeHandler()` per modificarla.
Versione: Python 3.12
Sintassi
logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)
# Detach every handler in the snapshot of this logger's direct attachments.
for handler in list(logger.handlers):
logger.removeHandler(handler)logging.Logger.handlers è un attributo di istanza che contiene la lista degli handler collegati direttamente a quel logger. Non comprende gli handler dei logger antenati e non è il modulo logging.handlers. len(logger.handlers) conta solo i collegamenti diretti.
Tratta la lista come se fosse di sola lettura. Usa logger.addHandler(handler) per collegare un handler e logger.removeHandler(handler) per scollegarlo. Non usare logger.handlers.clear(), append() o un’assegnazione: queste operazioni aggirano i lock usati dai metodi. Per svuotare la lista, itera su una copia, list(logger.handlers), e chiama removeHandler() per ogni elemento. La copia evita di modificare la lista che stai scorrendo, ma l’intera operazione non è atomica.
Scollegare un handler non lo chiude. Chiama separatamente handler.close() per un handler che gestisci quando non serve più da nessuna parte. Non chiuderlo solo perché l’hai scollegato da un logger: potrebbe essere ancora condiviso.
Una lista vuota non significa che non ci sarà output. logger.hasHandlers() cerca anche nei logger antenati raggiungibili per propagazione: verifica la presenza di un handler, non l’emissione di un record specifico. logger.propagate = False interrompe l’inoltro agli antenati. Se non si trova alcun handler lungo quel percorso, può intervenire logging.lastResort, che per impostazione predefinita scrive i record di livello WARNING o superiore sullo standard error.
Esempi
import logging
import sys
logger = logging.getLogger('cktis.lesson27')
logger.setLevel(logging.INFO)
logger.propagate = False
old_handler = logging.NullHandler()
logger.addHandler(old_handler)
print('before:', len(logger.handlers))
for handler in list(logger.handlers):
logger.removeHandler(handler)
old_handler.close()
print('cleared:', len(logger.handlers))
new_handler = logging.StreamHandler(sys.stdout)
new_handler.setFormatter(logging.Formatter('%(message)s'))
logger.addHandler(new_handler)
try:
print('attached:', len(logger.handlers))
logger.info('ready')
finally:
logger.removeHandler(new_handler)
new_handler.close()Risultato
before: 1 cleared: 0 attached: 1 ready
Esegui l’esempio in un nuovo processo. I conteggi mostrano un handler collegato direttamente, una lista vuota e un handler sostitutivo. Il nuovo `StreamHandler` scrive `ready` e il blocco `finally` lo scollega e lo chiude.
Lezioni correlate
- Python · Lezione 27 · Avanzato · Versione: 5
Fonti
- Python 3.12 logging reference: Logger.handlers
- Python 3.12 logging reference: Logger.addHandler
- Python 3.12 logging reference: Logger.removeHandler
- Python 3.12 logging reference: Logger.propagate
- Python 3.12 logging reference: Logger.hasHandlers
- Python 3.12 logging reference: Handler.close
- Python 3.12 logging reference: logging.lastResort
- Python 3.12 logging handlers reference: StreamHandler
- Python 3.12 logging handlers reference: NullHandler