如何为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()