python - 如何在 Sphinx 文档中将成员注释为抽象？

Question

以下两个属性定义在 Sphinx autodoc HTML 输出中显示完全相同:

@property
def concrete(self):
    """This is the concrete docstring"""
    pass

@abstractproperty
def abstract(self):
    """This is the abstract docstring"""
    pass

Sphinx 有办法用某种标识符来注释抽象方法吗？我希望在我的文档中清楚地表明我的 ABC 的哪些成员需要实现，以及一旦定义了所需的成员，您将获得哪些混合免费赠品。

Answer 1

Sphinx 似乎无法做到这一点。它在 Sphinx's bitbucket 被标记为 Unresolved 问题自 2011 年以来，被标记为 Sphinx future 版本的里程碑。