Як працюють властивості Python?

Я успішно використовую властивості Python, але я не бачу, як вони можуть працювати. Якщо я розмежую властивість поза класом, я просто отримую об'єкт типу property:

@property
def hello(): return "Hello, world!"

hello  # <property object at 0x9870a8>

Але якщо я кладу властивість у клас, поведінка зовсім інша:

class Foo(object):
   @property
   def hello(self): return "Hello, world!"

Foo().hello # 'Hello, world!'

Я помітив, що unbound Foo.helloвсе ще є propertyоб'єктом, тому екземпляр класу повинен робити магію, але що це за магія?

Як зазначали інші, вони використовують мовну функцію, яка називається дескрипторами.

Причина повернення фактичного об'єкта властивості при доступі до нього через клас Foo.helloполягає у тому, як властивість реалізує __get__(self, instance, owner)спеціальний метод:

• Якщо до екземпляра здійснюється доступ до дескриптора , тоді цей екземпляр передається як відповідний аргумент і ownerє класом цього екземпляра.
• Коли доступ до нього здійснюється через клас, тоді instanceзначення None і ownerпередається лише . propertyОб'єкт розпізнає це і повертається self.

Окрім інструкцій дескрипторів , див. Також документацію щодо впровадження дескрипторів та виклику дескрипторів у Мовному посібнику.

Для того, щоб @properties працював належним чином, клас повинен бути підкласом об'єкта . коли клас не є підкласом об'єкта, тоді, коли ви вперше намагаєтесь отримати доступ до сеттера, він фактично робить новий атрибут із коротшим ім'ям, замість того, щоб здійснювати доступ через сеттер.

Наступне нічого НЕ працює правильно.

class C(): # <-- Notice that object is missing

    def __init__(self):
        self._x = None

    @property
    def x(self):
        print 'getting value of x'
        return self._x

    @x.setter
    def x(self, x):
        print 'setting value of x'
        self._x = x

>>> c = C()
>>> c.x = 1
>>> print c.x, c._x
1 0

Наступне буде працювати правильно

class C(object):

    def __init__(self):
        self._x = None

    @property
    def x(self):
        print 'getting value of x'
        return self._x

    @x.setter
    def x(self, x):
        print 'setting value of x'
        self._x = x

>>> c = C()
>>> c.x = 1
setting value of x
>>> print c.x, c._x
getting value of x
1 1

Властивості є дескрипторами , і дескриптори поводяться спеціально, коли є членом екземпляра класу. Коротше кажучи, якщо aє екземпляром типу Aі A.fooє дескриптором, то a.fooце еквівалентно A.foo.__get__(a).

propertyОб'єкт просто реалізує протокол дескриптора: http://docs.python.org/howto/descriptor.html