CKTIS / Python
contextlib.asynccontextmanager
Transforma uma função geradora assíncrona numa fábrica para async with.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
@contextlib.asynccontextmanagerTransforma uma função geradora assíncrona numa fábrica para async with.
Cada instância do gestor gerador é de utilização única, mas como decorador cria um novo gerador a cada chamada da função decorada. A decoração de funções assíncronas está disponível desde 3.10. Um único yield fornece o valor de as e finally pode aguardar a limpeza. Uma exceção do corpo entra no gerador no yield e deve ser relançada após captura para se propagar.
O exemplo fornece 8 e apresenta closed ao sair.
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())
Exemplos
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())
Resultado
8 closed
O exemplo fornece 8 e apresenta closed ao sair.