属性的狮身人面像值报告为“无”

Question

当我使用狮身人面像车博士来记录一类，为属性的值总是报道，（因为它说，它应该在这里，在＃437），但始终是“=无”

Attribute = None
    Some Documentation

我把它像

.. autoclass:: core.SomeClass
   :members:

我的代码看起来像

class SomeClass(object):
    def __init__(self):
        self.attribute = "value" #: Some Documentation

有没有办法使“ = None”报告真实值，或使其消失？

Answer 1

我很确定这与您的属性是实例属性有关。在实例化该类之前，它不会获得值。Sphinx导入模块是为了检查它们，但它不会实例化任何类。

因此，“狮身人面像”不知道“实际值”，None而是将其输出。我不认为您可以轻松解决它（但我想，如果您准备打补丁Sphinx源代码，一切皆有可能…）。如果您不喜欢这样做，则可以在类的文档字符串中记录属性。

使用相同的标记方案（在此描述）记录的类属性的值会显示在呈现的输出中。但是没有明确的迹象表明读者可以轻松区分类属性和实例属性。也许Sphinx在这里可能会有所帮助。