CKTIS / Python
Обработчици на логер: преглед, премахване и добавяне
В Python 3.12 `logger.handlers` показва само обработчиците, добавени директно към логера. Чети списъка, а го променяй чрез `addHandler()` и `removeHandler()`.
Версия: Python 3.12
Синтаксис
logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)
# Detach every handler in the snapshot of this logger's direct attachments.
for handler in list(logger.handlers):
logger.removeHandler(handler)logging.Logger.handlers е атрибут на инстанция, който съдържа списъка с обработчици, добавени директно към този логер. Той не включва обработчиците на родителските логери и не е модулът logging.handlers. len(logger.handlers) брои само директно добавените обработчици.
Третирай списъка като предназначен само за четене. Използвай logger.addHandler(handler), за да добавиш обработчик, и logger.removeHandler(handler), за да го премахнеш. Не използвай logger.handlers.clear(), append() или присвояване: така заобикаляш заключванията, които методите използват. За да изпразниш списъка, обходи копие, list(logger.handlers), и извикай removeHandler() за всеки елемент. Копието ти позволява да не променяш списъка, който обхождаш, но цялата операция не е атомарна.
Премахването не затваря обработчика. Извикай handler.close() отделно за обработчик, за който отговаряш, когато той вече не е нужен никъде. Не го затваряй само защото си го премахнал от един логер: той може все още да се споделя.
Празният списък не означава липса на изход. logger.hasHandlers() проверява и родителските логери, достижими чрез разпространение на записите. Методът проверява дали има обработчик, а не дали конкретен запис ще бъде изведен. logger.propagate = False спира предаването към родителските логери. Ако по този път не бъде намерен обработчик, може да се използва logging.lastResort, който по подразбиране извежда записи с ниво WARNING или по-високо към стандартния поток за грешки.
Примери
import logging
import sys
logger = logging.getLogger('cktis.lesson27')
logger.setLevel(logging.INFO)
logger.propagate = False
old_handler = logging.NullHandler()
logger.addHandler(old_handler)
print('before:', len(logger.handlers))
for handler in list(logger.handlers):
logger.removeHandler(handler)
old_handler.close()
print('cleared:', len(logger.handlers))
new_handler = logging.StreamHandler(sys.stdout)
new_handler.setFormatter(logging.Formatter('%(message)s'))
logger.addHandler(new_handler)
try:
print('attached:', len(logger.handlers))
logger.info('ready')
finally:
logger.removeHandler(new_handler)
new_handler.close()Резултат
before: 1 cleared: 0 attached: 1 ready
Изпълни примера в нов процес. Броячите показват един директно добавен обработчик, празен списък и един заместващ обработчик. Новият `StreamHandler` извежда `ready`, а блокът `finally` го премахва и затваря.
Свързани уроци
- Python · Урок 27 · Напреднало · Версия: 5
Източници
- Python 3.12 logging reference: Logger.handlers
- Python 3.12 logging reference: Logger.addHandler
- Python 3.12 logging reference: Logger.removeHandler
- Python 3.12 logging reference: Logger.propagate
- Python 3.12 logging reference: Logger.hasHandlers
- Python 3.12 logging reference: Handler.close
- Python 3.12 logging reference: logging.lastResort
- Python 3.12 logging handlers reference: StreamHandler
- Python 3.12 logging handlers reference: NullHandler