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

CKTIS / Python

contextlib.contextmanager

Décore une fonction génératrice à un seul yield pour créer des gestionnaires with à usage unique.

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

Syntaxe

@contextlib.contextmanager

Décore une fonction génératrice à un seul yield pour créer des gestionnaires with à usage unique.

Une instance du gestionnaire générateur est à usage unique, mais en tant que décorateur un nouveau générateur est créé à chaque appel de la fonction décorée. Avant yield se fait la préparation et sa valeur est liée à as. Une erreur du corps revient au yield et disparaît si le générateur la capture puis termine normalement. finally assure le nettoyage.

Ici closed précède handled.

from contextlib import contextmanager
seen = []
@contextmanager
def scope():
    try:
        yield "open"
    except LookupError:
        seen.append("handled")
        raise
    finally:
        seen.append("closed")
try:
    with scope() as x:
        assert x == "open"
        raise KeyError
except KeyError:
    assert seen == ["handled", "closed"]
@scope()
def check():
    return 3
assert check() == check() == 3

Exemples

import contextlib
@contextlib.contextmanager
def measure():
    try:
        yield 4
    finally:
        print("closed")

try:
    with measure() as value:
        print(value)
        raise ValueError
except ValueError:
    print("handled")

Résultat

4
closed
handled

Ici closed précède handled.

Sources