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

CKTIS / Python

contextlib.AsyncExitStack

Empile les nettoyages synchrones et asynchrones dans l’ordre LIFO.

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

Syntaxe

async with contextlib.AsyncExitStack() as stack:

Empile les nettoyages synchrones et asynchrones dans l’ordre LIFO.

push_async_callback ne supprime pas d’exception, tandis qu’une fonction inscrite avec push_async_exit reçoit les données d’exception et peut la supprimer par un résultat vrai. pop_all transfère toutes les actions sans les exécuter. enter_async_context attend l’entrée et inscrit la sortie, push_async_callback inscrit un nettoyage sans arguments d’exception. callback accepte les fonctions ordinaires. La sortie ou await aclose() exécute second avant first.

Le résultat d’un callback inscrit ainsi ne supprime pas d’exception.

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

Exemples

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

Résultat

second
first

Le résultat d’un callback inscrit ainsi ne supprime pas d’exception.

Sources