python - 如何获取属性的文档字符串属性？

Question

当我学习 Python 描述符时，我遇到了这个例子

class Person(object):
    def __init__(self):
        self._name = ''

    def fget(self):
        print("Getting: %s" % self._name)
        return self._name

    def fset(self, name):
        print("Setting: %s" % name)
        self._name = name.title()

    def fdel(self):
        print("Deleting: %s" %self._name)
        del self._name

    name = property(fget, fset, fdel, "I'm the property.")

它使用property函数。 article说第四个参数是doc - docstring，

p1 = Person()
p1.name = "Islam"
print(p1.name)
print(p1.name.doc)
del p1.name

但是当我尝试去查看文档时，它会出现

AttributeError: 'str' object has no attribute 'doc'

Answer 1

首先，由于文档字符串是一个神奇的属性，它应该位于 double leading and trailing underscore 中形式。所以，它是 __doc__ 而不是 doc。

其次，当您尝试从类的实例访问 __doc__ 时，它将触发实际对象的 doc 属性，在本例中是一个字符串。相反，尝试从类对象访问属性:

In [74]: Person.name.__doc__
Out[74]: "I'm the property."