CKTIS / Python
contextlib.asynccontextmanager
Trasforma una funzione generatrice asincrona in una fabbrica per async with.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
@contextlib.asynccontextmanagerTrasforma una funzione generatrice asincrona in una fabbrica per async with.
Ogni istanza del gestore generatore è monouso, mentre come decoratore crea un nuovo generatore a ogni chiamata della funzione decorata. La decorazione di funzioni asincrone è disponibile dalla 3.10. Un solo yield fornisce il valore di as e finally può attendere la pulizia. Un’eccezione del corpo rientra nel generatore al punto yield e va rilanciata dopo la cattura per propagarsi.
L’esempio fornisce 8 e stampa closed all’uscita.
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())
Esempi
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())
Risultato
8 closed
L’esempio fornisce 8 e stampa closed all’uscita.