Question

我想指定Pydoc记录我的功能的顺序。我不确定Pydoc如何命令生成的文档中的函数 - 它肯定不是模块中的文本顺序。

这很有用，因为我希望首先指定我的printUsage()函数。

"""
Sample module docstring
"""

def printUsage():
    """
    Command line usage: python my_module.py -i path/to/input_file.c
    If calling my_function() directly, pass the path/to/input_file.c as an arg.
    """
    print(printUsage.__doc__)

...

因此，当用户签出my_module的文档字符串时，他可以快速查看如何使用它。

Answer 1

查看sourcecode：

看起来模块文档存储为dict，因此当它们遍历它们时，它会创建随机顺序：

def namelink(self, name, *dicts):
    """Make a link for an identifier, given name-to-URL mappings."""
    for dict in dicts:
        if name in dict:
            return '<a href="%s">%s</a>' % (dict[name], name)

如何让Pydoc按特定顺序记录我的功能？

1 个答案: