CKTIS / Python
Dodavanje rukovatelja zapisima i zaustavljanje propagacije
Pomoću `addHandler()` dodaj rukovatelj određenom zapisivaču, a postavkom `propagate = False` spriječi da zapisi stignu do rukovatelja nadređenih zapisivača, uključujući korijenski.
Verzija: Python 3.12
Sintaksa
logger.addHandler(hdlr)
logger.propagate = Falselogging.Logger.addHandler dodaje postojeći objekt rukovatelja određenom zapisivaču. Dohvati zapisivač pozivom logging.getLogger(name) i metodi logger.addHandler(hdlr) proslijedi objekt, primjerice instancu klase logging.StreamHandler, a ne samu klasu. Rukovatelj određuje odredište, a njegov formater određuje izgled teksta. Za uklanjanje rukovatelja pozovi logger.removeHandler(hdlr) umjesto da izravno mijenjaš logger.handlers.
Izvorni zapisivač najprije primjenjuje svoju efektivnu razinu i vlastite filtre. Prihvaćeni zapis predaje lokalnim rukovateljima, a uz zadani propagate = True i rukovateljima redom sve viših zapisivača, osim ako se propagacija putem zaustavi. Pri prosljeđivanju se ne provjeravaju razine ni filtri nadređenih zapisivača, ali svaki rukovatelj i dalje primjenjuje vlastiti prag i filtre.
logger.propagate = False zaustavlja prosljeđivanje naviše nakon što su lokalni rukovatelji dobili priliku obraditi zapis. Time se ne isključuje zapisivač niti se mijenja konfiguracija korijenskog zapisivača: nijedan rukovatelj iznad njega u toj grani ne prima zapis. Ako lokalni i nadređeni rukovatelji pišu na isto odredište, zapisi mogu izgledati kao duplikati. Ako je dovoljno zajedničko odredište, dodaj rukovatelj samo odgovarajućem nadređenom zapisivaču i ostavi propagaciju uključenu.
Primjeri
import logging
import sys
logging.basicConfig(
level=logging.WARNING,
stream=sys.stdout,
format="root: %(message)s",
)
logger = logging.getLogger("cktis.demo")
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("local: %(message)s"))
logger.addHandler(handler)
logger.info("first")
logger.propagate = False
logger.info("second")
Rezultat
local: first root: first local: second
Pokreni skriptu u novom procesu Pythona 3.12. `first` se pojavljuje dvaput, uz `local:` i uz `root:`. Razina `WARNING` korijenskog zapisivača ne blokira proslijeđeni zapis `INFO` jer zapis stiže izravno njegovu rukovatelju. Nakon isključivanja propagacije `second` se pojavljuje samo uz `local:`.
Povezane lekcije
- Python · Lekcija 24 · Srednje · Verzija: 3