CKTIS / Python
Loggerhandlers bekijken, loskoppelen en koppelen
In Python 3.12 toont `logger.handlers` alleen de handlers die rechtstreeks aan de logger gekoppeld zijn. Lees de lijst uit en wijzig haar met `addHandler()` en `removeHandler()`.
Versie: Python 3.12
Syntax
logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)
# Detach every handler in the snapshot of this logger's direct attachments.
for handler in list(logger.handlers):
logger.removeHandler(handler)logging.Logger.handlers is een attribuut van een loggerinstantie. Het bevat de lijst met handlers die rechtstreeks aan die logger gekoppeld zijn. Handlers van bovenliggende loggers staan er niet in, en het attribuut is niet de module logging.handlers. len(logger.handlers) telt alleen rechtstreekse koppelingen.
Behandel de lijst als alleen-lezen. Gebruik logger.addHandler(handler) om een handler te koppelen en logger.removeHandler(handler) om hem los te koppelen. Gebruik geen logger.handlers.clear(), append() of toewijzing: daarmee omzeil je de vergrendelingen van de methoden. Om de lijst leeg te maken, doorloop je een kopie, list(logger.handlers), en roep je voor elk item removeHandler() aan. Zo verander je de lijst die je doorloopt niet, maar de volledige bewerking is niet atomair.
Door een handler los te koppelen sluit je hem niet. Roep handler.close() apart aan voor een handler waarvoor jij verantwoordelijk bent zodra die nergens meer nodig is. Sluit een handler niet alleen omdat je hem van één logger hebt losgekoppeld: hij kan nog gedeeld worden.
Een lege lijst betekent niet dat er geen uitvoer is. logger.hasHandlers() doorzoekt ook bovenliggende loggers die via propagatie bereikbaar zijn. Het controleert of er een handler is, niet of een bepaald logrecord wordt uitgevoerd. logger.propagate = False stopt het doorgeven aan bovenliggende loggers. Als er op dat pad geen handler wordt gevonden, kan logging.lastResort worden gebruikt; standaard schrijft die records vanaf WARNING naar de standaardfoutuitvoer.
Voorbeelden
import logging
import sys
logger = logging.getLogger('cktis.lesson27')
logger.setLevel(logging.INFO)
logger.propagate = False
old_handler = logging.NullHandler()
logger.addHandler(old_handler)
print('before:', len(logger.handlers))
for handler in list(logger.handlers):
logger.removeHandler(handler)
old_handler.close()
print('cleared:', len(logger.handlers))
new_handler = logging.StreamHandler(sys.stdout)
new_handler.setFormatter(logging.Formatter('%(message)s'))
logger.addHandler(new_handler)
try:
print('attached:', len(logger.handlers))
logger.info('ready')
finally:
logger.removeHandler(new_handler)
new_handler.close()Resultaat
before: 1 cleared: 0 attached: 1 ready
Draai het voorbeeld in een nieuw proces. De aantallen tonen één rechtstreeks gekoppelde handler, een lege lijst en één vervangende handler. De nieuwe `StreamHandler` schrijft `ready`; het `finally`-blok koppelt hem los en sluit hem.
Gerelateerde lessen
- Python · Les 27 · Gevorderd · Versie: 5
Bronnen
- Python 3.12 logging reference: Logger.handlers
- Python 3.12 logging reference: Logger.addHandler
- Python 3.12 logging reference: Logger.removeHandler
- Python 3.12 logging reference: Logger.propagate
- Python 3.12 logging reference: Logger.hasHandlers
- Python 3.12 logging reference: Handler.close
- Python 3.12 logging reference: logging.lastResort
- Python 3.12 logging handlers reference: StreamHandler
- Python 3.12 logging handlers reference: NullHandler