Что такое @property и зачем он нужен?

property — встроенный дескриптор. Методы с декоратором @property вызываются при обращении к атрибуту, без скобок.

Зачем:

• вычисляемые атрибуты — rect.area считается из ширины и высоты;
• проверка значений — сеттер не даст записать отрицательный возраст;
• только для чтения — если сеттер не объявлен, присваивание бросит AttributeError;
• эволюция интерфейса — класс начинается с обычного публичного атрибута, а когда появляется логика, атрибут заменяют на property. Код, который пишет obj.x, менять не нужно. Поэтому в Python не принято сразу писать геттеры и сеттеры, как в Java.

Значение обычно хранят в атрибуте с подчёркиванием (self._age) — это соглашение «внутреннее, не трогать снаружи». Двойное подчёркивание включает искажение имени (name mangling) и нужно редко.

Для дорогих вычислений, которые не меняются, есть functools.cached_property.

class Person:
    def __init__(self, age):
        self.age = age               # проходит через сеттер

    @property
    def age(self):
        return self._age

    @age.setter
    def age(self, value):
        if value < 0:
            raise ValueError("возраст не может быть отрицательным")
        self._age = value

    @property
    def is_adult(self):              # только чтение
        return self._age >= 18

p = Person(20)
p.age = -1        # ValueError
p.is_adult = True # AttributeError