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

CKTIS / Python

ExitStack.close() : nettoyage explicite dans l’ordre LIFO

Enregistrez les gestionnaires de contexte à l’exécution, puis appelez `stack.close()` pour libérer leurs ressources dans l’ordre inverse de l’enregistrement, avant la fin du bloc `with`.

Version : Python 3.12

Syntaxe

from contextlib import ExitStack

with ExitStack() as stack:
    for cm in managers:
        value = stack.enter_context(cm)
        # Use value while its context is active.
    stack.close()

Quand le nombre de gestionnaires de contexte dépend des données d’entrée, appelez stack.enter_context(cm) à l’intérieur de with ExitStack() as stack:. La méthode appelle cm.__enter__(), renvoie son résultat et enregistre cm.__exit__() si l’entrée réussit. Si l’entrée dans un contexte suivant échoue, le bloc with garantit tout de même l’appel des fonctions de sortie des contextes déjà enregistrés.

contextlib.ExitStack.close est une méthode synchrone qui s’appelle sans argument : stack.close(). Elle dépile et exécute immédiatement les fonctions enregistrées, dans l’ordre inverse de leur enregistrement (LIFO). Elle ne quitte pas le bloc with : si l’appel se termine normalement, l’exécution continue. La sortie du bloc ne rappelle pas les fonctions déjà dépilées. N’utilisez plus les ressources libérées lors du nettoyage.

Un appel explicite à close() lance le nettoyage comme si aucune exception ne s’était produite. En revanche, si une exception sort du corps du bloc with, la sortie automatique transmet ses détails aux fonctions de sortie encore sur la pile. Si une fonction lève ou supprime une exception pendant le nettoyage, les fonctions de sortie suivantes reçoivent l’état mis à jour. Une exception de nettoyage non supprimée peut se propager hors de close().

Appelez close() si le nettoyage doit avoir lieu avant la fin du bloc. Sinon, laissez with s’en charger automatiquement. Le ramasse-miettes n’exécute pas les fonctions enregistrées.

Exemples

from contextlib import ExitStack, contextmanager


@contextmanager
def traced(name):
    print(f"enter {name}")
    try:
        yield name
    finally:
        print(f"exit {name}")


names = ["A", "B", "C"]
with ExitStack() as stack:
    active = [stack.enter_context(traced(name)) for name in names]
    print("use:", ", ".join(active))
    stack.close()
    print("still inside")
print("outside")

Résultat

enter A
enter B
enter C
use: A, B, C
exit C
exit B
exit A
still inside
outside

`names` détermine les contextes enregistrés dans `with`. Dans la sortie attendue, les lignes `exit` apparaissent dans l’ordre C, B, A, avant `still inside`. Elles ne sont pas réaffichées à la sortie du bloc.

Leçons associées

  • Python · Leçon 12 · Avancé · Version : 5

Sources