如何在__init__中使用sphinx自动模块和公开函数

Question

我有一个看起来像的文件夹结构：

project/
    mymodule/
        __init__.py
        m1.py
        m2.py
        sub1/
            __init__.py
            s1.py
            s2.py

mymod/__init__.py：

"""The __init__ docstr"""
from m1 import *
from m2 import *

mymod/m1.py：

"""m1 doc str"""
def func1():
    """func1 docstr"""
    return 1

mymod/m2.py：

"""m2 doc str"""
def func2():
    """func2 docstr"""
    return 2

mymod/sub1/__init__.py：

"""The sub1 __init__ docstr"""
from s1 import *
from s2 import *

mymod/sub1/s1.py：

"""s1 docstr"""
def sub1():
    """sub1 docstr"""
    return 3

mymod/sub1/s2.py：

"""s2 docstr"""
def sub2():
    """sub2 docstr"""
    return 4

当我直接使用该模块时，它似乎按预期工作：

>>> import mymod
>>> from mymod import sub1
>>> mymod.func1()
1
>>> sub1.subfunc1()
3
>>> mymod.__doc__
'The __init__ docstr'
>>> mymod.func1.__doc__
'func1 docstr'

但是，当我在sphinx中使用自动模块时（将项目文件夹添加到sys.path之后）：

.. automodule:: mymod
    :members:

.. automodule:: mymod.sub1
    :members:

我得到的页面只有：

The __init__ docstr
The sub1 __init__ docstr

似乎正在忽略from m1 import *类型语句。

但是，如果我将所有代码直接复制到__init__每个模块/子模块的文件中，则会得到：

The __init__ docstr

mymod.func1()
func1 docstr

mymod.func2()
func2 docstr

The sub1 __init__ docstr

mymod.sub1.sub1()
sub1 docstr

mymod.sub1.sub2()
sub2 docstr

sphinx是否automodule不适用于__init__文件中具有此类导入语句的模块，还是我遗漏了一个更明显的问题？

理想情况下，当我将所有代码放入 init 时，我希望得到类似的输出（改为使用import语句输入）。

Answer 1

如果将__all__列表添加到__init__.py文件中，它将起作用。例如：

"""The __init__ docstr"""

__all__ = ['func1', 'func2']

from m1 import *
from m2 import *