CKTIS / Python
Obslužné objekty loggeru: čtení, odpojení a připojení
V Pythonu 3.12 ukazuje `logger.handlers` jen obslužné objekty připojené přímo k loggeru. Seznam čti a jeho obsah měň metodami `addHandler()` a `removeHandler()`.
Verze: Python 3.12
Syntaxe
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 je atribut instance se seznamem obslužných objektů (handlerů) připojených přímo k danému loggeru. Neobsahuje handlery nadřazených loggerů a není to modul logging.handlers. len(logger.handlers) počítá jen přímo připojené handlery.
Se seznamem zacházej jako s atributem pouze pro čtení. logger.addHandler(handler) handler připojí a logger.removeHandler(handler) jej odpojí. Nepoužívej logger.handlers.clear(), append() ani přiřazení: obcházejí zámky používané těmito metodami. Chceš-li seznam vyprázdnit, projdi kopii list(logger.handlers) a pro každou položku zavolej removeHandler(). Díky kopii neměníš seznam, který právě procházíš, ale celá operace není atomická.
Odpojením se handler neuzavře. Pokud jej spravuješ a už není nikde potřeba, zavolej zvlášť handler.close(). Neuzavírej handler jen proto, že jsi ho odpojil od jednoho loggeru: může být stále sdílený.
Prázdný seznam neznamená, že nebude žádný výstup. logger.hasHandlers() prohledává i nadřazené loggery dosažitelné šířením záznamu. Ověřuje přítomnost handleru, ne to, zda se konkrétní záznam vypíše. logger.propagate = False zastaví předávání nadřazeným loggerům. Nenajde-li se na této cestě žádný handler, může se použít logging.lastResort, který ve výchozím nastavení zapisuje záznamy od úrovně WARNING na standardní chybový výstup.
Příklady
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()Výsledek
before: 1 cleared: 0 attached: 1 ready
Příklad spusť v novém procesu. Počty ukazují jeden přímo připojený handler, prázdný seznam a jeden náhradní handler. Nový `StreamHandler` vypíše `ready` a blok `finally` jej odpojí a uzavře.
Související lekce
- Python · Lekce 27 · Pokročilá · Verze: 5
Zdroje
- 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