New Sphinx warnings "Summarised items should not include the current module"

[andy-maier]

WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.append' with 'append'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.append' with 'NocaseList.append'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.clear' with 'clear'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.clear' with 'NocaseList.clear'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.copy' with 'copy'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.copy' with 'NocaseList.copy'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.count' with 'count'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.count' with 'NocaseList.count'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.extend' with 'extend'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.extend' with 'NocaseList.extend'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.index' with 'index'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.index' with 'NocaseList.index'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.insert' with 'insert'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.insert' with 'NocaseList.insert'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.pop' with 'pop'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.pop' with 'NocaseList.pop'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.remove' with 'remove'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.remove' with 'NocaseList.remove'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.reverse' with 'reverse'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.reverse' with 'NocaseList.reverse'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.sort' with 'sort'.
WARNING: Summarised items should not include the current module. Replace 'nocaselist.NocaseList.sort' with 'NocaseList.sort'.

[andy-maier]

This was reproducible on Python 3.12 with latest package levels, as of current master branch.

Relevant versions:

autodocsumm                   0.2.14
Sphinx                        8.2.3
sphinx-git                    11.0.0
sphinx-rtd-theme              3.0.2
sphinxcontrib-applehelp       2.0.0
sphinxcontrib-devhelp         2.0.0
sphinxcontrib-fulltoc         1.2.0
sphinxcontrib-htmlhelp        2.1.0
sphinxcontrib-jquery          4.1
sphinxcontrib-jsmath          1.0.1
sphinxcontrib-qthelp          2.0.0
sphinxcontrib-serializinghtml 2.0.0
sphinxcontrib-websupport      2.0.0

Researching the issue using chatGPT:

Sphinx autosummary expects names relative to the current module:

.. automodule:: nocaselist

.. autosummary::
   nocaselist.NocaseList.append        # Absolute, not relative to the current module -> warning

Because append is already inside the current module context (nocaselist), Sphinx considers this a self-reference that can create an import cycle.

Sphinx ≥ 7 tightened autosummary validation.
Sphinx 8.2.3 now emits this as a warning instead of silently fixing it.

In our case, the doc source actually specifies:

   .. autoautosummary:: nocaselist.NocaseList
      :methods:
      :nosignatures:

and the AutoAutoSummary class in conf.py turns this into data structures for use by autosummary.

The solution is to create the method and attribute references in that class with package-relative names.