KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Logginghandlers toevoegen en verwijderen met addHandler

Bekijk welke handlers direct aan een logger gekoppeld zijn, voeg een ingestelde handler toe met `addHandler()` en maak de lijst leeg met `removeHandler()` in plaats van haar zelf te wijzigen.

Versie: Python 3.12

Syntax

logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)

# Detach all directly attached handlers during controlled reconfiguration:
for handler in tuple(logger.handlers):
    logger.removeHandler(handler)

In Python 3.12 bevat logger.handlers de handlers die direct aan deze logger gekoppeld zijn, niet die van bovenliggende loggers. Je kunt de lijst bekijken, bijvoorbeeld met len(logger.handlers), maar behandel haar als alleen-lezen. logger.addHandler(handler) koppelt een bestaande logging.Handler-instantie, zoals een logging.StreamHandler; de aanroep zelf logt geen bericht.

Gebruik logger.handlers.clear() niet: die aanroep leegt de lijst, maar omzeilt de vergrendelingen van addHandler() en removeHandler(). Doorloop bij een gecontroleerde herconfiguratie tuple(logger.handlers) en roep voor elk element logger.removeHandler(handler) aan. Dankzij de kopie doorloop je niet de lijst die je aan het wijzigen bent, maar de hele bewerking wordt er niet atomair door. Een handler loskoppelen sluit hem niet. Roep handler.close() apart aan als je verantwoordelijk bent voor de handler en hij niet meer in gebruik is.

Als propagate aanstaat, kan een logrecord ook bij handlers van bovenliggende loggers terechtkomen en daardoor dubbele uitvoer opleveren. logger.propagate = False stopt die doorgifte. Een lege lijst met directe handlers garandeert geen stilte: als er langs het propagatiepad geen handler wordt gevonden, kan logging.lastResort het record afhandelen.

Voorbeelden

import logging
import sys

logger = logging.getLogger("cktis.lesson27")
logger.setLevel(logging.INFO)
logger.propagate = False

console = logging.StreamHandler(sys.stdout)
console.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))

print(len(logger.handlers))
try:
    logger.addHandler(console)
    print(len(logger.handlers))
    logger.info("ready")
finally:
    for attached in tuple(logger.handlers):
        logger.removeHandler(attached)
    console.close()

print(len(logger.handlers))

Resultaat

0
1
INFO: ready
0

Voer het script uit in een nieuw Python 3.12-proces. De aantallen `0`, `1` en `0` geven het aantal directe handlers aan vóór het koppelen, na het koppelen en na het verwijderen. De handler schrijft `INFO: ready` naar de standaarduitvoer.

Gerelateerde lessen

  • Python · Les 27 · Gevorderd · Versie: 5

Bronnen