狮身人面像自动文档和类型注解

Question

目前，我有一些使用mypy类型注释的代码，如下所示：

def translate(self, text, mark_unknown=False, format=None, deformat='txt', reformat='txt'):
    # type: (Translator, str, bool, Optional[str], str, str) -> str

我想用Sphinx的autodoc扩展来记录它，但看起来autodoc目前还不识别这些注释，所以这些注释不会出现在生成的文档中。

是否有任何简单的修复，例如，另一个扩展或自动文档选项，或者我必须用相关信息编写一个实际的docstring？

Answer 1

project似乎正是为这个用例开发的。