CKTIS / Python
contextlib.contextmanager
Декорира функция на генератор с един yield като фабрика за еднократни мениджъри на with.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
@contextlib.contextmanagerДекорира функция на генератор с един yield като фабрика за еднократни мениджъри на with.
Един екземпляр на мениджъра от генератор е еднократен, но като декоратор се създава нов генератор при всяко извикване на декорираната функция. Преди yield се извършва подготовката, а стойността се свързва с as. Грешка от тялото се подава при yield и се потиска, ако генераторът я прихване и завърши нормално. finally осигурява почистването.
Тук closed идва преди 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
Примери
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")
Резултат
4 closed handled
Тук closed идва преди handled.