Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Python

`logging.Logger.propagate`: prosljeđivanje zapisa dnevnika

`propagate` određuje dolazi li zapis i do obrađivača nadređenih loggera. Vrijednost `False` zaustavlja prosljeđivanje prema gore, ali ne isključuje lokalne obrađivače.

Verzija: Python 3.12

Sintaksa

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

U Pythonu 3.12 propagate je atribut instance logging.Logger, a ne metoda. Zadana vrijednost je True. Poziv logger.addHandler(handler) dodaje obrađivač izravno tom loggeru bez promjene atributa propagate.

Ako događaj prođe provjeru efektivne razine i filtara izvornog loggera, zapis se prvo nudi njegovim obrađivačima. Uz True prosljeđivanje se nastavlja prema gore kroz hijerarhiju naziva odvojenih točkama i može dosegnuti korijenski logger. Ako neki logger u lancu ima propagate = False, njegovi obrađivači i dalje mogu obraditi zapis, ali oni iznad njega neće ga primiti.

Pri prosljeđivanju se razine i filtri nadređenih loggera ne provjeravaju ponovno. Razina i filtri svakog obrađivača i dalje se primjenjuju. To nije isto što i nasljeđivanje efektivne razine: ako izvorni logger nije korijenski i ima razinu NOTSET, njegov se efektivni prag određuje prema hijerarhiji prije prosljeđivanja.

Ako lokalni obrađivač i obrađivač nadređenog loggera pišu na isto odredište, mogu nastati dvostruki unosi. Postavi obrađivače samo na prikladan nadređeni logger ili dodaj lokalni obrađivač i postavi logger.propagate = False kako bi odvojio njegov izlaz. Sam False ne jamči da neće biti ispisa: ako se na putu ne pronađe nijedan obrađivač, logging.lastResort može ispisati zapise razine WARNING ili više.

Primjeri

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

Oba obrađivača ispisuju prvi zapis `INFO`. Obrađivač korijenskog loggera prihvaća ga iako je sam korijenski logger postavljen na `ERROR`. Nakon postavljanja `False` drugi zapis ispisuje samo obrađivač loggera `checkout`.

Povezane lekcije

  • Python · Lekcija 24 · Srednje · Verzija: 3

Izvori