Декораторы классов — мощный инструмент для создания элегантного ООП-кода в Python. Но чтобы использовать их эффективно, нужно понимать разницу между @classmethod, @staticmethod и @property. Разберём каждый на реалистичных примерах с сравнением подходов.

@property: Контролируемый доступ к атрибутам

Проблема без декоратора:
Без @property для валидации данных приходится использовать методы-сеттеры, что ломает естественность работы с атрибутами.

class UserWithoutProperty:
    def __init__(self, name):
        self.name = name
        self._age = 0

    def get_age(self):
        return self._age

    def set_age(self, value):
        if not (0 < value < 120):
            raise ValueError("Invalid age")
        self._age = value

# Неудобное использование:
user = UserWithoutProperty("Alice")
user.set_age(25)  # Вызов метода вместо присваивания
print(user.get_age())  # Не как обычное свойство

Решение с @property:
Декоратор превращает методы в атрибуты с логикой:

class User:
    def __init__(self, name):
        self.name = name
        self._age = 0

    @property
    def age(self):
        return f"Возраст: {self._age} лет"

    @age.setter
    def age(self, value):
        if not (0 < value < 120):
            raise ValueError("Недопустимый возраст")
        self._age = value

# Естественное использование:
user = User("Bob")
user.age = 30  # Вызывает сеттер с валидацией
print(user.age)  # Возраст: 30 лет (геттер форматирует данные)

Плюсы:
Инкапсуляция внутреннего состояния
Валидация при установке значений
Ленивые вычисления (например, загрузка данных по требованию)
Совместимость с обычным доступом к атрибутам

Минусы:
Избыточность для простых атрибутов без логики
Неочевидность побочных эффектов при чтении

@classmethod: Методы работы с классом

Проблема без декоратора:
Создание объектов из альтернативных источников требует внешних функций или запутанных конструкторов.

class ProductWithoutClassMethod:
    def __init__(self, name, price):
        self.name = name
        self.price = price

# Внешняя функция-конструктор
def create_product_from_csv(csv_string):
    name, price = csv_string.split(",")
    return ProductWithoutClassMethod(name, float(price))

# Проблема: функция не привязана к классу явно
product = create_product_from_csv("Ноутбук,120000")

Решение с @classmethod:
Создаём альтернативные конструкторы внутри класса:

class Product:
    def __init__(self, name, price, discount=0):
        self.name = name
        self.price = price
        self.discount = discount

    @classmethod
    def from_csv(cls, csv_string):
        name, price = csv_string.split(",")
        return cls(name, float(price))  # cls учитывает наследование

    @classmethod
    def from_json(cls, json_data):
        import json
        data = json.loads(json_data)
        return cls(data['name'], data['price'], data.get('discount', 0))

# Создание объектов разными способами:
product1 = Product.from_csv("Монитор,25000")
product2 = Product.from_json('{"name": "Клавиатура", "price": 3500}')

Плюсы:
Явная связь с классом
Поддержка наследования (работает с cls)
Группировка логики создания объектов
Замена негибких init

Минусы:
Риск нарушения SRP (слишком много обязанностей)
Сложная отладка при множественных конструкторах

@staticmethod: Логика, привязанная к классу

Проблема без декоратора:
Вспомогательные функции либо становятся методами экземпляра (лишний self), либо выносятся за класс.

class Order:
    def __init__(self, items):
        self.items = items

    # Избыточный self в методе экземпляра
    def calculate_tax(self, price):
        return price * 0.2  # НДС 20%

# Или функция вне класса (потеря контекста)
def format_currency(value):
    return f"{value:.2f} ₽"

order = Order([...])
tax = order.calculate_tax(1000)  # self не используется!

Решение с @staticmethod:
Статические методы живут внутри класса без доступа к экземпляру:

class Order:
    def __init__(self, items):
        self.items = items

    @staticmethod
    def calculate_tax(price):
        return price * 0.2

    @staticmethod
    def format_currency(value):
        return f"{value:.2f} ₽"

    def total(self):
        subtotal = sum(item['price'] for item in self.items)
        tax = self.calculate_tax(subtotal)  # Вызов статического метода
        return self.format_currency(subtotal + tax)

# Использование:
order = Order([{"name": "Книга", "price": 500}])
print(order.total())  # "600.00 ₽"
print(Order.format_currency(150))  # Вызов без экземпляра

Плюсы:
Отсутствие неиспользуемого self
Чёткая принадлежность к классу
Возможность вызова без экземпляра
Улучшенная читаемость

Минусы:
Ограниченная полезность (часто можно использовать обычные функции)
Невозможность переопределения в наследниках

Сравнительная таблица:

Практические рекомендации:

@property
Используйте для атрибутов с валидацией/логикой
Избегайте тяжёлых вычислений в геттерах
Пример: кеширование результатов, конвертация единиц

@classmethod
Идеален для альтернативных конструкторов
Используйте cls() вместо прямого имени класса для поддержки наследования
Пример: парсинг данных из JSON/XML, подключение к БД

@staticmethod
Применяйте для утилитарных функций внутри класса
Если нужен доступ к состоянию — это обычный метод
Пример: математические вычисления, форматирование

💡 Главное правило: Выбирайте инструмент по задаче, а не по удобству. @property — для работы с атрибутами, @classmethod — для работы с классом, @staticmethod — для функций внутри класса.

Пример комплексного использования:

class Employee:
    TAX_RATE = 0.13  # НДФЛ

    def __init__(self, name, salary):
        self.name = name
        self._salary = salary

    @property
    def salary(self):
        return self._salary

    @salary.setter
    def salary(self, value):
        if value < 0:
            raise ValueError("Зарплата не может быть отрицательной")
        self._salary = value

    @classmethod
    def create_intern(cls):
        return cls("Стажёр", 30000)

    @staticmethod
    def calculate_net(salary):
        return salary * (1 - Employee.TAX_RATE)

    @property
    def net_income(self):
        return self.calculate_net(self.salary)

# Использование:
intern = Employee.create_intern()  # classmethod
print(intern.net_income)  # property + staticmethod

Каждый декоратор решает свою задачу, делая код выразительнее и поддерживаемее. Главное — применять их там, где они действительно нужны!