Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

contextlib.asynccontextmanager

Convierte una función generadora asíncrona en fábrica para async with.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

@contextlib.asynccontextmanager

Convierte una función generadora asíncrona en fábrica para async with.

Cada instancia del gestor generador es de un solo uso, pero como decorador crea un generador nuevo en cada llamada a la función decorada. La decoración de funciones asíncronas está disponible desde 3.10. Un único yield da el valor de as y finally puede esperar la limpieza. Una excepción del cuerpo se inyecta en el generador en yield y debe relanzarse tras capturarla para propagarse.

El ejemplo ofrece 8 y muestra closed al salir.

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())

Ejemplos

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

El ejemplo ofrece 8 y muestra closed al salir.

Fuentes