CKTIS / Python
Připojení a odpojení obslužných objektů logování pomocí addHandler
Zjisti, které obslužné objekty jsou připojené přímo k loggeru, připoj nakonfigurovaný objekt metodou `addHandler()` a vyprázdni seznam pomocí `removeHandler()` bez přímých úprav.
Verze: Python 3.12
Syntaxe
logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)
# Detach all directly attached handlers during controlled reconfiguration:
for handler in tuple(logger.handlers):
logger.removeHandler(handler)V Pythonu 3.12 obsahuje logger.handlers obslužné objekty připojené přímo k danému loggeru, nikoli objekty nadřazených loggerů. Seznam můžeš prohlížet, například pomocí len(logger.handlers), ale zacházej s ním jako se seznamem pouze pro čtení. logger.addHandler(handler) připojí existující instanci logging.Handler, například logging.StreamHandler; samotné volání žádnou zprávu nezaznamená.
Nepoužívej logger.handlers.clear(): seznam sice vyprázdní, ale obejde zámky používané metodami addHandler() a removeHandler(). Při řízené změně konfigurace projdi tuple(logger.handlers) a pro každou položku zavolej logger.removeHandler(handler). Díky kopii neprocházíš právě měněný seznam, celá operace ale není atomická. Odpojením se objekt neuzavře; pokud za něj odpovídáš a už se nepoužívá, zavolej handler.close() zvlášť.
Je-li propagate zapnuté, může záznam dojít i k obslužným objektům nadřazených loggerů, což může způsobit duplicitní výstup. logger.propagate = False předávání nadřazeným loggerům zastaví. Prázdný seznam přímo připojených objektů nezaručuje, že se nic nevypíše: pokud se na cestě předávání nenajde žádný obslužný objekt, může záznam zpracovat logging.lastResort.
Příklady
import logging
import sys
logger = logging.getLogger("cktis.lesson27")
logger.setLevel(logging.INFO)
logger.propagate = False
console = logging.StreamHandler(sys.stdout)
console.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
print(len(logger.handlers))
try:
logger.addHandler(console)
print(len(logger.handlers))
logger.info("ready")
finally:
for attached in tuple(logger.handlers):
logger.removeHandler(attached)
console.close()
print(len(logger.handlers))Výsledek
0 1 INFO: ready 0
Spusť skript v novém procesu Pythonu 3.12. Hodnoty `0`, `1` a `0` udávají počet přímo připojených obslužných objektů před připojením, po něm a po odpojení. Obslužný objekt zapíše `INFO: ready` na standardní výstup.
Související lekce
- Python · Lekce 27 · Pokročilá · Verze: 5
Zdroje
- Logging facility for Python — Logger.handlers
- Logging facility for Python — Logger.addHandler
- Logging facility for Python — Logger.removeHandler
- Logging facility for Python — Logger.propagate
- Logging facility for Python — Handler.close
- Logging facility for Python — logging.lastResort
- Logging handlers — StreamHandler
- Logging Cookbook — Using a context manager for selective logging