KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

contextlib.asynccontextmanager

Maakt van een asynchrone generatorfunctie een fabriek voor async with.

Versie: Python 3.14; repository image, production runtime not attested

Syntax

@contextlib.asynccontextmanager

Maakt van een asynchrone generatorfunctie een fabriek voor async with.

Een instantie van de generatorbeheerder is eenmalig bruikbaar, maar als decorator maakt hij voor elke aanroep van de gedecoreerde functie een nieuwe generator. Het decoreren van asynchrone functies kan vanaf 3.10. Precies één yield levert de as-waarde en finally kan op opruimen wachten. Een uitzondering uit het blok komt op de yield terug in de generator en moet na afvangen opnieuw worden opgeworpen om door te gaan.

Hier wordt 8 geleverd en bij verlaten closed afgedrukt.

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

Voorbeelden

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

Resultaat

8
closed

Hier wordt 8 geleverd en bij verlaten closed afgedrukt.

Bronnen