CKTIS / Python
contextlib.asynccontextmanager
Maakt van een asynchrone generatorfunctie een fabriek voor async with.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
@contextlib.asynccontextmanagerMaakt van een asynchrone generatorfunctie een fabriek voor async with.
Een instantie van de generatorbeheerder is eenmalig bruikbaar, maar als decorator maakt hij voor elke aanroep van de gedecoreerde functie een nieuwe generator. Het decoreren van asynchrone functies kan vanaf 3.10. Precies één yield levert de as-waarde en finally kan op opruimen wachten. Een uitzondering uit het blok komt op de yield terug in de generator en moet na afvangen opnieuw worden opgeworpen om door te gaan.
Hier wordt 8 geleverd en bij verlaten closed afgedrukt.
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())
Voorbeelden
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())
Resultaat
8 closed
Hier wordt 8 geleverd en bij verlaten closed afgedrukt.