WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

logging.Formatter

Formatter setzt Attribute des Eintrags wie levelname und message zu Text zusammen.

Version: Python 3.14; repository image, production runtime not attested

Syntax

logging.Formatter(fmt=None, datefmt=None, style='%', validate=True, *, defaults=None)

Formatter setzt Attribute des Eintrags wie levelname und message zu Text zusammen.

validate=True prüft beim Erzeugen die Syntax von fmt für style. formatTime wandelt die Erstellungszeit des Eintrags mit datefmt für asctime um. Der Formatter kann den Ausnahme-Traceback aus exc_info und getrennt den aktuellen Aufrufstapel aus stack_info anfügen. style wählt die Layoutsyntax %, { oder $, doch message verbindet msg und args weiterhin mit %. datefmt steuert asctime, defaults liefert fehlende eigene Felder.

Der Eintrag mit count=%d und Argument 2 ergibt WARNING|count=2.

import logging
r=logging.LogRecord('app',logging.WARNING,'',0,'count=%d',(2,),None)
fmt=logging.Formatter('{levelname}|{message}|{tenant}',style='{',defaults={'tenant':'guest'})
assert fmt.format(r)=='WARNING|count=2|guest' and r.message=='count=2'
try: logging.Formatter('{message}',style='%')
except ValueError: pass
else: raise AssertionError
import sys,time,io
tf=logging.Formatter('%(asctime)s %(message)s',datefmt='%Y')
tf.converter=time.gmtime
r.created=0
assert tf.format(r)=='1970 count=2'
out=io.StringIO()
logging.basicConfig(stream=out,format='%(message)s',level=logging.DEBUG,force=True)
try: raise ValueError('x')
except ValueError: logging.error('both',exc_info=True,stack_info=True)
assert 'Traceback (most recent call last)' in out.getvalue() and 'Stack (most recent call last)' in out.getvalue()

Beispiele

import logging
fmt = logging.Formatter("%(levelname)s|%(message)s")
record = logging.LogRecord("sample", logging.WARNING, "", 0, "count=%d", (2,), None)
print(fmt.format(record))

Ergebnis

WARNING|count=2

Der Eintrag mit count=%d und Argument 2 ergibt WARNING|count=2.

Quellen