CKTIS / Python
Associar e remover processadores de registo com addHandler
Consulta os processadores associados diretamente a um logger, acrescenta um processador configurado com `addHandler()` e esvazia a lista através de `removeHandler()`, sem a alterar diretamente.
Versão: Python 3.12
Sintaxe
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)Em Python 3.12, logger.handlers contém os processadores associados diretamente a esse logger, não os dos seus antecessores. Podes consultar a lista, por exemplo com len(logger.handlers), mas trata-a como sendo apenas de leitura. logger.addHandler(handler) associa uma instância existente de logging.Handler, como um logging.StreamHandler; a chamada, por si só, não regista nenhuma mensagem.
Não uses logger.handlers.clear(): esvazia a lista, mas contorna os mecanismos de bloqueio usados por addHandler() e removeHandler(). Durante uma reconfiguração controlada, percorre tuple(logger.handlers) e chama logger.removeHandler(handler) para cada elemento. A cópia evita que percorras a lista que estás a alterar, mas não torna a operação inteira atómica. Remover um processador não o fecha; chama handler.close() separadamente se fores responsável por ele e já não estiver a ser utilizado.
Com propagate ativo, um registo também pode chegar aos processadores dos loggers antecessores, o que pode duplicar a saída. logger.propagate = False impede esse encaminhamento. Uma lista vazia de processadores diretos não garante que não haja saída: se não for encontrado nenhum processador no percurso de propagação, logging.lastResort pode tratar o registo.
Exemplos
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))Resultado
0 1 INFO: ready 0
Executa o script num novo processo de Python 3.12. Os valores `0`, `1` e `0` indicam o número de processadores diretos antes da associação, depois da associação e após a remoção. O processador escreve `INFO: ready` na saída padrão.
Lições relacionadas
- Python · Lição 27 · Avançado · Versão: 5
Fontes
- Logging facility for Python — Logger.handlers
- Logging facility for Python — Logger.addHandler
- Logging facility for Python — Logger.removeHandler
- Logging facility for Python — Logger.propagate
- Logging facility for Python — Handler.close
- Logging facility for Python — logging.lastResort
- Logging handlers — StreamHandler
- Logging Cookbook — Using a context manager for selective logging