Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

logging.Handler.setFormatter — nastavení formátovače handleru

`logging.Handler.setFormatter` přiřadí handleru formátovač nebo ho při předání hodnoty `None` odebere. Řídí podobu výstupu, nikoli práh úrovně protokolování.

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

Syntaxe

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) nastaví formátovač pro konkrétní handler. Metoda nekontroluje, zda je fmt instancí logging.Formatter. Standardní implementace Handler.format(record) může použít i jiný objekt, pokud se v logickém kontextu vyhodnotí jako pravdivý a poskytuje kompatibilní metodu format(record). Samotný formátovací řetězec formátovač nenahradí. Použij například handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

Volání handler.setFormatter(None) přiřazený formátovač odstraní. Pokud handler používá Handler.format(record), použije se pak výchozí formátovač modulu: běžná zpráva nedostane předponu s úrovní ani názvem loggeru. Tím se protokolování nevypne.

Formátovač řídí zobrazení záznamu; prahové hodnoty úrovní a filtry určují jeho zpracování. Toto nastavení se týká daného handleru, nikoli všech handlerů loggeru. Výstupní vzor formátovače je oddělený od interpolace argumentů zprávy, například v logger.info("Items: %s", 3).

Příklad zachytává výstup do io.StringIO, nejprve s vlastním formátem a poté po jeho odstranění. Vynechává časová razítka a konfiguraci kořenového loggeru, aby byl výsledek deterministický.

Příklady

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()

Výsledek

INFO | Items: 3
Items: 3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje