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.