KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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