Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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