Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

contextlib.contextmanager

Decora una función generadora con un único yield como fábrica de gestores with de un solo uso.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

@contextlib.contextmanager

Decora una función generadora con un único yield como fábrica de gestores with de un solo uso.

Cada instancia del gestor generador es de un solo uso, pero como decorador crea un generador nuevo en cada llamada a la función decorada. Antes de yield se prepara el recurso y su valor se asigna a as. Un error del cuerpo vuelve en yield y se suprime si el generador lo captura y termina normalmente. finally asegura la limpieza.

Aquí closed precede a 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

Ejemplos

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

Aquí closed precede a handled.

Fuentes