CKTIS / Python
Pripájanie a odpájanie obslužných objektov logovania pomocou addHandler
Zisti, ktoré obslužné objekty sú pripojené priamo k loggeru, pripoj nakonfigurovaný objekt metódou `addHandler()` a vyprázdni zoznam pomocou `removeHandler()` bez priamej úpravy.
Verzia: Python 3.12
Syntax
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 Pythone 3.12 obsahuje logger.handlers obslužné objekty pripojené priamo k danému loggeru, nie objekty nadradených loggerov. Zoznam môžeš prezerať, napríklad pomocou len(logger.handlers), ale zaobchádzaj s ním ako so zoznamom určeným len na čítanie. logger.addHandler(handler) pripojí existujúcu inštanciu logging.Handler, napríklad logging.StreamHandler; samotné volanie nezaznamená žiadnu správu.
Nepoužívaj logger.handlers.clear(): zoznam síce vyprázdni, ale obíde zámky používané metódami addHandler() a removeHandler(). Pri riadenej zmene konfigurácie prejdi tuple(logger.handlers) a pre každú položku zavolaj logger.removeHandler(handler). Vďaka kópii neprechádzaš práve menený zoznam, celá operácia však nie je atomická. Odpojenie objekt nezatvorí; ak zaň zodpovedáš a už sa nepoužíva, zavolaj handler.close() samostatne.
Ak je propagate zapnuté, záznam môže dôjsť aj k obslužným objektom nadradených loggerov, čo môže spôsobiť duplicitný výstup. logger.propagate = False zastaví odovzdávanie nadradeným loggerom. Prázdny zoznam priamo pripojených objektov nezaručuje, že sa nič nevypíše: ak sa na ceste odovzdávania nenájde žiadny obslužný objekt, záznam môže spracovať logging.lastResort.
Prí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ýsledok
0 1 INFO: ready 0
Spusti skript v novom procese Pythonu 3.12. Hodnoty `0`, `1` a `0` udávajú počet priamo pripojených obslužných objektov pred pripojením, po pripojení a po odpojení. Obslužný objekt zapíše `INFO: ready` na štandardný výstup.
Súvisiace lekcie
- Python · Lekcia 27 · Pokročilá · Verzia: 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