Skip to content

Property - Свойство property ​

property — встроенный дескриптор, который превращает пару методов «getter/setter» в атрибут по имени: клиент пишет привычный box.length = 15, а за кулисами вызывается ваш set_length с проверкой. Валидация из предыдущего урока остаётся, громоздкость — исчезает.

Базовая схема ​

python
class ParcelBox:
    def __init__(self, length, width, height):
        self.length = length   # вызывает length.setter
        self.width = width
        self.height = height

    @property
    def length(self):
        return self.__length

    @length.setter
    def length(self, value):
        if not isinstance(value, int):
            raise TypeError('Length must be "int"')
        if value > 0:
            self.__length = value
        else:
            raise ValueError(f'Length must be more than 0, got: {value = }')

    # width / height — та же схема


box = ParcelBox(10, 2, 3)
print(box.length)          # 10 — getter вызывается автоматически
box.length = 15            # setter с валидацией
print(box.length)          # 15
# box.length = -1          # ValueError: Length must be more than 0
# box.length = '10'        # TypeError: Length must be "int"

Хранение в self.__length (два подчёркивания) защищает от рекурсии: self.length = value внутри сеттера без mangling вызвал бы сам себя.

Свойство без сеттера — только чтение ​

Если нужен только getter — это read-only свойство. Попытка записи падает:

python
class ParcelBox:
    def __init__(self, length, width, height):
        self.__length, self.__width, self.__height = length, width, height

    @property
    def volume(self):
        return self.__length * self.__width * self.__height


b = ParcelBox(10, 2, 3)
print(b.volume)            # 60 — вычисляется на лету
# b.volume = 1000          # AttributeError: can't set attribute

Отлично для производных величин: объём не «хранят», а считают.

Классический синтаксис ​

Перед декораторами property создавали вручную — тот же механизм:

python
class ParcelBoxLegacy:
    def __init__(self, length):
        self.__length = length

    def get_length(self):
        return self.__length

    def set_length(self, value):
        if value > 0:
            self.__length = value
        else:
            raise ValueError(value)

    length = property(fget=get_length, fset=set_length, doc='Length in cm')


b = ParcelBoxLegacy(5)
b.length = 7
print(b.length, ParcelBoxLegacy.length.__doc__)   # 7 Length in cm

Как добавлять property в живой класс ​

Типичный сценарий: атрибут obj.x уже используется клиентским кодом. Чтобы начать валидировать:

  1. переименовать хранилище: self._x (или self.__x);
  2. объявить @property x и getter;
  3. когда проверка готова — добавить @x.setter;
  4. на время миграции можно временно прописывать x = _x через setattr в __init__.

Клиентский код obj.x = 10 продолжает работать, но теперь через сеттер.

Проверьте себя ​

❓Что такое `property`?
❓Что произойдёт при `box.length = 15`?
❓Почему хранилище называется `self.__length`, а не `self.length`?
❓Что будет при записи в свойство, у которого есть только getter (read-only)?
❓Как создавали property до декораторов?
❓Атрибут `obj.x` уже использует клиентский код. Как добавить валидацию через property?

Упражнения: ​

  1. Перепишите ParcelBox из предыдущего урока полностью на property: length, width, height — со сеттерами, volume — только чтение.

  2. Создайте класс Age-обёртку: класс Person с property age, принимающим только int от 0 до 150.

  3. Реализуйте в Person property full_name из first_name + last_name, доступный только для чтения.

  4. Убедитесь, что person.full_name = 'X' вызывает AttributeError, а person.age = -1 — ValueError.

  5. Возьмите класс RomanNumber из предыдущего урока. Замените пару get_roman/set_roman на property roman (хранение — self.__roman, сеттер с той же валидацией) и добавьте read-only property arabic, возвращающие целое значение. Проверьте:

    python
    rn = RomanNumber('XIV')
    print(rn.roman)     # XIV
    rn.roman = 'VII'
    print(rn.arabic)    # 7
    # rn.arabic = 7     # AttributeError: can't set attribute
    # rn.roman = 'abc'  # ValueError

    Сквозной трек RomanNumber завершён: рождение → __str__/__repr__ → арифметика → сравнения → get_/set_ → property.