Почему без wraps теряется информация о декорируемой функции?

Потеря метаданных — это прямое следствие того, как работают декораторы.

Что происходит технически

Декоратор:

• принимает функцию

• создаёт новую функцию (wrapper)

• возвращает её вместо исходной

Для интерпретатора:

• оригинальная функция больше не видна

• доступен только wrapper

Какая информация теряется

Без wraps у функции пропадают:

• __name__

• __doc__

• __annotations__

• информация о сигнатуре

Это особенно критично для:

• фреймворков

• декораторов декораторов

• автогенерации документации

Роль functools.wraps

wraps:

• копирует метаданные исходной функции

• сохраняет ссылку на неё в __wrapped__

• делает декоратор «прозрачным»

Пример:

from functools import wraps

def dec(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs)
    return wrapper

Последствия отсутствия wraps

Без wraps:

• отладка усложняется

• introspection работает некорректно

• инструменты могут ломаться без явной ошибки

Краткий вывод

functools.wraps необходим для сохранения метаданных и корректной работы декораторов в реальных проектах.