由sphinx-autodoc生成的特殊签名

Question

我有以下函数定义（本例简化了docstring）：

def ui(*classes, call_init=False):
    'create a metaclass based on *classes*'
    ...

当我使用sphinx-autodoc（特别是自动模块）创建文档时，它会为此函数生成以下签名

ui(call_init, *classes)

任何人都可以解释为什么sphinx-autodoc以错误的方式获取签名？另外，有没有办法让它包含* call_init *的默认值？

Answer 1

根据Wooble对这个问题的评论，这是一个python 2 / python 3的区别。并且已经有一个可用补丁的错误报告：https://bitbucket.org/birkenfeld/sphinx/issue/828/autodoc-python3-keyword-only-arguments。