python - 如何在 Sphinx 中的方法内自动添加函数

Question

代码示例：

class A(object):
    def do_something(self):
        """ doc_a """
        def inside_function():
            """ doc_b """
            pass
        pass

我试过：

.. autoclass:: A
    .. autofunction:: A.do_something.inside_function

但它不起作用。

有什么方法可以doc_b为我生成吗？

Answer 1

函数中的函数位于局部变量范围内。函数的局部变量不能从函数外部访问：

>>> def x():
...    def y():
...       pass
... 
>>> x
<function x at 0x7f68560295f0>
>>> x.y
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'function' object has no attribute 'y'

如果 Sphinx 无法获得对该函数的引用，它就无法记录它。

一种可能有效的解决方法是将函数分配给函数的变量，如下所示：

>>> def x():
...    def _y():
...       pass
...    x.y = _y
... 

一开始无法访问：

>>> x.y
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'function' object has no attribute 'y'

但是在第一次调用该函数之后，它将是：

>>> x()
>>> x.y
<function _y at 0x1a720c8>

如果在 Sphinx 导入模块时执行该函数，这可能会起作用。