CKTIS / Python
Добавяне на обработчик и спиране на разпространението на записи
С `addHandler()` добавяте обработчик към конкретен логер, а с `propagate = False` спирате предаването на записи към обработчиците на по-горните логери, включително кореновия.
Версия: Python 3.12
Синтаксис
logger.addHandler(hdlr)
logger.propagate = Falselogging.Logger.addHandler добавя съществуващ обект обработчик към конкретен логер. Вземете логера с logging.getLogger(name) и подайте на logger.addHandler(hdlr) обект, например екземпляр на logging.StreamHandler, а не самия клас. Обработчикът определя къде отива записът, а неговият форматер определя вида на текста. За да откачите обработчика, извикайте logger.removeHandler(hdlr), вместо да променяте директно logger.handlers.
Логерът, в който възниква записът, първо прилага ефективното си ниво и собствените си филтри. Приетият запис се подава на локалните обработчици, а при настройката по подразбиране propagate = True — и на обработчиците на всеки следващ логер нагоре в йерархията, освен ако предаването не спре по пътя. Нивата и филтрите на по-горните логери не се проверяват при предаването, но всеки обработчик продължава да прилага собствения си праг и филтри.
logger.propagate = False спира предаването нагоре, след като локалните обработчици са имали възможност да обработят записа. Това не изключва логера и не променя настройките на кореновия логер: никой обработчик по-нагоре в този клон не получава записа. Ако локалните обработчици и тези по-нагоре пишат на едно и също място, резултатът може да изглежда като дублиране. Ако е достатъчно едно общо място за запис, добавете обработчика само към подходящия по-горен логер и оставете предаването включено.
Примери
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")
Резултат
local: first root: first local: second
Стартирайте скрипта в нов процес на Python 3.12. `first` се появява два пъти: с `local:` и с `root:`. Нивото `WARNING` на кореновия логер не спира предадения запис `INFO`, защото записът отива директно при неговия обработчик. След спиране на предаването `second` се появява само с `local:`.
Свързани уроци
- Python · Урок 24 · Средно · Версия: 3