0

如何为c_nested函数自动生成文档?

背景:我为其他开发人员编写代码文档,我想自动生成所有类方法的摘要,包括带有简短描述(文档字符串)的嵌套函数。

当我help(A)在课堂上跑步时,A我得到:

Help on class A in module __main__:

class A(builtins.object)
 |  A(a)
 |  
 |  doc A
 |  
 |  Methods defined here:
 |  
 |  __init__(self, a)
 |      Initialize self.  See 
 |  
 |  b_method(self)
 |      doc b_method

请求的输出:c_nested()带有文档字符串:(文档可以使用脚本打印事件,不需要使用 pydoc 帮助打印。)

Help on class A in module __main__:

class A(builtins.object)
 |  A(a)
 |  
 |  doc A
 |  
 |  Methods defined here:
 |  
 |  __init__(self, a)
 |      Initialize self.  See 
 |  
 |  b_method(self)
 |      doc b_method
 |
 |           c_nested()
 |                doc c_nested

类示例:

class A:
    """ doc A """
    def __init__(self,a):
        self.a = a

    def b_method(self):
        """ doc b_method """

        def c_nested():
            """doc  c_nested """
            pass

        return c_nested()
4

1 回答 1

1

本地函数不公开可见,因此它们的文档字符串不会包含在帮助中。

如果您希望该函数显示在帮助中,请将其设为模块级函数或类的方法。

另请参阅是否需要内部函数 (python) 的文档字符串?

于 2021-01-23T14:23:50.400 回答