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.