Appearance
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 уже используется клиентским кодом. Чтобы начать валидировать:
- переименовать хранилище:
self._x(илиself.__x); - объявить
@propertyxи getter; - когда проверка готова — добавить
@x.setter; - на время миграции можно временно прописывать
x = _xчерезsetattrв__init__.
Клиентский код obj.x = 10 продолжает работать, но теперь через сеттер.
Проверьте себя
Что такое `property`?
Что произойдёт при `box.length = 15`?
Почему хранилище называется `self.__length`, а не `self.length`?
Что будет при записи в свойство, у которого есть только getter (read-only)?
Как создавали property до декораторов?
Атрибут `obj.x` уже использует клиентский код. Как добавить валидацию через property?
Упражнения:
Перепишите
ParcelBoxиз предыдущего урока полностью наproperty:length,width,height— со сеттерами,volume— только чтение.Создайте класс
Age-обёртку: классPersonсpropertyage, принимающим толькоintот 0 до 150.Реализуйте в
Personpropertyfull_nameизfirst_name+last_name, доступный только для чтения.Убедитесь, что
person.full_name = 'X'вызываетAttributeError, аperson.age = -1—ValueError.Возьмите класс
RomanNumberиз предыдущего урока. Замените паруget_roman/set_romanнаpropertyroman(хранение —self.__roman, сеттер с той же валидацией) и добавьте read-onlypropertyarabic, возвращающие целое значение. Проверьте:pythonrn = 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.