CKTIS / Python
Handlers do logger: consultar, desassociar e associar
Em Python 3.12, `logger.handlers` mostra apenas os handlers associados diretamente ao logger. Consulte a lista e altere-a com `addHandler()` e `removeHandler()`.
Versão: Python 3.12
Sintaxe
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 é um atributo de instância que contém a lista de handlers associados diretamente a esse logger. Não inclui os handlers dos loggers antecessores e não é o módulo logging.handlers. len(logger.handlers) conta apenas as associações diretas.
Trate a lista como sendo só de leitura. Use logger.addHandler(handler) para associar um handler e logger.removeHandler(handler) para o desassociar. Não use logger.handlers.clear(), append() nem uma atribuição: essas operações contornam os bloqueios usados pelos métodos. Para esvaziar a lista, percorra uma cópia, list(logger.handlers), e chame removeHandler() para cada elemento. A cópia evita que altere a lista que está a percorrer, mas a operação completa não é atómica.
Desassociar um handler não o fecha. Chame handler.close() em separado para um handler que gere quando este já não for necessário em lado nenhum. Não o feche só por o ter desassociado de um logger: pode continuar a ser partilhado.
Uma lista vazia não significa que não haja saída. logger.hasHandlers() também procura nos loggers antecessores alcançáveis por propagação; verifica se existe um handler, não se um registo específico será emitido. logger.propagate = False impede o encaminhamento para os antecessores. Se não for encontrado qualquer handler nesse percurso, logging.lastResort pode intervir; por omissão, escreve os registos de nível WARNING ou superior na saída de erro padrão.
Exemplos
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()Resultado
before: 1 cleared: 0 attached: 1 ready
Execute o exemplo num processo novo. As contagens mostram um handler associado diretamente, uma lista vazia e um handler de substituição. O novo `StreamHandler` escreve `ready`, e o bloco `finally` desassocia-o e fecha-o.
Lições relacionadas
- Python · Lição 27 · Avançado · Versão: 5
Fontes
- 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