<jupyter_start><jupyter_text>Свойства (Property)

В Python использование классов может быть очень гибким. Помимо механизма
слотов, дескрипторов и примесей присутствует также механизм свойств или
properties. Под капотом он реализован с использованием дескрипторов. Но
знать как они работают совершенно не обязательно для использования
свойств. В общем случае свойства позволяют модифицировать логику записи,
чтения или удаления атрибутов, т.е. они упрощают работу с дескрипторами.
Теперь вам не придется писать дополнительные классы для этого.

Использование свойств позволяет обращаться к методам класса как к
атрибутам, т.е. не указывая круглые скобки. Это работает только при
условии, что метод имеет определенные аргументы или не имеет их вовсе.

Рассматрим пример использования свойства с простым классов человека, у
которого есть атрибут дата дня рождения `birthday`. Вполне логично, что
мы не хотим хранить возраст человека в виде числа в обычном атрибуте,
т.к. он будет периодически изменяться. Следить за этими изменениями не
очень хочеться. С другой стороны возраст легко вычислить. Для этого
создадим метод `age`. Зачастую возраст считает характеристикой человека,
поэтому хотелось бы иметь атрибут `age` и не писать круглые скобки.
Также желательно запретить его редактирование вручную. Реализуем все это
с помощью свойств.

Использование свойства, отвечающего за чтение данных очень просто,
достаточно декорировать нужный метода декоратором `property`. Стоит
отметить, что методы, декорируемые таком образом, не должны принимать
никаких страбутов.<jupyter_code>from datetime import date


class Human:
    def __init__(self, birthday):
        self.birthday = birthday
    
    @property
    def age(self):
        return (date.today() - self.birthday).days // 365<jupyter_output><empty_output><jupyter_text>Теперь у объекта класса `Human` есть "псевдо" атрибут `age`. Обратиться
к нему можно без скобок.<jupyter_code>man = Human(date(2000, 1, 1))
print(f'{man.birthday = }')
print(f'{man.age = }')<jupyter_output>man.birthday = datetime.date(2000, 1, 1)
man.age = 21<jupyter_text>Так как выше мы использовали только декоратор `property`, то свойство
`age` доступно только для чтения. Попытка записи возбудит исключение
`AttributeError`.<jupyter_code>man.age = 42<jupyter_output><empty_output><jupyter_text>Для поддержки операций записи и удаления нужно использовать декораторы в
виде `attr_name.setter` и `attr_name.deleter` соответственно, где 
`attr_name` имя декорируемого атрибута. Стоит отметить, что для
использования "сеттера" и "делитера" необходимо определить "геттер",
т.е. свойство с декоратором `property`.

Обратите внимание на сигнатуры каждого метода. Они должны бить именно
такими. Только свойство записи модет принимать один аргумент - значение,
которое должно быть записано.<jupyter_code>class Useless:
    def __init__(self, foo):
        self._foo = foo

    @property
    def foo(self):
        return self._foo

    @foo.setter
    def foo(self, value):
        print('Попытка записи в атрибут foo')
        self._foo = value

    @foo.deleter
    def foo(self):
        print(f'Попытка удаления атрибута foo')
        del self._foo
useless = Useless('spam')
print(f'{useless.foo = }')
useless.foo = 'lovely spam'
print(f'{useless.foo = }')
del useless.foo
print(f'{useless.foo = }')<jupyter_output>Попытка удаления атрибута foo
{'fraction_non_alphanumeric': 0.07250221043324491, 'fraction_numerical': 0.005599764220453876, 'mean_word_length': 4.637873754152824, 'pattern_counts': {'":': 0, '<': 15, '<?xml version=': 0, '>': 15, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'chain_length': '4', 'dir': 'jupyter-structured-clean-dedup', 'id': '76794', 'license': 'MIT', 'n_tokens_mistral': 1359, 'n_tokens_neox': 1531, 'n_words': 370, 'path': 'python_pd/06_classes/08_property.ipynb', 'repo_name': 'Alexey-smurf/python-bp', 'size': '3393'}