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