Using autodoc2_module_all_regexes to document public API, error for missing __all__

[dherrera1911]

I want to use autodoc2 to document only the public API of my package. As said here, I am using the autodoc2_module_all_regexes configuration as follows:

autodoc2_module_all_regexes = [
    r"my_package\..*",
]

Then, in my package I have a subpackage called datasets with an __init__.py file and a load.py file. The __init__.py file imports functions from load.py, defines some new functions and defines an __all__ variable. However, in load.py I don't use an __all__ variable, since it's not imported by the my_package and thus not public.

In this case, I am getting the error

Extension error (autodoc2.sphinx.extension):                                                                                                            
Handler <function run_autodoc at 0x7fcabf6244c0> for event 'builder-inited' threw an exception (exception: my_package.datasets.load' does not have an __all__)                                                                                                                                                   

I have files like this that will also throw errors. My question is, is there a way to have autodoc2 realize that it shouldn't use datasets/load.py for the documentation? Or some way around having to define all in all the source files in the package?

[dherrera1911]

I noticed that I can use the "exclude_files" option in autodoc2_packages, but this is also somewhat inconvenient.