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

#1042679#5
Date:
2023-07-30 18:29:35 UTC
From:
To:
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):
The full build log is available from:
http://qa-logs.debian.net/2023/07/30/exp/quark-sphinx-theme_0.5.1-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@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

#1042679#14
Date:
2024-03-08 11:03:50 UTC
From:
To:
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 "/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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', '/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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=', '/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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', '/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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', '/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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', 'qthelp', '-N', '/<<PKGBUILDDIR>>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/testdoc-html_rewrite', '/tmp/tmp-sphinx-build-test-g9rskfhy'] 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_theme.TestThemeEntrypoint)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/<<PKGBUILDDIR>>/.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 "/<<PKGBUILDDIR>>/.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', '/<<PKGBUILDDIR>>/.pybuild/cpython3_3.11_quark-sphinx-theme/build/test/testdoc-theme-entrypoint', '/tmp/tmp-sphinx-build-test-huhej5mg'] returned non-zero exit status 2
--- Output:
Running Sphinx v7.2.6

Theme error:
no theme named 'quark' found (missing theme.conf?)
----

Thanks,

#1042679#19
Date:
2024-08-31 15:50:02 UTC
From:
To:
distutils / other test plugins.

If you're trying to figure out how to fix the bug, look at the
implementation of test_suite in setup.py to see what magic it does for
test setup.

Stefano