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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.