CKTIS / Python
logging.Formatter
Formatter assemble les attributs du record comme levelname et message en texte.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
logging.Formatter(fmt=None, datefmt=None, style='%', validate=True, *, defaults=None)Formatter assemble les attributs du record comme levelname et message en texte.
validate=True vérifie à la construction la syntaxe de fmt pour style. formatTime convertit la date de création du record selon datefmt pour asctime. Formatter peut ajouter la trace de l’exception issue de exc_info et séparément la pile courante fournie par stack_info. style choisit la syntaxe %, { ou $ de la mise en page, mais message combine toujours msg et args avec %. datefmt règle asctime et defaults fournit les champs personnalisés manquants.
Avec count=%d et l’argument 2, on obtient 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()
Exemples
import logging
fmt = logging.Formatter("%(levelname)s|%(message)s")
record = logging.LogRecord("sample", logging.WARNING, "", 0, "count=%d", (2,), None)
print(fmt.format(record))
Résultat
WARNING|count=2
Avec count=%d et l’argument 2, on obtient WARNING|count=2.