CKTIS / Python
contextlib.contextmanager
Dekoruje funkci generátoru s jediným yield jako továrnu jednorázových správců with.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
@contextlib.contextmanagerDekoruje funkci generátoru s jediným yield jako továrnu jednorázových správců with.
Jedna instance správce z generátoru je jednorázová, ale při použití jako dekorátor vznikne při každém volání dekorované funkce nový generátor. Před yield probíhá příprava a předaná hodnota se přiřadí v as. Chyba těla se vloží do yield a potlačí se, pokud ji generátor zachytí a normálně skončí. finally zajistí úklid.
Zde closed předchází 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
Příklady
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")
Výsledek
4 closed handled
Zde closed předchází handled.