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

CKTIS / Python

Добавяне на обработчик и спиране на разпространението на записи

С `addHandler()` добавяте обработчик към конкретен логер, а с `propagate = False` спирате предаването на записи към обработчиците на по-горните логери, включително кореновия.

Версия: Python 3.12

Синтаксис

logger.addHandler(hdlr)
logger.propagate = False

logging.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

Източници