如何使 Python/Sphinx 文档对象属性仅在 __init__ 中声明？

我有带有对象属性的 Python 类，这些属性仅在运行构造函数时声明，如下所示：

class Foo(object):
    def __init__(self, base):
        self.basepath = base

        temp = []
        for run in os.listdir(self.basepath):
            if self.foo(run):
                temp.append(run)
        self.availableruns = tuple(sorted(temp))

如果我现在使用help(Foo)或尝试记录Foo在狮身人面像中，self.basepath and self.availableruns属性未显示。这对于我们 API 的用户来说是一个问题。

我尝试寻找一种标准方法来确保解析器可以找到这些“动态声明”属性（最好是文档字符串），但到目前为止还没有运气。有什么建议么？谢谢。

我尝试寻找一种标准方法来确保解析器可以找到这些“动态声明”属性（最好是文档字符串），但到目前为止还没有运气。有什么建议么？

它们永远不会被任何解析器“检测到”。

Python 有setattr。从任何意义上来说，完整的属性集永远不会“可检测到”。

您绝对必须在文档字符串中描述它们。

[除非你想做一堆元编程来从你收集的东西生成文档字符串inspect或者其他的东西。即使如此，一旦您开始使用，您的“解决方案”将是不完整的setattr.]

class Foo(object):
    """
    :ivar basepath:
    :ivar availableruns:
    """
    def __init__(self, base):