CKTIS / Python
contextlib.asynccontextmanager
Transforme une fonction génératrice asynchrone en fabrique pour async with.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
@contextlib.asynccontextmanagerTransforme une fonction génératrice asynchrone en fabrique pour async with.
Une instance du gestionnaire générateur est à usage unique, mais en tant que décorateur un nouveau générateur est créé à chaque appel de la fonction décorée. La décoration de fonctions asynchrones est disponible depuis 3.10. Un unique yield fournit la valeur de as et finally peut attendre le nettoyage. Une exception du corps revient dans le générateur au yield et doit être relancée après interception pour se propager.
L’exemple fournit 8 et affiche closed à la sortie.
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())
Exemples
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())
Résultat
8 closed
L’exemple fournit 8 et affiche closed à la sortie.