以下两个属性定义在 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 的哪些成员需要实现,以及定义所需的成员后您将获得哪些 mixin 免费赠品。
Sphinx 似乎无法做到这一点。它被标记为一个开放的问题斯芬克斯的比特桶 https://bitbucket.org/birkenfeld/sphinx/issue/744/mark-abstract-methods-properties-as-such自 2011 年以来,并被标记为 Sphinx 未来版本的里程碑。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)