Python：docstrings和type annotations

Question

有这样的功能：

def foo(x: int) -> float:
    return float(x)

我想使用类似NumPy的文档字符串，如下所示：

def foo(x: int) -> float:
    """
    Parameters
    ----------
    x
        Input parameter

    Returns
    -------
    The output value.
    """
    return float(x)

注意：

• 我不想再次指定参数类型。
• 我不想再次指定返回类型。
• 我希望该扩展能够读取带注释的类型（并在生成的HTML文档中编写它们）。

是否有支持它的Sphinx扩展？ 你会推荐另一种语法吗？

Answer 1

标准扩展名是autodoc 。 Napoleon扩展支持Google和NumPy风格的文档字符串。