Как декораторы влияют на метаданные функций?

Question

При декорировании функция заменяется на обёртку. В результате теряются имя функции, docstring и другие метаданные. По умолчанию Python не копирует эти данные автоматически. Для сохранения информации используется специальный механизм.

YeaHub · Accepted Answer

Декоратор технически подменяет одну функцию другой, что напрямую влияет на метаданные.Что происходит при декорированииПосле применения декоратора:имя функции меняется на имя wrapper__doc__ может стать Noneтеряется информация о сигнатуреЭто особенно критично для:документацииотладчиковфреймворковКакие метаданные затрагиваютсяЧаще всего теряются:__name____doc____module____annotations__Почему это проблемаПроблемы проявляются, когда:используются автогенераторы документацииприменяется introspectionфреймворк анализирует сигнатуру функцииКак это исправляетсяДля сохранения метаданных используется functools.wraps.Пример:from functools import wraps

def my_decorator(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs)
    return wrapper
Краткий выводБез специальных мер декораторы разрушают метаданные функций, что может ломать инструменты и фреймворки, полагающиеся на introspection.