Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

logging.Handler.setFormatter — ustawianie formatera handlera

Metoda `logging.Handler.setFormatter` przypisuje handlerowi formater lub usuwa go po przekazaniu `None`. Określa wygląd zapisu, a nie próg poziomu logowania.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) ustawia formater dla konkretnego handlera. Metoda nie sprawdza, czy fmt jest instancją logging.Formatter. Standardowa implementacja Handler.format(record) może użyć także innego obiektu, jeśli w kontekście logicznym jest on prawdziwy i udostępnia zgodną metodę format(record). Sam łańcuch formatujący nie zastępuje formatera. Użyj na przykład handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

Wywołanie handler.setFormatter(None) usuwa przypisany formater. Gdy handler korzysta z Handler.format(record), zostaje wtedy użyty domyślny formater modułu: zwykły komunikat nie otrzymuje prefiksu z poziomem ani nazwą loggera. Nie oznacza to wyłączenia logowania.

Formater odpowiada za prezentację rekordu; progi poziomów i filtry decydują o jego przetwarzaniu. Ustawienie dotyczy tego handlera, nie wszystkich handlerów loggera. Wzorzec wyjściowy formatera jest odrębny od interpolacji argumentów komunikatu, takiej jak logger.info("Items: %s", 3).

Przykład przechwytuje wyjście w io.StringIO, najpierw z własnym formatem, a następnie po jego usunięciu. Pomija czas i konfigurację głównego loggera, aby wynik był deterministyczny.

Przykłady

import io
import logging

stream = io.StringIO()
handler = logging.StreamHandler(stream)
logger = logging.getLogger("demo")
logger.setLevel(logging.INFO)
logger.propagate = False
logger.addHandler(handler)

handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s"))
logger.info("Items: %s", 3)

handler.setFormatter(None)
logger.info("Items: %s", 3)

print(stream.getvalue(), end="")
logger.removeHandler(handler)
handler.close()

Wynik

INFO | Items: 3
Items: 3

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła