Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

logging.Handler.setFormatter — nastavitev oblikovalnika za handler

`logging.Handler.setFormatter` handlerju dodeli oblikovalnik ali ga odstrani, če kot argument podamo `None`. Določa predstavitev izhoda, ne praga ravni beleženja.

Različica: Python 3.14; repository image, production runtime not attested

Sintaksa

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) nastavi oblikovalnik za določen handler. Metoda ne preverja, ali je fmt primerek razreda logging.Formatter. Standardna implementacija Handler.format(record) lahko uporabi tudi drug objekt, če se ta v logičnem kontekstu ovrednoti kot resničen in ima združljivo metodo format(record). Sam oblikovalni niz ne more nadomestiti oblikovalnika. Uporabi na primer handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

Klic handler.setFormatter(None) odstrani dodeljeni oblikovalnik. Ko handler uporablja Handler.format(record), se nato uporabi privzeti oblikovalnik modula: običajno sporočilo ne dobi predpone z ravnjo ali imenom loggerja. S tem beleženje ni izklopljeno.

Oblikovalnik določa prikaz zapisa; pragovi ravni in filtri določajo njegovo obdelavo. Nastavitev velja za ta handler, ne za vse handlerje loggerja. Izhodni vzorec oblikovalnika je ločen od interpolacije argumentov sporočila, kot pri logger.info("Items: %s", 3).

Primer zajame izhod v io.StringIO, najprej z lastnim oblikovanjem, nato pa po njegovi odstranitvi. Časovne žige in konfiguracijo korenskega loggerja izpusti, da je rezultat determinističen.

Primeri

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

Rezultat

INFO | Items: 3
Items: 3

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri