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

CKTIS / Python

logging.Handler.setFormatter — définir le formateur d’un gestionnaire

`logging.Handler.setFormatter` attribue un formateur à un gestionnaire ou le retire si on lui passe `None`. Cette méthode contrôle la présentation de la sortie, et non le seuil du niveau de journalisation.

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

Syntaxe

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) définit le formateur d’un gestionnaire particulier. La méthode ne vérifie pas si fmt est une instance de logging.Formatter. L’implémentation standard de Handler.format(record) peut aussi utiliser un autre objet s’il est considéré comme vrai en contexte booléen et fournit une méthode format(record) compatible. Une simple chaîne de format ne peut pas remplacer un formateur. Par exemple, utilisez handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

L’appel à handler.setFormatter(None) supprime le formateur attribué. Lorsque le gestionnaire utilise Handler.format(record), le formateur par défaut du module est alors utilisé : un message ordinaire ne reçoit aucun préfixe de niveau ni de nom de logger. Cela ne désactive pas la journalisation.

Un formateur contrôle la présentation de l’enregistrement ; les seuils de niveau et les filtres déterminent son traitement. Ce réglage s’applique à ce gestionnaire, et non à tous les gestionnaires du logger. Le modèle de sortie du formateur est distinct de l’interpolation des arguments du message, comme dans logger.info("Items: %s", 3).

L’exemple capture la sortie dans io.StringIO, d’abord avec un format personnalisé, puis après sa suppression. Il omet les horodatages et la configuration du logger racine afin de rendre le résultat déterministe.

Exemples

import io
import logging

stream = io.StringIO()
handler = logging.StreamHandler(stream)
logger = logging.getLogger("demo")
logger.setLevel(logging.INFO)
logger.propagate = False
logger.addHandler(handler)

handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s"))
logger.info("Items: %s", 3)

handler.setFormatter(None)
logger.info("Items: %s", 3)

print(stream.getvalue(), end="")
logger.removeHandler(handler)
handler.close()

Résultat

INFO | Items: 3
Items: 3

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources