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

CKTIS / Python

Associar um handler e interromper a propagação

Usa `addHandler()` para associar um handler a um logger específico e `propagate = False` para impedir que os registos cheguem aos handlers dos loggers antecessores, incluindo o logger raiz.

Versão: Python 3.12

Sintaxe

logger.addHandler(hdlr)
logger.propagate = False

logging.Logger.addHandler associa um objeto handler existente a um logger específico. Obtém o logger com logging.getLogger(name) e passa a logger.addHandler(hdlr) um objeto, por exemplo uma instância de logging.StreamHandler, e não a própria classe. O handler determina o destino e o seu formatador determina o aspeto do texto. Para desassociar o handler, chama logger.removeHandler(hdlr) em vez de alterares diretamente logger.handlers.

O logger de origem aplica primeiro o seu nível efetivo e os seus próprios filtros. Um registo aceite é encaminhado para os handlers locais e, com a predefinição propagate = True, para os handlers dos sucessivos loggers antecessores, a menos que a propagação seja interrompida. Durante o encaminhamento, não são consultados os níveis nem os filtros dos loggers antecessores, mas cada handler continua a aplicar o seu próprio limiar e os seus próprios filtros.

logger.propagate = False interrompe o encaminhamento para níveis acima desse logger depois de os handlers locais terem tido a oportunidade de processar o registo. Não desativa o logger nem altera a configuração do logger raiz: nenhum handler mais acima nesse ramo recebe o registo. Se os handlers locais e os dos antecessores escreverem no mesmo destino, a propagação pode dar origem a entradas aparentemente duplicadas. Se bastar um destino partilhado, associa o handler apenas ao antecessor adequado e mantém a propagação ativa.

Exemplos

import logging
import sys

logging.basicConfig(
    level=logging.WARNING,
    stream=sys.stdout,
    format="root: %(message)s",
)

logger = logging.getLogger("cktis.demo")
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("local: %(message)s"))
logger.addHandler(handler)

logger.info("first")
logger.propagate = False
logger.info("second")

Resultado

local: first
root: first
local: second

Executa o script num novo processo do Python 3.12. `first` aparece duas vezes, com `local:` e com `root:`. O nível `WARNING` do logger raiz não bloqueia o registo `INFO` encaminhado, porque este é entregue diretamente ao respetivo handler. Depois de desativares a propagação, `second` aparece apenas com `local:`.

Lições relacionadas

  • Python · Lição 24 · Intermédio · Versão: 3

Fontes