python - Sphinxのドキュメントでメンバーに抽象として注釈を付ける方法は?

Question

次の 2 つのプロパティ定義は、Sphinx autodocHTML 出力でまったく同じように表示されます。

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

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

Sphinx には、ある種の識別子で抽象メソッドに注釈を付ける方法がありますか? 私のドキュメントで、私の ABC のどのメンバーを実装する必要があるか、および必要なメンバーが定義された後に取得できる mixin 景品がどれかを明確にしたいと思います。

Answer 1

スフィンクスにそれができるようには見えません。2011 年以来、 Sphinx の bitbucketで未解決の問題としてマークされており、 Sphinx の将来のバージョンのマイルストーンとしてフラグが立てられています。