CKTIS / Python
logging.Formatter
Formatter voegt recordattributen zoals levelname en message samen tot tekst.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
logging.Formatter(fmt=None, datefmt=None, style='%', validate=True, *, defaults=None)Formatter voegt recordattributen zoals levelname en message samen tot tekst.
validate=True controleert bij aanmaak de syntaxis van fmt voor style. formatTime zet de aanmaaktijd van het record met datefmt om voor asctime. Formatter kan de traceback van de uitzondering uit exc_info en afzonderlijk de huidige aanroepstack uit stack_info toevoegen. style kiest de lay-outsyntaxis %, { of $, terwijl message nog steeds msg en args via % combineert. datefmt regelt asctime en defaults levert ontbrekende eigen velden.
Het record met count=%d en argument 2 geeft 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()
Voorbeelden
import logging
fmt = logging.Formatter("%(levelname)s|%(message)s")
record = logging.LogRecord("sample", logging.WARNING, "", 0, "count=%d", (2,), None)
print(fmt.format(record))
Resultaat
WARNING|count=2
Het record met count=%d en argument 2 geeft WARNING|count=2.