Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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