Что такое декораторы?

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

Для применения декоратора к целевой функции используется специальный синтаксический сахар в виде символа собаки и имени декоратора, который записывается прямо над определением нужной функции. Например, написание конструкции перед функцией автоматически передает эту функцию внутрь декоратора и заменяет ее результат на обертку, созданную внутри декораторной функции.

Классическая структура декоратора включает в себя внешнюю функцию, принимающую целевую функцию, и внутреннюю функцию обертку, которая часто называется wrapper. Эта внутренняя функция принимает произвольные позиционные и именованные аргументы через звездочки, что позволяет декорировать функции с абсолютно любой сигнатурой вызова.

При написании декораторов крайне важно использовать специальный инструмент из стандартной библиотеки модуль functools и его декоратор wraps, который накладывается на внутреннюю обертку. Это необходимо для того, чтобы оригинальное имя функции и ее документация не заменялись именем обертки, сохраняя полезную информацию для отладки.

В повседневной разработке на Python разработчики часто сталкиваются со встроенными декораторами, такими как property для создания управляемых атрибутов класса, а также staticmethod и classmethod для определения статических методов и методов класса соответственно.