property (свойство)

Позволяет использовать методы в качестве свойств объектов — порождает дескриптор, позволяющий создавать «вычисляемые» свойства (тип property).

Пример использования в классическом виде:

    class Mine(object):

        def __init__(self):
            self._x = None

        def get_x(self):
            return self._x

        def set_x(self, value):
            self._x = value

        def del_x(self):
            self._x = 'No more'

        x = property(get_x, set_x, del_x, 'Это свойство x.')

    type(Mine.x)  # property
    mine = Mine()
    mine.x  # None
    mine.x = 3
    mine.x  # 3
    del mine.x  
    mine.x  # No more

Используя функцию в качестве декоратора можно легко создавать вычисляемые свойства только для чтения:

    class Mine(object):

        def __init__(self):
            self._x = 'some value'

        @property
        def prop(self):
            return self._x

    mine = Mine()
    mine.prop  # some value
    mine.prop = 'other value'  # AttributeError
    del mine.prop  # AttributeError

+py2.6 Объект свойства также предоставляет методы getter, setter, deleter, которые можно использовать в качестве декораторов для указания функций реализующих получение, установку и удаление свойства соответственно. Следующий код эквивалентен коду из первого примера:

    class Mine(object):

        def __init__(self):
            self._x = None

        x = property()

        @x.getter
        def x(self):
            """Это свойство x."""
            return self._x

        @x.setter
        def x(self, value):
            self._x = value

        @x.deleter
        def x(self):
            self._x = 'No more'

+py3.5 Добавлена возможность установки строки документации для объекта-свойства.