Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

autosummary ignores __all__ when it is empty #12463

Open
francois-rozet opened this issue Jun 22, 2024 · 1 comment
Open

autosummary ignores __all__ when it is empty #12463

francois-rozet opened this issue Jun 22, 2024 · 1 comment

Comments

@francois-rozet
Copy link

Describe the bug

With __all__ = [] in a module, autosummary takes everything as a member instead of nothing, even with autosummary_ignore_module_all = False. In addition, weird members like __builtins__, __file__ and __package__ are showed as members.

"""Dummy module"""

__all__ = []

def component():
    """Dummy component"""

    pass

image

How to Reproduce

I provide a minimal reproducing example in https://github.com/francois-rozet/sphinx-bug

git clone https://github.com/francois-rozet/sphinx-bug
cd sphinx-bug
pip install -e .
pip install sphinx
sphinx-build . html
open html/api/dummy.html

Environment Information

Platform:              linux; (Linux-6.5.0-0.deb12.4-amd64-x86_64-with-glibc2.38)
Python version:        3.9.18 | packaged by conda-forge | (main, Aug 30 2023, 03:49:32) 
[GCC 12.3.0])
Python implementation: CPython
Sphinx version:        7.3.7
Docutils version:      0.19
Jinja2 version:        3.1.2
Pygments version:      2.17.2

Sphinx extensions

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.autosummary',
]

Additional context

No response

@francois-rozet
Copy link
Author

Note that if dummy/__init__.py is empty

"""Dummy module"""

# __all__ = []

# def component():
#     """Dummy component"""

#     pass

the weird members (__builtins__, __cached__, ...) still appear.

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants