Что такое декоратор в Python и зачем внутри него functools.wraps?
Проверила команда Сопровод · Обновлено
Короткий ответ
Декоратор — функция, которая принимает функцию и возвращает новую, обычно обертку с дополнительной логикой: проверкой прав, логированием, кэшем. Запись @admin_only над def edit_catalog означает edit_catalog = admin_only(edit_catalog). Обертка подменяет исходную функцию, и без functools.wraps теряются ее __name__ и __doc__. wraps копирует их на обертку и сохраняет ссылку на оригинал.
Почему этот вопрос задают
Декораторы стоят за @app.get во FastAPI, @login_required в Django и @pytest.fixture. Вопрос показывает, понимаете ли вы, что функция в Python — обычный объект, который можно передать и вернуть.
Как рассуждать
- Дайте определение: декоратор принимает функцию и возвращает функцию
- Расшифруйте синтаксис:
@decoнадdef fравносилен строкеf = deco(f) - Разведите моменты: декоратор срабатывает при определении функции, обертка — при каждом вызове
- Объясните, что теряется без
wrapsи где это видно: логи, отладка, документация
Ответ с примером
В админке онлайн-кинотеатра править каталог могут только администраторы. Декоратор admin_only получает функцию и возвращает wrapper: тот проверяет флаг пользователя и только после этого вызывает исходную функцию. Python применяет декоратор один раз, когда выполняет def edit_catalog, и дальше имя edit_catalog указывает на обертку. Поэтому вызов от гостя возвращает "доступ закрыт".
Строка @wraps(func) над def wrapper копирует на обертку __name__, __doc__, __module__ и __qualname__ исходной функции и добавляет атрибут __wrapped__ со ссылкой на оригинал. Первая строка вывода это подтверждает. Уберите @wraps(func), и она станет wrapper False: в логах, трассировках ошибок и документации все защищенные функции админки назывались бы одинаково.
def admin_only(func):
@wraps(func)
def wrapper(user):
return func(user) if user["admin"] else "доступ закрыт"
return wrapper
@admin_only
def edit_catalog(user):
return f"{user['name']} правит каталог"
print(edit_catalog.__name__, hasattr(edit_catalog, "__wrapped__"))
print(edit_catalog({"name": "Гость", "admin": False}))edit_catalog True доступ закрыт
Как ответить сильнее
Что добавит опытный кандидат
Что спросят следом
Доступно по подписке
Приемы опытных и готовые ответы
Частые ошибки
«Декоратор меняет код исходной функции»
Объясните, что исходная функция остается прежней. Декоратор возвращает новый объект, и имя в модуле начинает указывать на него
«
wrapsнужен для красоты, на работу он не влияет»Назовите, что ломается без него: имена в логах и трассировках, документация, фреймворки, которые читают параметры функции
«Декоратор можно написать только функцией»
Скажите, что подойдет любой вызываемый объект: класс с
__call__тоже работает как декоратор и хранит состояние в полях«Я всегда пишу
@admin_only()со скобками, так надежнее»Объясните, что скобки вызывают
admin_onlyбез аргументов, и Python применит к функции то, что вернул вызов. Для декоратора без параметров вызов упадет сTypeError
Сигналы для интервьюера
Сильный ответ
Расшифровывает @ как обычный вызов функции и объясняет, где в рабочем коде ломается обертка без wraps
Тревожный сигнал
Пишет рабочий декоратор по памяти, но не может сказать, в какой момент выполняется его внешняя функция
Красный флаг
Без подсказки не может написать простейший декоратор и путает его с обычным вызовом функции внутри функции
Как еще могут спросить
- Как работают декораторы в Python?
- Зачем нужен
functools.wraps? - Что делает символ
@перед функцией в Python? - Напишите простой декоратор и объясните, как он работает











