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.