Bug#1042679: quark-sphinx-theme: FTBFS with Sphinx 7.1, docutils 0.20: AssertionError: no elements

2024-03-08 Thread Colin Watson
On Sun, Jul 30, 2023 at 08:29:35PM +0200, Lucas Nussbaum wrote:
> quark-sphinx-theme fails to build with Sphinx 7.1 and docutils 0.20, both of 
> which
> are currently available in experimental.

A new upstream version 0.6.0 has been sitting in git since 2022, so I
wondered whether it fixed this.  But instead it just has different
errors (see below).

I'm wondering whether we should just remove this package from Debian?
It has no reverse-dependencies, and
https://gitlab.com/fkrull/quark-sphinx-theme shows the project as
unmaintained and suggests that the errors below mean that it isn't
realistically compatible with modern Sphinx any more.

==
ERROR: setUpClass (test.test_html_rewrite.TestHTMLCompatOutput)
--
Traceback (most recent call last):
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 84, in setUpClass
run_sphinx(cls.source_dir, cls.build_dir, cls.builder, cls.config,
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 65, in run_sphinx
raise Exception('%s returned non-zero exit status %s\n'
Exception: ['-b', 'html', '-N', '-t', 'test_html_compat_alias', 
'/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/testdoc-html_rewrite',
 '/tmp/tmp-sphinx-build-test-bo9lbres'] returned non-zero exit status 2
--- Output:
Running Sphinx v7.2.6

Configuration error:
HTML 4 is no longer supported by Sphinx. ("html4_writer=True" detected in 
configuration options)


==
ERROR: setUpClass (test.test_html_rewrite.TestHTMLRewriteFeatures)
--
Traceback (most recent call last):
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 84, in setUpClass
run_sphinx(cls.source_dir, cls.build_dir, cls.builder, cls.config,
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 65, in run_sphinx
raise Exception('%s returned non-zero exit status %s\n'
Exception: ['-b', 'html', '-N', '-D', 'quark_html_features=', 
'/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/testdoc-html_rewrite',
 '/tmp/tmp-sphinx-build-test-kjvqfnoy'] returned non-zero exit status 2
--- Output:
Running Sphinx v7.2.6

Configuration error:
HTML 4 is no longer supported by Sphinx. ("html4_writer=True" detected in 
configuration options)


==
ERROR: setUpClass (test.test_html_rewrite.TestHTMLRewriteOutput)
--
Traceback (most recent call last):
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 84, in setUpClass
run_sphinx(cls.source_dir, cls.build_dir, cls.builder, cls.config,
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 65, in run_sphinx
raise Exception('%s returned non-zero exit status %s\n'
Exception: ['-b', 'html', '-N', 
'/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/testdoc-html_rewrite',
 '/tmp/tmp-sphinx-build-test-pvyjfedf'] returned non-zero exit status 2
--- Output:
Running Sphinx v7.2.6

Configuration error:
HTML 4 is no longer supported by Sphinx. ("html4_writer=True" detected in 
configuration options)


==
ERROR: setUpClass 
(test.test_html_rewrite.TestHTMLRewriteOutputWithBuilderBasedOnQtHelpBuilder)
--
Traceback (most recent call last):
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 84, in setUpClass
run_sphinx(cls.source_dir, cls.build_dir, cls.builder, cls.config,
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 65, in run_sphinx
raise Exception('%s returned non-zero exit status %s\n'
Exception: ['-b', 'custom-qthelp', '-N', 
'/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/testdoc-html_rewrite',
 '/tmp/tmp-sphinx-build-test-6joh0ezy'] returned non-zero exit status 2
--- Output:
Running Sphinx v7.2.6

Configuration error:
HTML 4 is no longer supported by Sphinx. ("html4_writer=True" detected in 
configuration options)


==
ERROR: setUpClass 
(test.test_html_rewrite.TestHTMLRewriteOutputWithQtHelpBuilder)
--
Traceback (most recent call last):
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 84, in setUpClass
run_sphinx(cls.source_dir, cls.build_dir, cls.builder, cls.config,
  File 
"/<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/util.py",
 line 65, in run_sphinx
raise Exception('%s returned 

Bug#1042679: quark-sphinx-theme: FTBFS with Sphinx 7.1, docutils 0.20: AssertionError: no elements

2023-07-30 Thread Lucas Nussbaum
Source: quark-sphinx-theme
Version: 0.5.1-3
Severity: important
Tags: ftbfs
User: python-modules-t...@lists.alioth.debian.org
Usertags: sphinx7.1

Hi,

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

Relevant part (hopefully):
>  debian/rules build
> dh build --with python3 --buildsystem=pybuild
>dh_update_autotools_config -O--buildsystem=pybuild
>dh_autoreconf -O--buildsystem=pybuild
>dh_auto_configure -O--buildsystem=pybuild
> I: pybuild base:240: python3.11 setup.py config 
> running config
>dh_auto_build -O--buildsystem=pybuild
> I: pybuild base:240: /usr/bin/python3 setup.py build 
> running build
> running build_py
> creating 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme
> copying src/quark_sphinx_theme/_mixin.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme
> copying src/quark_sphinx_theme/__init__.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme
> copying src/quark_sphinx_theme/_lovelace.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme
> copying src/quark_sphinx_theme/_sphinxversion.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme
> copying src/quark_sphinx_theme/__version__.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme
> creating 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext
> copying src/quark_sphinx_theme/ext/__init__.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext
> copying src/quark_sphinx_theme/ext/html_compat.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext
> creating 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext/html_rewrite
> copying src/quark_sphinx_theme/ext/html_rewrite/_setup_pre16.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext/html_rewrite
> copying src/quark_sphinx_theme/ext/html_rewrite/literal_blocks.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext/html_rewrite
> copying src/quark_sphinx_theme/ext/html_rewrite/__init__.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext/html_rewrite
> copying src/quark_sphinx_theme/ext/html_rewrite/boxes.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext/html_rewrite
> copying src/quark_sphinx_theme/ext/html_rewrite/_features.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext/html_rewrite
> copying src/quark_sphinx_theme/ext/html_rewrite/compat.py -> 
> /<>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/quark_sphinx_theme/ext/html_rewrite
> running egg_info
> writing src/quark_sphinx_theme.egg-info/PKG-INFO
> writing dependency_links to 
> src/quark_sphinx_theme.egg-info/dependency_links.txt
> writing entry points to src/quark_sphinx_theme.egg-info/entry_points.txt
> writing requirements to src/quark_sphinx_theme.egg-info/requires.txt
> writing top-level names to src/quark_sphinx_theme.egg-info/top_level.txt
> reading manifest file 'src/quark_sphinx_theme.egg-info/SOURCES.txt'
> reading manifest template 'MANIFEST.in'
> adding license file 'LICENSE'
> writing manifest file 'src/quark_sphinx_theme.egg-info/SOURCES.txt'
> /usr/lib/python3/dist-packages/setuptools/command/build_py.py:201: _Warning: 
> Package 'quark_sphinx_theme.quark' is absent from the `packages` 
> configuration.
> !!
> 
> 
> 
> 
> # Package would be ignored #
> 
> Python recognizes 'quark_sphinx_theme.quark' as an importable 
> package[^1],
> but it is absent from setuptools' `packages` configuration.
> 
> This leads to an ambiguous overall configuration. If you want to 
> distribute this
> package, please make sure that 'quark_sphinx_theme.quark' is 
> explicitly added
> to the `packages` configuration field.
> 
> Alternatively, you can also rely on setuptools' discovery methods
> (for example by using `find_namespace_packages(...)`/`find_namespace:`
> instead of `find_packages(...)`/`find:`).
> 
> You can read more about "package discovery" on setuptools 
> documentation page:
> 
> - 
> https://setuptools.pypa.io/en/latest/userguide/package_discovery.html
> 
> If you don't want 'quark_sphinx_theme.quark' to be distributed and are
> already explicitly excluding 'quark_sphinx_theme.quark' via
> `find_namespace_packages(...)/find_namespace` or 
> `find_packages(...)/find`,
> you can try to use `exclude_package_data`, or 
> `include-package-data=False` in
> combination with a more fine grained `package-data` configuration.
>