WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

contextlib.contextmanager

Dekoriert eine Generatorfunktion mit genau einem yield als Fabrik für einmalige with-Manager.

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

Syntax

@contextlib.contextmanager

Dekoriert eine Generatorfunktion mit genau einem yield als Fabrik für einmalige with-Manager.

Ein einzelner Generatormanager ist einmalig nutzbar, beim Einsatz als Dekorator entsteht für jeden Funktionsaufruf ein neuer Generator. Vor yield erfolgt die Vorbereitung und dessen Wert wird an as gebunden. Ein Fehler aus dem Rumpf erscheint am yield und wird unterdrückt, wenn der Generator ihn fängt und normal endet. finally sichert das Aufräumen.

Hier steht closed vor 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

Beispiele

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")

Ergebnis

4
closed
handled

Hier steht closed vor handled.

Quellen