Что делает "@reify" и когда он должен использоваться?

Я видел это в учебнике Pyramid для дизайна UX. Я не мог понять, что это за декоратор.

Пример кода, где я видел его использование.

def __init__(self, request):
    self.request = request
    renderer = get_renderer("templates/global_layout.pt")
    self.global_template = renderer.implementation().macros['layout']

@reify
def company_name(self):
    return COMPANY

@reify
def site_menu(self):
    new_menu = SITE_MENU[:]
    url = self.request.url
    for menu in new_menu:
        if menu['title'] == 'Home':
            menu['current'] = url.endswith('/')
        else:
            menu['current'] = url.endswith(menu['href'])
    return new_menu

@view_config(renderer="templates/index.pt")
def index_view(self):
    return {"page_title": "Home"}

@view_config(renderer="templates/about.pt", name="about.html")
def about_view(self):
    return {"page_title": "About"}

Ответ 1

Из документации исходного кода:

"" Поместите результат метода, который использует это (не-данные) Декоратор дескриптора в экземпляре dict после первого вызова, эффективно заменяя декоратор переменной экземпляра. ""

Описание из из блога нечеткого блокнота подводит итог.

Он действует как @property, за исключением того, что функция только называется один раз; после этого значение кэшируется как обычный атрибут. Эта дает вам ленивое создание атрибутов на объектах, которые должны быть неизменны.

Итак, в коде, который вы опубликовали, site_menu может быть доступен как кешированное свойство.

Ответ 2

Согласно строке документа (источник):

""" Put the result of a method which uses this (non-data)
descriptor decorator in the instance dict after the first call,
effectively replacing the decorator with an instance variable."""