COMP: Sphinx dev failure due to automodsummary.get_documenter removal

[bsipocz]

New compatibility issue with sphinx dev version, from upstream PR sphinx-doc/sphinx#13985:

https://github.com/astropy/sphinx-automodapi/actions/runs/18834054740/job/53730962052

Traceback
=========

      File "/home/runner/work/sphinx-automodapi/sphinx-automodapi/.tox/py313-test-sphinxdev/lib/python3.13/site-packages/sphinx/events.py", line 423, in emit
        raise ExtensionError(
        ...<4 lines>...
        ) from exc
    sphinx.errors.ExtensionError: Handler <function process_automodsumm_generation at 0x7f5956315b20> for event 'builder-inited' threw an exception (exception: cannot import name 'get_documenter' from 'sphinx.ext.autosummary' (/home/runner/work/sphinx-automodapi/sphinx-automodapi/.tox/py313-test-sphinxdev/lib/python3.13/site-packages/sphinx/ext/autosummary/__init__.py))


The full traceback has been saved in:
/tmp/sphinx-err-0i0uie02.log

To report this error to the developers, please open an issue at <[https://github.com/sphinx-doc/sphinx/issues/](https://github.com/sphinx-doc/sphinx/issues/?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen)>. Thanks!
Please also report this if it was a user error, so that a better error message can be provided next time.
=========================== short test summary info ============================

Downstream impact:

• BUG: sphinx dev CI failure sphinx-astropy#86

[AA-Turner]

The quickest fix here would be to copy the 'old' implementation of the function into your code.

As a warning, there may be other breakage, though I haven't looked at the interface points between here and upstream at all.

A

[pllim]

Removal? Was it ever deprecated? 😱

[pllim]

After I got past get_documenter, I got this error:

sphinx_automodapi/automodsumm.py", line 222, in get_items
        self.bridge.genopt.imported_members = True
        ^^^^^^^^^^^
    AttributeError: 'Automodsumm' object has no attribute 'bridge'

[bsipocz]

Removal? Was it ever deprecated? 😱

No it wasn't, but to be fair I'm not sure it was considered public API. It was mentioned in an old changelog, but I can't find a "stable" narrative docs to double check (and it's all gone from the current dev docs).

[bsipocz]

@pllim - thanks for jumping into this rabbit hole!

AttributeError: 'Automodsumm' object has no attribute 'bridge'

Yeap, the bridge issue feels to come from this one: sphinx-doc/sphinx#13984

[pllim]

#220 at least make the CI green again but I have no idea if there are any rendered doc weirdness visually or not. I guess we can do a test run downstream when Sphinx dev changes are done... changing.

[bsipocz]

Is there an astropy job that picked up on the infra dev versions, or it doesn't bother with sphinx-dev just pytest?

[pllim]

We need RTD to do devdeps but I don't think there is a way except a draft PR to mess with RTD deps.

[AA-Turner]

Removal? Was it ever deprecated? 😱

See sphinx-doc/sphinx#13985 (comment) -- this is a WIP refactor, the goal is to release a version with compat support. I predict that most users of autodoc shouldn't see an impact, it's only those that import/use names from sphinx.ext.auto{doc,summary} that will need changes.

A

[AA-Turner]

A broader question is what does automodapi do that autodoc / autosummary / apidoc doesn't cover? I'd be happy to upstream the functionality, but I don't use this package so I don't know what changes would be needed in Sphinx.

A

[pllim]

Re: upstream the functionality -- should I re-open this issue?

• Move this package upstream to Sphinx #146