Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.asynccontextmanager

Transforme 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.

Sources