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

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