CKTIS / Python
contextlib.contextmanager
Decora uma função geradora com um único yield como fábrica de gestores with de utilização única.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
@contextlib.contextmanagerDecora uma função geradora com um único yield como fábrica de gestores with de utilização única.
Cada instância do gestor gerador é de utilização única, mas como decorador cria um novo gerador a cada chamada da função decorada. Antes de yield ocorre a preparação e o valor é associado a as. Um erro do corpo regressa em yield e é suprimido se o gerador o capturar e terminar normalmente. finally assegura a limpeza.
Aqui closed precede 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
Exemplos
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")
Resultado
4 closed handled
Aqui closed precede handled.