Програмування
Що таке декоратор у 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 на практичних курсах із менторами та реальними проєктами.
Обрати курс