Программирование
Что такое декоратор в Python?
Декоратор в Python — это функция, которая принимает другую функцию, оборачивает её дополнительной логикой и возвращает новую функцию. Декоратор обозначают символом @ над объявлением функции: запись @timer над def report() равнозначна report = timer(report).
Декораторы работают благодаря тому, что функции в Python — полноценные объекты: их можно передавать как аргументы и возвращать из других функций. Внутренняя функция-обёртка обычно принимает *args и **kwargs, чтобы подходить к любой функции, и использует замыкание для доступа к оригиналу.
Чтобы обёртка сохранила название и описание оригинальной функции, используют functools.wraps. Существуют также декораторы с параметрами (фабрики декораторов) и декораторы классов.
Где применяется
Декораторы широко используют во фреймворках: @app.get() в FastAPI и @app.route() во Flask задают маршруты, @login_required в Django проверяет авторизацию, @pytest.fixture и @pytest.mark отмечают фикстуры и тесты. Встроенные декораторы — @property, @staticmethod, @classmethod, @functools.cache.
Собственные декораторы пишут для логирования, измерения времени выполнения, повторных попыток при ошибках, кеширования результатов, проверки прав доступа и валидации аргументов.
Пример
Декоратор, измеряющий время выполнения функции.
import time
from functools import wraps
def timer(func):
@wraps(func)
def wrapper(*args, **kwargs):
start = time.perf_counter()
result = func(*args, **kwargs)
print(f"{func.__name__}: {time.perf_counter() - start:.3f}s")
return result
return wrapper
@timer
def load_report(rows):
return sum(range(rows))
load_report(1_000_000) # load_report: 0.021s
Частые вопросы
Зачем functools.wraps?
Без него декорированная функция получит название и документацию обёртки (wrapper), что мешает отладке, документированию и работе некоторых библиотек. wraps копирует эти данные из оригинальной функции.
Как сделать декоратор с параметрами?
Нужен ещё один уровень вложенности: внешняя функция принимает параметры и возвращает сам декоратор. Например, @retry(times=3).
Чем декораторы Python отличаются от аннотаций Java?
Аннотации в Java — только метки с метаданными, которые обрабатывает фреймворк. Декоратор в Python — исполняемый код, который реально заменяет функцию на новую.
Обучение программированию в OWU
Освойте профессию в IT на практических курсах с менторами и реальными проектами.
Выбрать курс