KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

logging.Handler.setFormatter — de formatter van een handler instellen

Met `logging.Handler.setFormatter` wijs je een formatter toe aan een handler of verwijder je die met `None`. De methode bepaalt de weergave van de uitvoer, niet de drempel voor het logniveau.

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

Syntax

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) stelt de formatter in voor een specifieke handler. De methode controleert niet of fmt een instantie van logging.Formatter is. De standaardimplementatie van Handler.format(record) kan ook een ander object gebruiken als dat in een booleaanse context als waar geldt en een compatibele methode format(record) heeft. Een gewone opmaakstring is geen vervanging voor een formatter. Gebruik bijvoorbeeld handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

Met handler.setFormatter(None) verwijder je de toegewezen formatter. Wanneer de handler Handler.format(record) gebruikt, wordt daarna de standaardformatter van de module gebruikt: een gewoon bericht krijgt geen voorvoegsel met het niveau of de loggernaam. Dit schakelt het loggen niet uit.

Een formatter bepaalt hoe een record wordt weergegeven; niveaudrempels en filters bepalen hoe het wordt verwerkt. Deze instelling geldt voor deze handler, niet voor alle handlers van de logger. Het uitvoerpatroon van de formatter staat los van de interpolatie van berichtargumenten, zoals bij logger.info("Items: %s", 3).

Het voorbeeld vangt de uitvoer op in io.StringIO, eerst met een aangepaste opmaak en daarna nadat die is verwijderd. Tijdstempels en de configuratie van de rootlogger zijn weggelaten om het resultaat deterministisch te houden.

Voorbeelden

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()

Resultaat

INFO | Items: 3
Items: 3

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen