python - python docstring中的@ivar @param和@type这些标签是什么？

Question

安瓿项目在 docstring 中使用了一些标签，例如 javadoc 的标签。

例如从pool.py第 86 行：

def start(self, ampChild=None):
    """
    Starts the ProcessPool with a given child protocol.

    @param ampChild: a L{ampoule.child.AMPChild} subclass.
    @type ampChild: L{ampoule.child.AMPChild} subclass
    """

这些标签是什么，哪个工具使用它。

Answer 1

只是为了好玩，我会注意到 Python 标准库正在使用 Sphinx/reStructuredText，其信息字段列表是相似的。

def start(self, ampChild=None):
    """Starts the ProcessPool with a given child protocol.

    :param ampChild: a :class:`ampoule.child.AMPChild` subclass.
    :type ampChild: :class:`ampoule.child.AMPChild` subclass
    """

Answer 2

文档工具的标记，可能是epydoc。