Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.contextmanager

Decora 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.

Fontes