Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

contextlib.contextmanager

Dekoruje funkcję generatora z jednym yield, tworząc fabrykę jednorazowych zarządców with.

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

Składnia

@contextlib.contextmanager

Dekoruje funkcję generatora z jednym yield, tworząc fabrykę jednorazowych zarządców with.

Instancja zarządcy z generatora jest jednorazowa, natomiast użycie jako dekoratora tworzy nowy generator przy każdym wywołaniu dekorowanej funkcji. Kod przed yield przygotowuje zasób, a przekazana wartość trafia do as. Błąd ciała wraca w miejscu yield i zostaje stłumiony, jeśli generator go przechwyci i zakończy się normalnie. finally zapewnia sprzątanie.

W przykładzie closed poprzedza 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

Przykłady

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

Wynik

4
closed
handled

W przykładzie closed poprzedza handled.

Źródła