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.