База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

`logging.Logger.propagate`: препращане на записи в журнала

`propagate` определя дали записът достига и до обработчиците на по-горните логъри. `False` спира препращането нагоре, без да изключва локалните обработчици.

Версия: Python 3.12

Синтаксис

logger.addHandler(handler)
logger.propagate = False  # Stop forwarding to ancestor handlers.
logger.propagate = True   # Allow forwarding to ancestor handlers.

В Python 3.12 propagate е атрибут на екземпляр на logging.Logger, а не метод. Стойността по подразбиране е True. Извикването на logger.addHandler(handler) добавя обработчик директно към този логър, без да променя propagate.

Ако събитието премине проверката за ефективно ниво и филтрите на изходния логър, записът първо се подава на неговите обработчици. При True препращането продължава нагоре в йерархията от имена, разделени с точки, и може да стигне до кореновия логър. Ако някой логър по веригата има propagate = False, неговите собствени обработчици все още могат да обработят записа, но тези над него не го получават.

При препращане нивата и филтрите на по-горните логъри не се проверяват повторно. Нивото и филтрите на всеки обработчик продължават да се прилагат. Това е различно от наследяването на ефективното ниво: ако изходният логър не е кореновият и е с ниво NOTSET, ефективният му праг се определя по йерархията преди препращането.

Ако локален обработчик и обработчик на по-горен логър пишат на едно и също място, може да се появят дублирани записи. Настрой обработчици само на подходящ по-горен логър или добави локален обработчик и задай logger.propagate = False, за да отделиш изхода му. Само False не гарантира липса на изход: ако по пътя няма нито един обработчик, logging.lastResort може да изведе записи с ниво WARNING или по-високо.

Примери

import logging
import sys


def console_handler(label):
    handler = logging.StreamHandler(sys.stdout)
    handler.setLevel(logging.INFO)
    handler.setFormatter(logging.Formatter(f"{label}: %(message)s"))
    return handler


root = logging.getLogger()
root.setLevel(logging.ERROR)
root.addHandler(console_handler("root"))

logger = logging.getLogger("checkout")
logger.setLevel(logging.INFO)
logger.addHandler(console_handler("checkout"))

logger.propagate = True
logger.info("order received")

logger.propagate = False
logger.info("order saved")

Резултат

checkout: order received
root: order received
checkout: order saved

И двата обработчика извеждат първия запис с ниво `INFO`. Обработчикът на кореновия логър го приема, въпреки че самият коренов логър е настроен на `ERROR`. След задаване на `False` само обработчикът на `checkout` извежда втория запис.

Свързани уроци

  • Python · Урок 24 · Средно · Версия: 3

Източници