CKTIS / Python
logging.Handler.setFormatter — nastavenie formátovača handlera
`logging.Handler.setFormatter` priradí handleru formátovač alebo ho pri odovzdaní hodnoty `None` odstráni. Riadi podobu výstupu, nie prah úrovne zaznamenávania.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
handler.setFormatter(fmt)logging.Handler.setFormatter(fmt) nastaví formátovač pre konkrétny handler. Metóda nekontroluje, či je fmt inštanciou logging.Formatter. Štandardná implementácia Handler.format(record) môže použiť aj iný objekt, ak sa v logickom kontexte vyhodnotí ako pravdivý a poskytuje kompatibilnú metódu format(record). Samotný formátovací reťazec formátovač nenahradí. Použi napríklad handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).
Volanie handler.setFormatter(None) priradený formátovač odstráni. Ak handler používa Handler.format(record), následne sa použije predvolený formátovač modulu: bežná správa nedostane predponu s úrovňou ani názvom loggera. Tým sa zaznamenávanie nevypne.
Formátovač riadi zobrazenie záznamu; prahové hodnoty úrovní a filtre určujú jeho spracovanie. Toto nastavenie sa vzťahuje na daný handler, nie na všetky handlery loggera. Výstupný vzor formátovača je oddelený od interpolácie argumentov správy, napríklad v logger.info("Items: %s", 3).
Príklad zachytáva výstup do io.StringIO, najprv s vlastným formátom a potom po jeho odstránení. Vynecháva časové pečiatky a konfiguráciu koreňového loggera, aby bol výsledok deterministický.
Prí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ýsledok
INFO | Items: 3 Items: 3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.