База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

contextlib.contextmanager

Декорира функция на генератор с един yield като фабрика за еднократни мениджъри на with.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

@contextlib.contextmanager

Декорира функция на генератор с един yield като фабрика за еднократни мениджъри на with.

Един екземпляр на мениджъра от генератор е еднократен, но като декоратор се създава нов генератор при всяко извикване на декорираната функция. Преди yield се извършва подготовката, а стойността се свързва с as. Грешка от тялото се подава при yield и се потиска, ако генераторът я прихване и завърши нормално. finally осигурява почистването.

Тук closed идва преди 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

Примери

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")

Резултат

4
closed
handled

Тук closed идва преди handled.

Източници