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.contextmanagerDé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.