Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

`logging.Logger.propagate`: posredovanje dnevniških zapisov

`propagate` določa, ali dnevniški zapis prejmejo tudi obdelovalniki nadrejenih zapisovalnikov. `False` ustavi posredovanje navzgor, ne da bi izklopil lokalne obdelovalnike.

Različica: Python 3.12

Sintaksa

logger.addHandler(handler)
logger.propagate = False  # Stop forwarding to ancestor handlers.
logger.propagate = True   # Allow forwarding to ancestor handlers.

V Pythonu 3.12 je propagate atribut primerka logging.Logger, ne metoda. Privzeta vrednost je True. Klic logger.addHandler(handler) doda obdelovalnik neposredno k temu zapisovalniku, ne da bi spremenil propagate.

Če dogodek prestane preverjanje efektivne ravni in filtrov izvornega zapisovalnika, se zapis najprej ponudi njegovim obdelovalnikom. Pri True se posredovanje nadaljuje navzgor po hierarhiji imen, ločenih s pikami, lahko vse do korenskega zapisovalnika. Če ima kateri od zapisovalnikov v verigi propagate = False, lahko njegovi obdelovalniki zapis še vedno obdelajo, tisti nad njim pa ga ne prejmejo.

Pri posredovanju se ravni in filtri nadrejenih zapisovalnikov ne preverijo znova. Raven in filtri posameznega obdelovalnika še vedno veljajo. To ni isto kot dedovanje efektivne ravni: če izvorni zapisovalnik ni korenski in ima raven NOTSET, se njegov efektivni prag določi po hierarhiji še pred posredovanjem.

Če lokalni in nadrejeni obdelovalnik pišeta na isti cilj, se lahko pojavijo podvojeni vnosi. Obdelovalnike nastavi samo na ustreznem nadrejenem zapisovalniku ali pa dodaj lokalni obdelovalnik in nastavi logger.propagate = False, da ločiš njegov izpis. Sam False ne zagotavlja tišine: če se na poti ne najde noben obdelovalnik, lahko logging.lastResort izpiše zapise ravni WARNING ali višje.

Primeri

import logging
import sys


def console_handler(label):
    handler = logging.StreamHandler(sys.stdout)
    handler.setLevel(logging.INFO)
    handler.setFormatter(logging.Formatter(f"{label}: %(message)s"))
    return handler


root = logging.getLogger()
root.setLevel(logging.ERROR)
root.addHandler(console_handler("root"))

logger = logging.getLogger("checkout")
logger.setLevel(logging.INFO)
logger.addHandler(console_handler("checkout"))

logger.propagate = True
logger.info("order received")

logger.propagate = False
logger.info("order saved")

Rezultat

checkout: order received
root: order received
checkout: order saved

Prvi zapis `INFO` izpišeta oba obdelovalnika. Obdelovalnik korenskega zapisovalnika ga sprejme, čeprav je sam korenski zapisovalnik nastavljen na `ERROR`. Po nastavitvi `False` drugi zapis izpiše samo obdelovalnik zapisovalnika `checkout`.

Povezane lekcije

  • Python · Lekcija 24 · Srednja · Različica: 3

Viri