Ответ.

История вопроса:

В классическом ООП инкапсуляция реализуется через приватные поля и геттеры/сеттеры, что громоздко и не "по-питоновски". В Python начиная с версии 2.2 появился декоратор @property, позволяющий обращаться к методам-геттерам и сеттерам как к обычным атрибутам, реализуя грамотную инкапсуляцию с удобным синтаксисом.

Проблема:

Без декораторов property приходится явно определять методы для доступа и установки значения (например, get_x() и set_x(val)), что делает код менее читаемым, а пользователи класса не защищены от прямого доступа к внутренним данным. Возникают проблемы при рефакторинге и изменении внутренней логики хранения или вычисления значений.

Решение:

Декоратор @property позволяет определять геттеры, сеттеры и делетеры с помощью единого синтаксиса. Выглядит это лаконично, удобно, инкапсулирует детали реализации и позволяет прозрачно менять способ вычисления свойства без нарушения интерфейса класса.

Пример кода:

class Temperature:
    def __init__(self, celsius):
        self._celsius = celsius

    @property
    def celsius(self):
        return self._celsius

    @celsius.setter
    def celsius(self, value):
        if value < -273.15:
            raise ValueError("Temperature below -273.15°C is not possible!")
        self._celsius = value

Ключевые особенности:

Декоратор @property позволяет обращаться к методам как к обычным атрибутам.
Легко добавлять логику валидации или кэширования.
Изменение логики без смены интерфейса — пользователи класса не замечают изменений.

Вопросы с подвохом.

Можно ли сделать свойство только для чтения, но не для записи/удаления?

Да, если определить только метод с декоратором @property без сеттера и делетера, свойство будет доступно только для чтения.

class Sample:
    @property
    def value(self):
        return 42

Что произойдет, если имя property совпадает с приватным атрибутом?

Обычно property используется как "прослойка" к приватному атрибуту, имя которого начинается с подчеркивания (например, _x). Такого совпадения следует избегать, иначе возникнет рекурсивный вызов:

class Bad:
    @property
    def x(self):
        return self.x  # Бесконечная рекурсия

Можно ли назначить property только для класса?

Нет, стандартный @property работает с экземплярами класса. Для создания class property следует использовать сторонние паттерны или специальные библиотеки (@classmethod вместе с property не работают напрямую).

Типовые ошибки и анти-паттерны

Неправильное именование атрибутов (например, дублирование имени property и внутреннего поля).
Неправильно реализованный сеттер приводит к рекурсивному вызову.
Злоупотребление property для свойств, которые не требуют вычисления/валидации.

Пример из жизни

Негативный кейс

Разработчик напрямую обращается к полю класса (self.celsius), а не через property. Позже добавляется валидация, но потребители класса все еще могут напрямую модифицировать приватный атрибут и обходить проверки.

Плюсы:

Просто и быстро работать, пока нет сложной логики.

Минусы:

Нарушена инкапсуляция, легко получить некорректное состояние объекта, возникает путаница.

Позитивный кейс

Использование property и сокрытие внутреннего атрибута через _celsius. Валидация, кэширование и логика централизуются внутри property.