CKTIS / Python
contextlib.asynccontextmanager
Macht aus einer asynchronen Generatorfunktion eine Fabrik für async with.
Version: Python 3.14; repository image, production runtime not attested
Syntax
@contextlib.asynccontextmanagerMacht aus einer asynchronen Generatorfunktion eine Fabrik für async with.
Ein einzelner Generatormanager ist einmalig nutzbar, beim Einsatz als Dekorator entsteht für jeden Funktionsaufruf ein neuer Generator. Das Dekorieren asynchroner Funktionen ist seit 3.10 möglich. Genau ein yield liefert den as-Wert, finally kann das Aufräumen abwarten. Eine Ausnahme aus dem Rumpf wird am yield in den Generator geworfen und muss nach Abfangen zur Weitergabe erneut ausgelöst werden.
Im Beispiel wird 8 bereitgestellt und am Ende closed ausgegeben.
import asyncio
async def main():
from contextlib import asynccontextmanager
events = []
@asynccontextmanager
async def cm():
try:
yield 4
finally:
await asyncio.sleep(0)
events.append("closed")
try:
async with cm() as value:
assert value == 4
raise ValueError
except ValueError:
assert events == ["closed"]
asyncio.run(main())
import asyncio
async def main():
from contextlib import asynccontextmanager
seen = []
@asynccontextmanager
async def track():
seen.append("in")
yield
@track()
async def work():
return 3
assert await work() == await work() == 3 and len(seen) == 2
asyncio.run(main())
Beispiele
import contextlib
import asyncio
@contextlib.asynccontextmanager
async def scope():
try:
yield 8
finally:
print("closed")
async def main():
async with scope() as item:
print(item)
asyncio.run(main())
Ergebnis
8 closed
Im Beispiel wird 8 bereitgestellt und am Ende closed ausgegeben.