Phone icon Связаться с нами

Программирование

Что такое декоратор в 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
Функция-обёртка, *args, **kwargs и functools.wraps.

Частые вопросы

Зачем functools.wraps?

Без него декорированная функция получит название и документацию обёртки (wrapper), что мешает отладке, документированию и работе некоторых библиотек. wraps копирует эти данные из оригинальной функции.

Как сделать декоратор с параметрами?

Нужен ещё один уровень вложенности: внешняя функция принимает параметры и возвращает сам декоратор. Например, @retry(times=3).

Чем декораторы Python отличаются от аннотаций Java?

Аннотации в Java — только метки с метаданными, которые обрабатывает фреймворк. Декоратор в Python — исполняемый код, который реально заменяет функцию на новую.

Обучение программированию в OWU

Освойте профессию в IT на практических курсах с менторами и реальными проектами.

Выбрать курс