WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

contextlib.AsyncExitStack

Sammelt synchrone und asynchrone Aufräumaktionen auf einem LIFO-Stapel.

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

Syntax

async with contextlib.AsyncExitStack() as stack:

Sammelt synchrone und asynchrone Aufräumaktionen auf einem LIFO-Stapel.

push_async_callback unterdrückt keine Ausnahme, während eine mit push_async_exit registrierte Funktion Ausnahmedaten empfängt und durch einen wahren Wert unterdrücken kann. pop_all überträgt alle Aktionen ohne Ausführung. enter_async_context erwartet den Eintritt und registriert den Austritt, push_async_callback registriert Aufräumen ohne Ausnahmeargumente. callback nimmt gewöhnliche Funktionen an. Austritt oder await aclose() führt second vor first aus.

Ein per callback registrierter Rückgabewert unterdrückt keine Ausnahme.

import asyncio
async def main():
    from contextlib import AsyncExitStack
    order = []
    async def release(name):
        order.append(name)
    s = AsyncExitStack()
    s.callback(order.append, "first")
    s.push_async_callback(release, "second")
    await s.aclose()
    assert order == ["second", "first"]
asyncio.run(main())
import asyncio
async def main():
    from contextlib import AsyncExitStack
    seen = []
    async def suppress_key(typ, exc, tb):
        seen.append(typ)
        return typ is KeyError
    s = AsyncExitStack()
    s.push_async_exit(suppress_key)
    owner = s.pop_all()
    await s.aclose()
    assert not seen
    async with owner:
        raise KeyError
    assert seen == [KeyError]
asyncio.run(main())

Beispiele

import contextlib
import asyncio

async def release(label):
    print(label)

async def main():
    async with contextlib.AsyncExitStack() as stack:
        stack.callback(print, "first")
        stack.push_async_callback(release, "second")

asyncio.run(main())

Ergebnis

second
first

Ein per callback registrierter Rückgabewert unterdrückt keine Ausnahme.

Quellen