Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

contextlib.AsyncExitStack

Empilha limpezas síncronas e assíncronas em ordem LIFO.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

async with contextlib.AsyncExitStack() as stack:

Empilha limpezas síncronas e assíncronas em ordem LIFO.

push_async_callback não suprime exceções, enquanto uma função registada com push_async_exit recebe os dados da exceção e pode suprimi-la com um resultado verdadeiro. pop_all transfere todas as ações sem as executar. enter_async_context aguarda a entrada e regista a saída, push_async_callback regista limpeza sem argumentos de exceção. callback aceita funções normais. A saída ou await aclose() executa second antes de first.

O resultado de uma função registada com callback não suprime exceções.

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

Exemplos

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

Resultado

second
first

O resultado de uma função registada com callback não suprime exceções.

Fontes