Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje