WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

contextlib.asynccontextmanager

Macht aus einer asynchronen Generatorfunktion eine Fabrik für async with.

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

Syntax

@contextlib.asynccontextmanager

Macht aus einer asynchronen Generatorfunktion eine Fabrik für async with.

Ein einzelner Generatormanager ist einmalig nutzbar, beim Einsatz als Dekorator entsteht für jeden Funktionsaufruf ein neuer Generator. Das Dekorieren asynchroner Funktionen ist seit 3.10 möglich. Genau ein yield liefert den as-Wert, finally kann das Aufräumen abwarten. Eine Ausnahme aus dem Rumpf wird am yield in den Generator geworfen und muss nach Abfangen zur Weitergabe erneut ausgelöst werden.

Im Beispiel wird 8 bereitgestellt und am Ende closed ausgegeben.

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

Beispiele

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

Ergebnis

8
closed

Im Beispiel wird 8 bereitgestellt und am Ende closed ausgegeben.

Quellen