CKTIS / Python
Dodajanje obdelovalnika dnevniških zapisov in ustavitev širjenja
Z `addHandler()` dodaj obdelovalnik izbranemu zapisovalniku, z `propagate = False` pa prepreči, da bi zapisi dosegli obdelovalnike nadrejenih zapisovalnikov, vključno s korenskim.
Različica: Python 3.12
Sintaksa
logger.addHandler(hdlr)
logger.propagate = Falselogging.Logger.addHandler doda obstoječi objekt obdelovalnika določenemu zapisovalniku. Zapisovalnik pridobi z logging.getLogger(name) in metodi logger.addHandler(hdlr) podaj na primer primerek logging.StreamHandler, ne samega razreda. Obdelovalnik določa cilj izpisa, njegov oblikovalnik pa obliko besedila. Če želiš obdelovalnik odstraniti, pokliči logger.removeHandler(hdlr), namesto da neposredno spreminjaš logger.handlers.
Izvorni zapisovalnik najprej uporabi svojo efektivno raven in lastne filtre. Sprejeti zapis ponudi lokalnim obdelovalnikom, pri privzeti nastavitvi propagate = True pa tudi obdelovalnikom zaporednih nadrejenih zapisovalnikov, če se širjenje vmes ne ustavi. Pri posredovanju se ravni in filtri nadrejenih zapisovalnikov ne preverjajo, vendar vsak obdelovalnik še vedno uporabi svoj prag in svoje filtre.
logger.propagate = False ustavi posredovanje navzgor, potem ko so lokalni obdelovalniki dobili možnost obdelati zapis. S tem ne izklopiš zapisovalnika in ne spremeniš nastavitev korenskega zapisovalnika: noben obdelovalnik višje v tej veji ne prejme zapisa. Če lokalni in nadrejeni obdelovalniki pišejo na isti cilj, je lahko videti, kot da so zapisi podvojeni. Če zadošča skupni cilj, dodaj obdelovalnik samo ustreznemu nadrejenemu zapisovalniku in pusti širjenje vklopljeno.
Primeri
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
Zaženi skript v novem procesu Python 3.12. `first` se prikaže dvakrat, z `local:` in z `root:`. Raven `WARNING` korenskega zapisovalnika ne ustavi posredovanega zapisa `INFO`, ker ga prejme neposredno njegov obdelovalnik. Ko izklopiš širjenje, se `second` prikaže samo z `local:`.
Povezane lekcije
- Python · Lekcija 24 · Srednja · Različica: 3