Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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 = False

logging.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

Izvori