[Python-modules-team] Bug#963644: alembic: FTBFS with Sphinx 3.1: AttributeError: 'tuple' object has no attribute 'docname'

[Lucas Nussbaum]

Source: alembic
Version: 1.4.2-1
Severity: important
Tags: ftbfs
User: python-modules-team at lists.alioth.debian.org
Usertags: sphinx3.1

Hi,

alembic fails to build with Sphinx 3.1, currently available in
experimental.

Relevant part (hopefully):
> make[1]: Entering directory '/<<PKGBUILDDIR>>'
> python3 -m sphinx -b html docs/build /<<PKGBUILDDIR>>/debian/alembic/usr/share/doc/alembic/html
> Running Sphinx v3.1.1
> making output directory... done
> building [mo]: targets for 0 po files that are out of date
> building [html]: targets for 20 source files that are out of date
> updating environment: [new config] 20 added, 0 changed, 0 removed
> reading sources... [  5%] api/autogenerate
> reading sources... [ 10%] api/commands
> The name of the builder is: htmlThe name of the builder is: html
> Exception occurred:
>   File "/usr/lib/python3/dist-packages/sphinx/domains/python.py", line 1194, in clear_doc
>     if obj.docname == docname:
> AttributeError: 'tuple' object has no attribute 'docname'
> The full traceback has been saved in /tmp/sphinx-err-kjfkd0mk.log, if you want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error message can be provided next time.
> A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
> make[1]: *** [debian/rules:13: override_dh_sphinxdoc] Error 2

The full build log is available from:
   http://qa-logs.debian.net/2020/06/23/alembic_1.4.2-1_unstable_sphinx-exp.log

Please see [1] for Sphinx changelog, which may give a hint of what changes in
Sphinx caused this error.

Also see [2] for the list of deprecated/removed APIs and possible alternatives
to them.

Sphinx 3.1 is going to be uploaded to unstable in a couple of weeks. When that
happens, the severity of this bug will be bumped to serious.

In case you have questions, please Cc sphinx at packages.debian.org on reply.

[1]: https://www.sphinx-doc.org/en/3.x/changes.html
[2]: https://www.sphinx-doc.org/en/3.x/extdev/deprecated.html

A list of current common problems and possible solutions is available at
http://wiki.debian.org/qa.debian.org/FTBFS . You're welcome to contribute!

About the archive rebuild: The rebuild was done on EC2 VM instances from
Amazon Web Services, using a clean, minimal and up-to-date chroot. Every
failed build was retried once to eliminate random failures.