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.