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

CKTIS / Python

logging.Handler.setFormatter — задаване на форматиращ обект за handler

`logging.Handler.setFormatter` задава форматиращ обект за handler или го премахва при подаване на `None`. Методът управлява представянето на изхода, а не прага на нивото за логване.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) задава форматиращ обект за конкретен handler. Методът не проверява дали fmt е екземпляр на logging.Formatter. Стандартната реализация на Handler.format(record) може да използва и друг обект, ако той се оценява като истина в булев контекст и предоставя съвместим метод format(record). Сам по себе си низът за форматиране не може да замени форматиращия обект. Например използвай handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

Извикването handler.setFormatter(None) премахва присвоения форматиращ обект. Когато handler използва Handler.format(record), след това се прилага форматиращият обект по подразбиране на модула: обикновеното съобщение не получава префикс с нивото или името на logger-а. Това не изключва логването.

Форматиращият обект управлява представянето на записа; праговете на нивата и филтрите определят обработката му. Настройката важи за този handler, а не за всички handler-и на logger-а. Изходният шаблон на форматиращия обект е отделен от интерполацията на аргументите на съобщението, например в logger.info("Items: %s", 3).

Примерът прихваща изхода в io.StringIO, първо с персонализиран формат, а след това след премахването му. Пропуска времевите отметки и конфигурацията на root logger-а, за да бъде резултатът детерминиран.

Примери

import io
import logging

stream = io.StringIO()
handler = logging.StreamHandler(stream)
logger = logging.getLogger("demo")
logger.setLevel(logging.INFO)
logger.propagate = False
logger.addHandler(handler)

handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s"))
logger.info("Items: %s", 3)

handler.setFormatter(None)
logger.info("Items: %s", 3)

print(stream.getvalue(), end="")
logger.removeHandler(handler)
handler.close()

Резултат

INFO | Items: 3
Items: 3

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници