Bug#1042698: python-vispy: FTBFS with Sphinx 7.1, docutils 0.20: AttributeError: 'container' object has no attribute 'html5tagname'

[Lucas Nussbaum]

Source: python-vispy
Version: 0.6.6-3
Severity: important
Tags: ftbfs
User: python-modules-team at lists.alioth.debian.org
Usertags: sphinx7.1

Hi,

python-vispy fails to build with Sphinx 7.1 and docutils 0.20, both of which
are currently available in experimental.

Relevant part (hopefully):
> make[2]: Entering directory '/<<PKGBUILDDIR>>/doc'
> sphinx-build -b html -d _build/doctrees   . _build/html
> Running Sphinx v7.1.1
> making output directory... done
> WARNING: The pre-Sphinx 1.0 'intersphinx_mapping' format is deprecated and will be removed in Sphinx 8. Update to the current format as described in the documentation. Hint: "intersphinx_mapping = {'<name>': ('https://docs.python.org/3.6', None)}".https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping
> WARNING: The pre-Sphinx 1.0 'intersphinx_mapping' format is deprecated and will be removed in Sphinx 8. Update to the current format as described in the documentation. Hint: "intersphinx_mapping = {'<name>': ('https://docs.scipy.org/doc/numpy', None)}".https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping
> WARNING: The pre-Sphinx 1.0 'intersphinx_mapping' format is deprecated and will be removed in Sphinx 8. Update to the current format as described in the documentation. Hint: "intersphinx_mapping = {'<name>': ('https://docs.scipy.org/doc/scipy/reference', None)}".https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping
> WARNING: The pre-Sphinx 1.0 'intersphinx_mapping' format is deprecated and will be removed in Sphinx 8. Update to the current format as described in the documentation. Hint: "intersphinx_mapping = {'<name>': ('https://vispy.github.io', None)}".https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping
> [autosummary] generating autosummary for: README.rst, app.rst, color.rst, community.rst, documentation.rst, gallery.rst, geometry.rst, gl.rst, gloo.glir.rst, gloo.rst, ..., io.rst, modern-gl.rst, news.rst, plot.rst, raspberry.rst, resources.rst, scene.rst, util.rst, vispy.rst, visuals.rst
> WARNING: Could not load OpenGL library.
> loading intersphinx inventory from https://docs.python.org/3.6/objects.inv...
> loading intersphinx inventory from https://docs.scipy.org/doc/numpy/objects.inv...
> loading intersphinx inventory from https://docs.scipy.org/doc/scipy/reference/objects.inv...
> loading intersphinx inventory from https://vispy.github.io/objects.inv...
> intersphinx inventory has moved: https://vispy.github.io/objects.inv -> https://vispy.org/objects.inv
> intersphinx inventory has moved: https://docs.scipy.org/doc/scipy/reference/objects.inv -> https://docs.scipy.org/doc/scipy/objects.inv
> intersphinx inventory has moved: https://docs.scipy.org/doc/numpy/objects.inv -> https://numpy.org/doc/stable/objects.inv
> building [mo]: targets for 0 po files that are out of date
> writing output... 
> building [html]: targets for 22 source files that are out of date
> updating environment: [new config] 22 added, 0 changed, 0 removed
> reading sources... [  5%] README
> reading sources... [  9%] app
> reading sources... [ 14%] color
> reading sources... [ 18%] community
> reading sources... [ 23%] documentation
> reading sources... [ 27%] gallery
> reading sources... [ 32%] geometry
> reading sources... [ 36%] gl
> reading sources... [ 41%] gloo
> reading sources... [ 45%] gloo.glir
> reading sources... [ 50%] index
> reading sources... [ 55%] installation
> reading sources... [ 59%] io
> reading sources... [ 64%] modern-gl
> reading sources... [ 68%] news
> reading sources... [ 73%] plot
> reading sources... [ 77%] raspberry
> reading sources... [ 82%] resources
> reading sources... [ 86%] scene
> /usr/lib/python3/dist-packages/numpydoc/docscrape.py:460: UserWarning: potentially wrong underline length... 
> Returns 
> ---------- in 
> Create tree diagram of children
> ... in the docstring of describe_tree in /<<PKGBUILDDIR>>/.pybuild/cpython3_3.11_vispy/build/vispy/scene/node.py.
>   warn(msg)
> reading sources... [ 91%] util
> reading sources... [ 95%] vispy
> reading sources... [100%] visuals
> 
> looking for now-outdated files... none found
> pickling environment... done
> checking consistency... /<<PKGBUILDDIR>>/doc/README.rst: WARNING: document isn't included in any toctree
> done
> preparing documents... done
> copying assets... copying static files... done
> copying extra files... done
> done
> writing output... [  5%] README
> writing output... [  9%] app
> writing output... [ 14%] color
> writing output... [ 18%] community
> 
> Exception occurred:
>   File "/usr/lib/python3/dist-packages/docutils/writers/html5_polyglot/__init__.py", line 181, in depart_container
>     self.body.append(f'</{node.html5tagname}>\n')
>                           ^^^^^^^^^^^^^^^^^
> AttributeError: 'container' object has no attribute 'html5tagname'
> The full traceback has been saved in /tmp/sphinx-err-e2o6cr40.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[2]: *** [Makefile:36: html] Error 2


The full build log is available from:
http://qa-logs.debian.net/2023/07/30/exp/python-vispy_0.6.6-3_unstable_sphinx-exp.log

Please see [1] for Sphinx changelog and [2] for Docutils changelog.

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

Some notable changes in Sphinx 6 and Sphinx 7:

- Sphinx no longer includes jquery.js and underscore.js by default.
  Please use python3-sphinxcontrib.jquery package if you are using a custom
  template and it still needs jquery.

- The setup.py build_sphinx command was removed. Please instead call
  sphinx-build or "python3 -m sphinx" directly.

- For packages using the extlinks extension, the caption should contain
  exactly one "%s" placeholder (if caption is not None).

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

[1]: https://www.sphinx-doc.org/en/master/changes.html
[2]: https://repo.or.cz/docutils.git/blob/refs/tags/docutils-0.20.1:/RELEASE-NOTES.txt
[3]: https://www.sphinx-doc.org/en/master/extdev/deprecated.html#dev-deprecated-apis

All bugs filed during this archive rebuild are listed at:
https://bugs.debian.org/cgi-bin/pkgreport.cgi?tag=sphinx7.1;users=python-modules-team@lists.alioth.debian.org
or:
https://udd.debian.org/bugs/?release=na&merged=ign&fnewerval=7&flastmodval=7&fusertag=only&fusertagtag=sphinx7.1&fusertaguser=python-modules-team@lists.alioth.debian.org&allbugs=1&cseverity=1&ctags=1&caffected=1#results

If you reassign this bug to another package, please marking it as 'affects'-ing
this package. See https://www.debian.org/Bugs/server-control#affects