获取自动摘要以生成平面表示

如何解决获取自动摘要以生成平面表示

如果我有一个文件 foo.baz.py：

from foo.bar.baz import Quux,Quuux

__all__ = ['Quux','Quuux']

我想按如下方式记录 api：

Baz
===

.. currentmodule:: foo.baz

.. autosummary::
   :toctree: generated/
   :nosignatures:

   Quux
   Quuux

这为我提供了一个包含 Quux 和 Quuux 的自动汇总表，以及指向包含其完整文档的页面的链接。但是，它需要我明确列出 Quux 和 Quuux，因此每当我添加一个类时，我都必须手动将其添加到文档中。

相反，我更愿意做这样的事情，让它根据 __all__ 自动生成一个表，以获得与上面完全相同的输出：

Baz
===

.. currentmodule:: foo

.. autosummary::
   :toctree: generated/
   :nosignatures:

   baz

但这不起作用，它会生成一个包含单个条目的表格，即模块 baz，然后指向一个包含其所有内容和汇总表的页面。

有没有办法做到这一点？如果相关，我将使用 numpydoc。