KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

contextlib.contextmanager

Decoreert een generatorfunctie met één yield als fabriek van eenmalige with-beheerders.

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

Syntax

@contextlib.contextmanager

Decoreert een generatorfunctie met één yield als fabriek van eenmalige with-beheerders.

Een instantie van de generatorbeheerder is eenmalig bruikbaar, maar als decorator maakt hij voor elke aanroep van de gedecoreerde functie een nieuwe generator. Vóór yield vindt de voorbereiding plaats en de waarde wordt aan as gebonden. Een fout uit het blok komt op de yield terug en wordt onderdrukt als de generator haar vangt en normaal eindigt. finally waarborgt het opruimen.

Hier komt closed vóór handled.

from contextlib import contextmanager
seen = []
@contextmanager
def scope():
    try:
        yield "open"
    except LookupError:
        seen.append("handled")
        raise
    finally:
        seen.append("closed")
try:
    with scope() as x:
        assert x == "open"
        raise KeyError
except KeyError:
    assert seen == ["handled", "closed"]
@scope()
def check():
    return 3
assert check() == check() == 3

Voorbeelden

import contextlib
@contextlib.contextmanager
def measure():
    try:
        yield 4
    finally:
        print("closed")

try:
    with measure() as value:
        print(value)
        raise ValueError
except ValueError:
    print("handled")

Resultaat

4
closed
handled

Hier komt closed vóór handled.

Bronnen