Декоратор свойства

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

Вот пример класса, использующего @property:

class Circle:
    def __init__(self, radius):
        self._radius = radius
    
    @property
    def radius(self):
        return self._radius
    
    @property
    def area(self):
        return 3.14159 * self._radius ** 2

Обрати внимание, что мы используем self._radius для хранения фактического значения. Если бы мы использовали self.radius внутри геттера, он снова вызвал бы метод-геттер, что привело бы к бесконечной рекурсии.

Создай круг и получи доступ к его свойствам:

my_circle = Circle(5)

Получайте доступ к свойствам как к обычным атрибутам:

print(my_circle.radius)
print(my_circle.area)

Вывод:

5
78.53975

Обрати внимание: при обращении к свойствам скобки () не используются — они похожи на атрибуты, но выполняют код метода.

Добавь сеттер, чтобы можно было изменять значения с проверкой:

class Circle:
    def __init__(self, radius):
        self._radius = radius
    
    @property
    def radius(self):
        return self._radius
    
    @radius.setter
    def radius(self, value):
        if value > 0:
            self._radius = value
        else:
            print("Radius must be positive!")

Теперь ты можешь задать радиус как атрибут:

my_circle = Circle(5)
my_circle.radius = 10  # Использует сеттер
print(my_circle.radius)  # Использует геттер

Вывод:

10

Ключевой момент: @property позволяет методам выглядеть как атрибуты, а @property_name.setter позволяет контролировать присваивание значений, обеспечивая проверку данных и инкапсуляцию.