Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

Pobieranie loggera potomnego za pomocą Logger.getChild

Pobierz logger na podstawie nazwy jego rodzica i użyj procedury obsługi skonfigurowanej na rodzicu, bez kopiowania jej do loggera potomnego.

Wersja: Python 3.12

Składnia

parent_logger.getChild(suffix)

logging.Logger.getChild(suffix) to metoda instancji dostępna od Pythona 3.2. Dla loggera innego niż główny dopisuje do jego nazwy kropkę i tekstowy sufiks, a następnie pobiera logger o tak powstałej nazwie. W przypadku loggera głównego używa bezpośrednio sufiksu, bez przedrostka root.. app.getChild("validation") zwraca ten sam obiekt co logging.getLogger("app.validation"), jeśli app to logger o nazwie app. Sufiks może zawierać kropki: validation.rules wskazuje potomka położonego głębiej w hierarchii.

Metoda nie kopiuje procedur obsługi (handlerów). Gdy app.validation zaakceptuje rekord i ma propagate=True (wartość domyślna), rekord trafia także do handlerów loggera app. Ustawienie app.propagate = False nie odłącza handlerów app: zatrzymuje przekazywanie rekordu dalej, do loggera głównego.

Próg loggera i próg handlera działają na różnych etapach. Przy ustawieniu NOTSET logger app.validation używa w przykładzie poziomu INFO z app jako poziomu efektywnego. Po przyjęciu rekordu poziomy i filtry loggerów nadrzędnych nie są stosowane ponownie podczas propagacji, ale każdy handler nadal stosuje własny próg i filtry. Podpięcie tego samego handlera do potomka i rodzica może spowodować dwukrotny wypis tego samego rekordu.

Przykłady

import logging
import sys

app = logging.getLogger("app")
app.setLevel(logging.INFO)
app.propagate = False

handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(name)s | %(levelname)s | %(message)s"))
app.addHandler(handler)

validation = app.getChild("validation")
assert validation is logging.getLogger("app.validation")
validation.info("Input accepted")

Wynik

app.validation | INFO | Input accepted

Uruchom skrypt w nowym procesie Pythona 3.12. Asercja z `is` sprawdza tożsamość obiektu. Jedyny handler jest przypięty do `app`, ale w wierszu widnieje `app.validation`, bo to ten logger utworzył rekord.

Powiązane lekcje

  • Python · Lekcja 24 · Średniozaawansowany · Wersja: 3

Źródła