将函数签名与文档字符串进行比较的工具

Question

是否有工具可以检查文档字符串中列出的参数是否与函数调用的签名匹配？它应该能够处理 numpy 风格的文档字符串。我经常使用 R CMD CHECK，它可以发现 R 中的文档/代码不匹配，这非常有帮助。如果 Python 中有类似的东西那就太好了，但我还没有找到任何东西。

Answer 1

我刚刚创建了一个工具来实现这一目标，称为pydoctest.

它将尝试推断文档字符串中的类型（不仅仅是词法比较）并报告参数数量、参数名称、参数类型、返回类型之间的不匹配，（可选）如果缺少文档字符串等则抛出错误。

它目前支持 google、sphinx 和 numpy 文档字符串格式，但可以很容易地使用其他格式进行扩展。

例子：

def func_type_mismatch(self, a: int) -> int:
    """[summary]

    Args:
        a (float): [description]        <-- float is not int

    Returns:
        int: [description]
    """
    pass

在此函数上运行 pydoctest 会给出以下输出：

Function: <function IncorrectTestClass.func_type_mismatch at 0x7f9a8b52c8c8> FAIL | Argument type differ. Argument 'a' was expected (from signature) to have type '<class 'int'>', but has (in docs) type '<class 'float'>'

编辑（2021 年 6 月）：我已经开始开发一个使用并突出显示错误的 vscode 扩展。 https://marketplace.visualstudio.com/items?itemName=JeppeRask.pydoctest