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 = Falselogging.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