Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources