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 на практичних курсах із менторами та реальними проєктами.

Обрати курс