python 3中的类型提示可以用来生成文档字符串吗？

Question

我们可以在python中使用docstring来表示函数参数的类型：

def f1(a):
    """
    :param a: an input.
    :type a: int
    :return: the input integer.
    :rtype: int
    """
    return a

对于f1，autodoc 生成以下文档：

fun1(a)
    Parameters : a (int) – an input.
    Returns    : the input integer.
    Return type: int

在python 3中，类型也可以通过类型提示来指示：

def f2(a: int):
    """
    :param a: an input.
    :return: the input integer.
    :rtype: int
    """
    return a

当我们运行 autodoc 时，它通过参数声明来放置类型，而不是在描述中：

f2(a: int)
    Parameters : a – an input.
    Returns    : the input integer.
    Return type: int

是否可以使用注释而不是文档字符串将文档生成为f1？我正在使用python 3.6。谢谢！

Answer 1

还没有，据我所知，Sphinx 还不支持此功能。评论中引用的错误是关于类型提示的表示而不是它们的定位。

我知道目前有一个 Sphinx 扩展程序可以为您解决这个问题，名为 sphinx-autodoc-typehints。您可能暂时可以使用它。