diff --git a/.fmf/version b/.fmf/version deleted file mode 100644 index d00491f..0000000 --- a/.fmf/version +++ /dev/null @@ -1 +0,0 @@ -1 diff --git a/.gitignore b/.gitignore index bf51472..fd204f3 100644 --- a/.gitignore +++ b/.gitignore @@ -46,6 +46,3 @@ /Sphinx-7.0.1.tar.gz /sphinx-7.1.2.tar.gz /sphinx-7.2.6.tar.gz -/sphinx-7.3.7.tar.gz -/sphinx-8.1.3.tar.gz -/sphinx-8.2.3.tar.gz diff --git a/11774.patch b/11774.patch new file mode 100644 index 0000000..47370b2 --- /dev/null +++ b/11774.patch @@ -0,0 +1,69 @@ +From bc8939b34037f81b8610f3b26caec128ee20a2f4 Mon Sep 17 00:00:00 2001 +From: Karolina Surma +Date: Tue, 28 Nov 2023 14:43:58 +0100 +Subject: [PATCH] Adjust the expected string to match Python 3.11+ changed + output + +--- + tests/test_ext_autodoc_configs.py | 21 +++++++++++++++++---- + 1 file changed, 17 insertions(+), 4 deletions(-) + +diff --git a/tests/test_ext_autodoc_configs.py b/tests/test_ext_autodoc_configs.py +index 45bc729b73e..0994c08e899 100644 +--- a/tests/test_ext_autodoc_configs.py ++++ b/tests/test_ext_autodoc_configs.py +@@ -11,6 +11,7 @@ + from .test_ext_autodoc import do_autodoc + + IS_PYPY = platform.python_implementation() == 'PyPy' ++IS_PY311_AND_LATER = sys.version_info >= (3, 11) + + + @contextmanager +@@ -1627,7 +1628,10 @@ def test_autodoc_default_options(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' in actual +- assert ' list of weak references to the object (if defined)' in actual ++ if IS_PY311_AND_LATER: ++ assert ' list of weak references to the object' in actual ++ else: ++ assert ' list of weak references to the object (if defined)' in actual + + # :exclude-members: None - has no effect. Unlike :members:, + # :special-members:, etc. where None == "include all", here None means +@@ -1651,7 +1655,10 @@ def test_autodoc_default_options(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' in actual +- assert ' list of weak references to the object (if defined)' in actual ++ if IS_PY311_AND_LATER: ++ assert ' list of weak references to the object' in actual ++ else: ++ assert ' list of weak references to the object (if defined)' in actual + assert ' .. py:method:: CustomIter.snafucate()' in actual + assert ' Makes this snafucated.' in actual + +@@ -1698,7 +1705,10 @@ def test_autodoc_default_options_with_values(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' not in actual +- assert ' list of weak references to the object (if defined)' not in actual ++ if IS_PY311_AND_LATER: ++ assert ' list of weak references to the object' not in actual ++ else: ++ assert ' list of weak references to the object (if defined)' not in actual + + # with :exclude-members: + app.config.autodoc_default_options = { +@@ -1722,6 +1732,9 @@ def test_autodoc_default_options_with_values(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' not in actual +- assert ' list of weak references to the object (if defined)' not in actual ++ if IS_PY311_AND_LATER: ++ assert ' list of weak references to the object' not in actual ++ else: ++ assert ' list of weak references to the object (if defined)' not in actual + assert ' .. py:method:: CustomIter.snafucate()' not in actual + assert ' Makes this snafucated.' not in actual diff --git a/13527.patch b/13527.patch deleted file mode 100644 index f253845..0000000 --- a/13527.patch +++ /dev/null @@ -1,314 +0,0 @@ -From 93312460e37be0ba1acbbefa553bfc25f4fc5ea9 Mon Sep 17 00:00:00 2001 -From: Adam Turner <9087854+aa-turner@users.noreply.github.com> -Date: Sun, 27 Apr 2025 21:00:40 +0100 -Subject: [PATCH 1/9] Fix tests for Python 3.14a7+ - ---- - tests/test_extensions/test_ext_autodoc.py | 2 +- - tests/test_extensions/test_ext_autodoc_configs.py | 1 - - 2 files changed, 1 insertion(+), 2 deletions(-) - -diff --git a/tests/test_extensions/test_ext_autodoc.py b/tests/test_extensions/test_ext_autodoc.py -index a06c1bbe30d..bdcd6ef2b95 100644 ---- a/tests/test_extensions/test_ext_autodoc.py -+++ b/tests/test_extensions/test_ext_autodoc.py -@@ -941,7 +941,7 @@ def test_autodoc_special_members(app): - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ - '.. py:class:: Class(arg)', -- ' .. py:attribute:: Class.__annotations__', -+ ' .. py:attribute:: Class.__annotations_cache__', - ' .. py:attribute:: Class.__dict__', - ' .. py:method:: Class.__init__(arg)', - ' .. py:attribute:: Class.__module__', -diff --git a/tests/test_extensions/test_ext_autodoc_configs.py b/tests/test_extensions/test_ext_autodoc_configs.py -index ab7539190e0..d520e7f9cfe 100644 ---- a/tests/test_extensions/test_ext_autodoc_configs.py -+++ b/tests/test_extensions/test_ext_autodoc_configs.py -@@ -1368,7 +1368,6 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -- ' :type: int', - '', - ' docstring', - '', - -From 523f290134f644b115e18e347dce093fa0fbd662 Mon Sep 17 00:00:00 2001 -From: Adam Turner <9087854+aa-turner@users.noreply.github.com> -Date: Sun, 27 Apr 2025 21:03:35 +0100 -Subject: [PATCH 2/9] Fix tests for Python 3.14a7+ - ---- - tests/test_extensions/test_ext_autodoc_configs.py | 2 +- - 1 file changed, 1 insertion(+), 1 deletion(-) - -diff --git a/tests/test_extensions/test_ext_autodoc_configs.py b/tests/test_extensions/test_ext_autodoc_configs.py -index d520e7f9cfe..2f8dc75d082 100644 ---- a/tests/test_extensions/test_ext_autodoc_configs.py -+++ b/tests/test_extensions/test_ext_autodoc_configs.py -@@ -1368,6 +1368,7 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -+ ' :type: int', - '', - ' docstring', - '', -@@ -1440,7 +1441,6 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -- ' :type: myint', - '', - ' docstring', - '', - -From a81bcf834822fac1cf96a2ab43c5b0d260ec532b Mon Sep 17 00:00:00 2001 -From: James Addison -Date: Tue, 6 May 2025 22:06:24 +0100 -Subject: [PATCH 3/9] Tests: make test expectations pyversion-conditional - -Relates-to commits 93312460e37be0ba1acbbefa553bfc25f4fc5ea9, 523f290134f644b115e18e347dce093fa0fbd662. ---- - tests/test_extensions/test_ext_autodoc.py | 6 +++++- - tests/test_extensions/test_ext_autodoc_configs.py | 10 +++++++++- - 2 files changed, 14 insertions(+), 2 deletions(-) - -diff --git a/tests/test_extensions/test_ext_autodoc.py b/tests/test_extensions/test_ext_autodoc.py -index bdcd6ef2b95..d7cef59056e 100644 ---- a/tests/test_extensions/test_ext_autodoc.py -+++ b/tests/test_extensions/test_ext_autodoc.py -@@ -938,10 +938,14 @@ def test_autodoc_special_members(app): - } - if sys.version_info >= (3, 13, 0, 'alpha', 5): - options['exclude-members'] = '__static_attributes__,__firstlineno__' -+ if sys.version_info >= (3, 14, 0, 'alpha', 7): -+ annotations_attributes = [' .. py:attribute:: Class.__annotations_cache__'] -+ else: -+ annotations_attributes = [' .. py:attribute:: Class.__annotations__'] - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ - '.. py:class:: Class(arg)', -- ' .. py:attribute:: Class.__annotations_cache__', -+ ] + annotations_attributes + [ - ' .. py:attribute:: Class.__dict__', - ' .. py:method:: Class.__init__(arg)', - ' .. py:attribute:: Class.__module__', -diff --git a/tests/test_extensions/test_ext_autodoc_configs.py b/tests/test_extensions/test_ext_autodoc_configs.py -index 2f8dc75d082..f449bb57809 100644 ---- a/tests/test_extensions/test_ext_autodoc_configs.py -+++ b/tests/test_extensions/test_ext_autodoc_configs.py -@@ -1348,6 +1348,10 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - # default - options = {'members': None} - actual = do_autodoc(app, 'module', 'target.autodoc_type_aliases', options) -+ if sys.version_info >= (3, 14, 0, 'alpha', 7): -+ attr2_typeinfo = [] -+ else: -+ attr2_typeinfo = [' :type: int'] - assert list(actual) == [ - '', - '.. py:module:: target.autodoc_type_aliases', -@@ -1368,7 +1372,6 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -- ' :type: int', - '', - ' docstring', - '', -@@ -1421,6 +1424,10 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - 'io.StringIO': 'my.module.StringIO', - } - actual = do_autodoc(app, 'module', 'target.autodoc_type_aliases', options) -+ if sys.version_info >= (3, 14, 0, 'alpha', 7): -+ attr2_typeinfo = [] -+ else: -+ attr2_typeinfo = [' :type: myint'] - assert list(actual) == [ - '', - '.. py:module:: target.autodoc_type_aliases', -@@ -1441,6 +1448,7 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -+ ] + attr2_typeinfo + [ - '', - ' docstring', - '', - -From 26e7a6435ad9840345455f35f62c063cb588bba7 Mon Sep 17 00:00:00 2001 -From: James Addison -Date: Tue, 6 May 2025 22:16:42 +0100 -Subject: [PATCH 4/9] Tests: fixup: actually insert updated expectation - -Relates-to commit a81bcf834822fac1cf96a2ab43c5b0d260ec532b. ---- - tests/test_extensions/test_ext_autodoc_configs.py | 1 + - 1 file changed, 1 insertion(+) - -diff --git a/tests/test_extensions/test_ext_autodoc_configs.py b/tests/test_extensions/test_ext_autodoc_configs.py -index f449bb57809..fe2561aea00 100644 ---- a/tests/test_extensions/test_ext_autodoc_configs.py -+++ b/tests/test_extensions/test_ext_autodoc_configs.py -@@ -1372,6 +1372,7 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -+ ] + attr2_typeinfo + [ - '', - ' docstring', - '', - -From 52c7010c4b673898af115d3a86728274a8dd620d Mon Sep 17 00:00:00 2001 -From: James Addison -Date: Tue, 6 May 2025 22:19:30 +0100 -Subject: [PATCH 5/9] Tests: linting: use iterable unpacking as suggested by - `ruff` - ---- - tests/test_extensions/test_ext_autodoc_configs.py | 4 ++-- - 1 file changed, 2 insertions(+), 2 deletions(-) - -diff --git a/tests/test_extensions/test_ext_autodoc_configs.py b/tests/test_extensions/test_ext_autodoc_configs.py -index fe2561aea00..39fdc454e31 100644 ---- a/tests/test_extensions/test_ext_autodoc_configs.py -+++ b/tests/test_extensions/test_ext_autodoc_configs.py -@@ -1372,7 +1372,7 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -- ] + attr2_typeinfo + [ -+ *attr2_typeinfo, - '', - ' docstring', - '', -@@ -1449,7 +1449,7 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', -- ] + attr2_typeinfo + [ -+ *attr2_typeinfo, - '', - ' docstring', - '', - -From 7b3ce9b642e636fe2ec58f1e090dc79d51b1f2f0 Mon Sep 17 00:00:00 2001 -From: James Addison -Date: Tue, 6 May 2025 22:21:24 +0100 -Subject: [PATCH 6/9] Tests: linting: use iterable unpacking as suggested by - `ruff` (uno mas) - ---- - tests/test_extensions/test_ext_autodoc.py | 2 +- - 1 file changed, 1 insertion(+), 1 deletion(-) - -diff --git a/tests/test_extensions/test_ext_autodoc.py b/tests/test_extensions/test_ext_autodoc.py -index d7cef59056e..4f38634cf51 100644 ---- a/tests/test_extensions/test_ext_autodoc.py -+++ b/tests/test_extensions/test_ext_autodoc.py -@@ -945,7 +945,7 @@ def test_autodoc_special_members(app): - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ - '.. py:class:: Class(arg)', -- ] + annotations_attributes + [ -+ *annotations_attributes, - ' .. py:attribute:: Class.__dict__', - ' .. py:method:: Class.__init__(arg)', - ' .. py:attribute:: Class.__module__', - -From 386ba32af878b23c5857be588f932fe2af4a2d88 Mon Sep 17 00:00:00 2001 -From: Adam Turner <9087854+AA-Turner@users.noreply.github.com> -Date: Mon, 12 May 2025 17:36:04 +0100 -Subject: [PATCH 7/9] Style - ---- - tests/test_extensions/test_ext_autodoc.py | 4 ++-- - 1 file changed, 2 insertions(+), 2 deletions(-) - -diff --git a/tests/test_extensions/test_ext_autodoc.py b/tests/test_extensions/test_ext_autodoc.py -index 4f38634cf51..012e708a2f3 100644 ---- a/tests/test_extensions/test_ext_autodoc.py -+++ b/tests/test_extensions/test_ext_autodoc.py -@@ -939,9 +939,9 @@ def test_autodoc_special_members(app): - if sys.version_info >= (3, 13, 0, 'alpha', 5): - options['exclude-members'] = '__static_attributes__,__firstlineno__' - if sys.version_info >= (3, 14, 0, 'alpha', 7): -- annotations_attributes = [' .. py:attribute:: Class.__annotations_cache__'] -+ annotations_attributes = (' .. py:attribute:: Class.__annotations_cache__',) - else: -- annotations_attributes = [' .. py:attribute:: Class.__annotations__'] -+ annotations_attributes = (' .. py:attribute:: Class.__annotations__',) - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ - '.. py:class:: Class(arg)', - -From 1f381ec05015fcbc695d1f0991e77241daef49c7 Mon Sep 17 00:00:00 2001 -From: Adam Turner <9087854+aa-turner@users.noreply.github.com> -Date: Mon, 12 May 2025 17:38:28 +0100 -Subject: [PATCH 8/9] fstr - ---- - tests/test_extensions/test_ext_autodoc.py | 6 +++--- - 1 file changed, 3 insertions(+), 3 deletions(-) - -diff --git a/tests/test_extensions/test_ext_autodoc.py b/tests/test_extensions/test_ext_autodoc.py -index 012e708a2f3..7aa12db3c32 100644 ---- a/tests/test_extensions/test_ext_autodoc.py -+++ b/tests/test_extensions/test_ext_autodoc.py -@@ -939,13 +939,13 @@ def test_autodoc_special_members(app): - if sys.version_info >= (3, 13, 0, 'alpha', 5): - options['exclude-members'] = '__static_attributes__,__firstlineno__' - if sys.version_info >= (3, 14, 0, 'alpha', 7): -- annotations_attributes = (' .. py:attribute:: Class.__annotations_cache__',) -+ ann_attr_name = '__annotations_cache__' - else: -- annotations_attributes = (' .. py:attribute:: Class.__annotations__',) -+ ann_attr_name = '__annotations__' - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ - '.. py:class:: Class(arg)', -- *annotations_attributes, -+ f' .. py:attribute:: Class.{ann_attr_name}', - ' .. py:attribute:: Class.__dict__', - ' .. py:method:: Class.__init__(arg)', - ' .. py:attribute:: Class.__module__', - -From 0bd1f9d1615c20078677b48a09180c4b68e27796 Mon Sep 17 00:00:00 2001 -From: Adam Turner <9087854+aa-turner@users.noreply.github.com> -Date: Mon, 12 May 2025 17:40:13 +0100 -Subject: [PATCH 9/9] tuple - ---- - tests/test_extensions/test_ext_autodoc_configs.py | 8 ++++---- - 1 file changed, 4 insertions(+), 4 deletions(-) - -diff --git a/tests/test_extensions/test_ext_autodoc_configs.py b/tests/test_extensions/test_ext_autodoc_configs.py -index 39fdc454e31..c88496ee506 100644 ---- a/tests/test_extensions/test_ext_autodoc_configs.py -+++ b/tests/test_extensions/test_ext_autodoc_configs.py -@@ -1349,9 +1349,9 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - options = {'members': None} - actual = do_autodoc(app, 'module', 'target.autodoc_type_aliases', options) - if sys.version_info >= (3, 14, 0, 'alpha', 7): -- attr2_typeinfo = [] -+ attr2_typeinfo = () - else: -- attr2_typeinfo = [' :type: int'] -+ attr2_typeinfo = (' :type: int',) - assert list(actual) == [ - '', - '.. py:module:: target.autodoc_type_aliases', -@@ -1426,9 +1426,9 @@ def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - } - actual = do_autodoc(app, 'module', 'target.autodoc_type_aliases', options) - if sys.version_info >= (3, 14, 0, 'alpha', 7): -- attr2_typeinfo = [] -+ attr2_typeinfo = () - else: -- attr2_typeinfo = [' :type: myint'] -+ attr2_typeinfo = (' :type: myint',) - assert list(actual) == [ - '', - '.. py:module:: target.autodoc_type_aliases', diff --git a/13610.patch b/13610.patch deleted file mode 100644 index 7cebb25..0000000 --- a/13610.patch +++ /dev/null @@ -1,49 +0,0 @@ -From 69998bdf8848614eb52ddd80923ffde7af64c0a8 Mon Sep 17 00:00:00 2001 -From: James Addison -Date: Mon, 2 Jun 2025 21:55:15 +0100 -Subject: [PATCH] tests: update LaTeX label test expectations from docutils - r10151 - ---- - tests/test_builders/test_build_latex.py | 11 +++++++++-- - 1 file changed, 9 insertions(+), 2 deletions(-) - -diff --git a/tests/test_builders/test_build_latex.py b/tests/test_builders/test_build_latex.py -index 0d1c607462d..37e708a021e 100644 ---- a/tests/test_builders/test_build_latex.py -+++ b/tests/test_builders/test_build_latex.py -@@ -12,6 +12,7 @@ - from subprocess import CalledProcessError - from typing import TYPE_CHECKING - -+import docutils - import pygments - import pytest - -@@ -1959,10 +1960,16 @@ def test_latex_labels(app: SphinxTestApp) -> None: - - result = (app.outdir / 'projectnamenotset.tex').read_text(encoding='utf8') - -+ # ref: docutils r10151 -+ if docutils.__version_info__[:2] < (0, 22): -+ figure_id, table_id = 'id1', 'id2' -+ else: -+ figure_id, table_id = 'id2', 'id3' -+ - # figures - assert ( - r'\caption{labeled figure}' -- r'\label{\detokenize{index:id1}}' -+ r'\label{\detokenize{index:' + figure_id + '}}' - r'\label{\detokenize{index:figure2}}' - r'\label{\detokenize{index:figure1}}' - r'\end{figure}' -@@ -1988,7 +1995,7 @@ def test_latex_labels(app: SphinxTestApp) -> None: - # tables - assert ( - r'\sphinxcaption{table caption}' -- r'\label{\detokenize{index:id2}}' -+ r'\label{\detokenize{index:' + table_id + '}}' - r'\label{\detokenize{index:table2}}' - r'\label{\detokenize{index:table1}}' - ) in result diff --git a/13883.patch b/13883.patch deleted file mode 100644 index 480de01..0000000 --- a/13883.patch +++ /dev/null @@ -1,30 +0,0 @@ -From 4d842a2c4909fe360172826a46eb88b442f44858 Mon Sep 17 00:00:00 2001 -From: =?UTF-8?q?G=C3=BCnter=20Milde?= -Date: Tue, 9 Sep 2025 16:17:15 +0200 -Subject: [PATCH] Fix test setup for directive tests. - -Set the "parent" attribute of RSTState instances to the `document` -instead of None. The attribute holds the state machines "current node" -which is initialized to the `document` in `RSTStateMachine.run()` and -required since Docutils 0.22.1 in `RSTState.nested_parse()` to correctly -support sections in nested parsing. ---- - tests/test_util/test_util_docutils_sphinx_directive.py | 2 +- - 1 file changed, 1 insertion(+), 1 deletion(-) - -diff --git a/tests/test_util/test_util_docutils_sphinx_directive.py b/tests/test_util/test_util_docutils_sphinx_directive.py -index ecfcab0..7a26e96 100644 ---- a/tests/test_util/test_util_docutils_sphinx_directive.py -+++ b/tests/test_util/test_util_docutils_sphinx_directive.py -@@ -38,7 +38,7 @@ def make_directive_and_state( - inliner = Inliner() - inliner.init_customizations(state.document.settings) - state.inliner = inliner -- state.parent = None -+ state.parent = state.document - state.memo = SimpleNamespace( - document=state.document, - language=english, --- -2.51.1 - diff --git a/8962398b761c3d85a.patch b/8962398b761c3d85a.patch deleted file mode 100644 index 3b49f67..0000000 --- a/8962398b761c3d85a.patch +++ /dev/null @@ -1,29 +0,0 @@ -From 8962398b761c3d85a7c74b6f789b3ffb127bde0c Mon Sep 17 00:00:00 2001 -From: Adam Turner <9087854+AA-Turner@users.noreply.github.com> -Date: Thu, 6 Mar 2025 16:03:44 +0000 -Subject: [PATCH] autosummary: Update test for Python 3.14.0a5+ (#13418) - -`types.UnionType` and `typing.Union` have been merged. ---- - tests/test_extensions/test_ext_autosummary.py | 8 ++++++-- - 1 file changed, 6 insertions(+), 2 deletions(-) - -diff --git a/tests/test_extensions/test_ext_autosummary.py b/tests/test_extensions/test_ext_autosummary.py -index 35dc7d180ef..c807ddba3d1 100644 ---- a/tests/test_extensions/test_ext_autosummary.py -+++ b/tests/test_extensions/test_ext_autosummary.py -@@ -447,8 +447,12 @@ def test_autosummary_generate_content_for_module_imported_members(app): - ] - assert context['functions'] == ['bar'] - assert context['all_functions'] == ['_quux', 'bar'] -- assert context['classes'] == ['Class', 'Foo'] -- assert context['all_classes'] == ['Class', 'Foo', '_Baz'] -+ if sys.version_info >= (3, 14, 0, 'alpha', 5): -+ assert context['classes'] == ['Class', 'Foo', 'Union'] -+ assert context['all_classes'] == ['Class', 'Foo', 'Union', '_Baz'] -+ else: -+ assert context['classes'] == ['Class', 'Foo'] -+ assert context['all_classes'] == ['Class', 'Foo', '_Baz'] - assert context['exceptions'] == ['Exc'] - assert context['all_exceptions'] == ['Exc', '_Exc'] - assert context['attributes'] == ['CONSTANT1', 'qux', 'quuz', 'non_imported_member'] diff --git a/Make-the-first-party-extensions-optional.patch b/Make-the-first-party-extensions-optional.patch index d7b039e..ad3985a 100644 --- a/Make-the-first-party-extensions-optional.patch +++ b/Make-the-first-party-extensions-optional.patch @@ -1,57 +1,58 @@ -From f3fba803e1c39232f86acc9a21657cad171ce71b Mon Sep 17 00:00:00 2001 +From 9699465414515f0eba76d05069e755b5bcf34eef Mon Sep 17 00:00:00 2001 From: Karolina Surma -Date: Wed, 5 Mar 2025 12:14:49 +0100 +Date: Mon, 15 Jan 2024 16:19:32 +0100 Subject: [PATCH] Make the first party extensions optional, add [extensions] extra + Co-authored-by: Miro Hrončok --- - pyproject.toml | 33 ++++++++++++++++---- - sphinx/application.py | 6 ++-- - sphinx/registry.py | 10 +++--- - sphinx/testing/fixtures.py | 7 +++++ - tests/test_builders/test_build_html_maths.py | 3 ++ - tests/test_writers/test_api_translator.py | 2 ++ - 6 files changed, 48 insertions(+), 13 deletions(-) + pyproject.toml | 33 +++++++++++++++++++++++++++------ + sphinx/application.py | 6 +++--- + sphinx/registry.py | 9 ++++++--- + sphinx/testing/fixtures.py | 6 ++++++ + tests/test_api_translator.py | 2 ++ + tests/test_build_html.py | 3 +++ + 6 files changed, 47 insertions(+), 12 deletions(-) diff --git a/pyproject.toml b/pyproject.toml -index c4b1b6d..4e59e90 100644 +index 8f93701..41c28c5 100644 --- a/pyproject.toml +++ b/pyproject.toml -@@ -67,12 +67,6 @@ classifiers = [ - "Typing :: Typed", +@@ -55,12 +55,6 @@ classifiers = [ + "Topic :: Utilities", ] dependencies = [ -- "sphinxcontrib-applehelp>=1.0.7", -- "sphinxcontrib-devhelp>=1.0.6", -- "sphinxcontrib-htmlhelp>=2.0.6", -- "sphinxcontrib-jsmath>=1.0.1", -- "sphinxcontrib-qthelp>=1.0.6", +- "sphinxcontrib-applehelp", +- "sphinxcontrib-devhelp", +- "sphinxcontrib-jsmath", +- "sphinxcontrib-htmlhelp>=2.0.0", - "sphinxcontrib-serializinghtml>=1.1.9", - "Jinja2>=3.1", - "Pygments>=2.17", - "docutils>=0.20,<0.22", -@@ -88,8 +82,35 @@ dependencies = [ +- "sphinxcontrib-qthelp", + "Jinja2>=3.0", + "Pygments>=2.14", + "docutils>=0.18.1,<0.21", +@@ -76,8 +70,35 @@ dependencies = [ dynamic = ["version"] [project.optional-dependencies] +applehelp = [ -+ "sphinxcontrib-applehelp>=1.0.7", ++ "sphinxcontrib-applehelp", +] +devhelp = [ -+ "sphinxcontrib-devhelp>=1.0.6", ++ "sphinxcontrib-devhelp", +] +jsmath = [ -+ "sphinxcontrib-jsmath>=1.0.1", ++ "sphinxcontrib-jsmath", +] +htmlhelp = [ -+ "sphinxcontrib-htmlhelp>=2.0.6", ++ "sphinxcontrib-htmlhelp>=2.0.0", +] +serializinghtml = [ + "sphinxcontrib-serializinghtml>=1.1.9", +] +qthelp = [ -+ "sphinxcontrib-qthelp>=1.0.6", ++ "sphinxcontrib-qthelp", +] +extensions = [ + "sphinx[applehelp]", @@ -66,12 +67,12 @@ index c4b1b6d..4e59e90 100644 + "sphinx[extensions]", ] lint = [ - "ruff==0.9.9", + "flake8>=3.5.0", diff --git a/sphinx/application.py b/sphinx/application.py -index fe0e8bd..dcb3d75 100644 +index d5fbaa9..b030dab 100644 --- a/sphinx/application.py +++ b/sphinx/application.py -@@ -284,7 +284,7 @@ class Sphinx: +@@ -226,7 +226,7 @@ class Sphinx: # load all built-in extension modules, first-party extension modules, # and first-party themes for extension in builtin_extensions: @@ -80,7 +81,7 @@ index fe0e8bd..dcb3d75 100644 # load all user-given extension modules for extension in self.config.extensions: -@@ -478,7 +478,7 @@ class Sphinx: +@@ -395,7 +395,7 @@ class Sphinx: # ---- general extensibility interface ------------------------------------- @@ -89,7 +90,7 @@ index fe0e8bd..dcb3d75 100644 """Import and setup a Sphinx extension module. Load the extension given by the module *name*. Use this if your -@@ -486,7 +486,7 @@ class Sphinx: +@@ -403,7 +403,7 @@ class Sphinx: called twice. """ logger.debug('[app] setting up extension: %r', extname) @@ -99,19 +100,19 @@ index fe0e8bd..dcb3d75 100644 @staticmethod def require_sphinx(version: tuple[int, int] | str) -> None: diff --git a/sphinx/registry.py b/sphinx/registry.py -index ce52a03..3bc90d5 100644 +index 501661d..96d4554 100644 --- a/sphinx/registry.py +++ b/sphinx/registry.py -@@ -519,7 +519,7 @@ class SphinxComponentRegistry: - def add_html_theme(self, name: str, theme_path: str | os.PathLike[str]) -> None: - self.html_themes[name] = _StrPath(theme_path) +@@ -430,7 +430,7 @@ class SphinxComponentRegistry: + def add_html_theme(self, name: str, theme_path: str) -> None: + self.html_themes[name] = theme_path - def load_extension(self, app: Sphinx, extname: str) -> None: + def load_extension(self, app: Sphinx, extname: str, skip_nonimportable: bool = False) -> None: """Load a Sphinx extension.""" if extname in app.extensions: # already loaded return -@@ -540,10 +540,12 @@ class SphinxComponentRegistry: +@@ -446,9 +446,12 @@ class SphinxComponentRegistry: try: mod = import_module(extname) except ImportError as err: @@ -120,30 +121,28 @@ index ce52a03..3bc90d5 100644 + logger.debug(msg % extname) + return logger.verbose(__('Original exception:\n') + traceback.format_exc()) -- raise ExtensionError( -- __('Could not import extension %s') % extname, err -- ) from err +- raise ExtensionError(__('Could not import extension %s') % extname, +- err) from err + raise ExtensionError(msg % extname, err) from err - setup: _ExtensionSetupFunc | None = getattr(mod, 'setup', None) + setup = getattr(mod, 'setup', None) if setup is None: diff --git a/sphinx/testing/fixtures.py b/sphinx/testing/fixtures.py -index ec143fa..e6d9da1 100644 +index 0cc4882..f57f709 100644 --- a/sphinx/testing/fixtures.py +++ b/sphinx/testing/fixtures.py -@@ -31,6 +31,7 @@ DEFAULT_ENABLED_MARKERS = [ - 'builddir=None, docutils_conf=None' - '): arguments to initialize the sphinx test application.' +@@ -22,6 +22,7 @@ DEFAULT_ENABLED_MARKERS = [ + 'sphinx(builder, testroot=None, freshenv=False, confoverrides=None, tags=None,' + ' docutilsconf=None, parallel=0): arguments to initialize the sphinx test application.' ), + 'sphinxcontrib(...): required sphinxcontrib.* extensions', 'test_params(shared_result=...): test parameters.', ] -@@ -79,6 +80,12 @@ def app_params( - """Parameters that are specified by 'pytest.mark.sphinx' for +@@ -67,6 +68,11 @@ def app_params(request: Any, test_params: dict, shared_result: SharedResult, sphinx.application.Sphinx initialization """ -+ + + # ##### process pytest.mark.sphinxcontrib + for info in reversed(list(request.node.iter_markers("sphinxcontrib"))): + for arg in info.args: @@ -151,55 +150,55 @@ index ec143fa..e6d9da1 100644 + # ##### process pytest.mark.sphinx - pargs: dict[int, Any] = {} -diff --git a/tests/test_builders/test_build_html_maths.py b/tests/test_builders/test_build_html_maths.py -index cc21142..16382e3 100644 ---- a/tests/test_builders/test_build_html_maths.py -+++ b/tests/test_builders/test_build_html_maths.py -@@ -37,6 +37,7 @@ def test_html_math_renderer_is_imgmath(app: SphinxTestApp) -> None: - assert app.builder.math_renderer_name == 'imgmath' - - -+@pytest.mark.sphinxcontrib('serializinghtml', 'jsmath') - @pytest.mark.sphinx( - 'html', - testroot='basic', -@@ -62,6 +63,7 @@ def test_html_math_renderer_is_duplicated2(app: SphinxTestApp) -> None: - assert app.builder.math_renderer_name == 'imgmath' # The another one is chosen - - -+@pytest.mark.sphinxcontrib('jsmath') - @pytest.mark.sphinx( - 'html', - testroot='basic', -@@ -75,6 +77,7 @@ def test_html_math_renderer_is_chosen(app: SphinxTestApp) -> None: - assert app.builder.math_renderer_name == 'imgmath' - - -+@pytest.mark.sphinxcontrib('jsmath') - @pytest.mark.sphinx( - 'html', - testroot='basic', -diff --git a/tests/test_writers/test_api_translator.py b/tests/test_writers/test_api_translator.py -index 1220192..8e8bb33 100644 ---- a/tests/test_writers/test_api_translator.py -+++ b/tests/test_writers/test_api_translator.py -@@ -47,6 +47,7 @@ def test_singlehtml_set_translator_for_singlehtml(app: SphinxTestApp) -> None: + pargs = {} +diff --git a/tests/test_api_translator.py b/tests/test_api_translator.py +index 9f2bd44..81575b7 100644 +--- a/tests/test_api_translator.py ++++ b/tests/test_api_translator.py +@@ -36,6 +36,7 @@ def test_singlehtml_set_translator_for_singlehtml(app, status, warning): assert translator_class.__name__ == 'ConfSingleHTMLTranslator' +@pytest.mark.sphinxcontrib('serializinghtml') @pytest.mark.sphinx('pickle', testroot='api-set-translator') - def test_pickle_set_translator_for_pickle(app: SphinxTestApp) -> None: + def test_pickle_set_translator_for_pickle(app, status, warning): translator_class = app.builder.get_translator_class() -@@ -54,6 +55,7 @@ def test_pickle_set_translator_for_pickle(app: SphinxTestApp) -> None: +@@ -43,6 +44,7 @@ def test_pickle_set_translator_for_pickle(app, status, warning): assert translator_class.__name__ == 'ConfPickleTranslator' +@pytest.mark.sphinxcontrib('serializinghtml') @pytest.mark.sphinx('json', testroot='api-set-translator') - def test_json_set_translator_for_json(app: SphinxTestApp) -> None: + def test_json_set_translator_for_json(app, status, warning): translator_class = app.builder.get_translator_class() +diff --git a/tests/test_build_html.py b/tests/test_build_html.py +index 07f101d..c512a33 100644 +--- a/tests/test_build_html.py ++++ b/tests/test_build_html.py +@@ -1544,6 +1544,7 @@ def test_html_math_renderer_is_imgmath(app, status, warning): + assert app.builder.math_renderer_name == 'imgmath' + + ++@pytest.mark.sphinxcontrib('serializinghtml', 'jsmath') + @pytest.mark.sphinx('html', testroot='basic', + confoverrides={'extensions': ['sphinxcontrib.jsmath', + 'sphinx.ext.imgmath']}) +@@ -1564,6 +1565,7 @@ def test_html_math_renderer_is_duplicated2(app, status, warning): + assert app.builder.math_renderer_name == 'imgmath' # The another one is chosen + + ++@pytest.mark.sphinxcontrib('jsmath') + @pytest.mark.sphinx('html', testroot='basic', + confoverrides={'extensions': ['sphinxcontrib.jsmath', + 'sphinx.ext.imgmath'], +@@ -1572,6 +1574,7 @@ def test_html_math_renderer_is_chosen(app, status, warning): + assert app.builder.math_renderer_name == 'imgmath' + + ++@pytest.mark.sphinxcontrib('jsmath') + @pytest.mark.sphinx('html', testroot='basic', + confoverrides={'extensions': ['sphinxcontrib.jsmath', + 'sphinx.ext.mathjax'], -- -2.48.1 +2.43.0 diff --git a/e01e42f5fc738815b.patch b/e01e42f5fc738815b.patch deleted file mode 100644 index a42c216..0000000 --- a/e01e42f5fc738815b.patch +++ /dev/null @@ -1,40 +0,0 @@ -From e01e42f5fc738815b8499c4ede30c6caf130f0a4 Mon Sep 17 00:00:00 2001 -From: Adam Turner <9087854+aa-turner@users.noreply.github.com> -Date: Wed, 19 Mar 2025 20:11:35 +0000 -Subject: [PATCH] Fix ``INVALID_BUILTIN_CLASSES`` test for Python 3.14.0a6+ - ---- - tests/test_util/test_util_typing.py | 6 +++--- - 1 file changed, 3 insertions(+), 3 deletions(-) - -diff --git a/tests/test_util/test_util_typing.py b/tests/test_util/test_util_typing.py -index 35ee240f7b8..8a561c378ed 100644 ---- a/tests/test_util/test_util_typing.py -+++ b/tests/test_util/test_util_typing.py -@@ -205,7 +205,7 @@ def test_is_invalid_builtin_class() -> None: - zipfile.Path, - zipfile.CompleteDirs, - ) -- if sys.version_info[:2] >= (3, 13): -+ if sys.version_info[:2] == (3, 13): - invalid_types += ( - # pathlib - Path, -@@ -217,7 +217,7 @@ def test_is_invalid_builtin_class() -> None: - ) - - invalid_names = {(cls.__module__, cls.__qualname__) for cls in invalid_types} -- if sys.version_info[:2] < (3, 13): -+ if sys.version_info[:2] != (3, 13): - invalid_names |= { - ('pathlib._local', 'Path'), - ('pathlib._local', 'PosixPath'), -@@ -231,7 +231,7 @@ def test_is_invalid_builtin_class() -> None: - ('zipfile._path', 'Path'), - ('zipfile._path', 'CompleteDirs'), - } -- assert _INVALID_BUILTIN_CLASSES.keys() == invalid_names -+ assert set(_INVALID_BUILTIN_CLASSES) == invalid_names - - - def test_restify_type_hints_containers(): diff --git a/plan.fmf b/plan.fmf deleted file mode 100644 index 94cb32d..0000000 --- a/plan.fmf +++ /dev/null @@ -1,5 +0,0 @@ -discover: - how: fmf -execute: - how: tmt - diff --git a/python-sphinx.spec b/python-sphinx.spec index ed77d83..fd0c7e6 100644 --- a/python-sphinx.spec +++ b/python-sphinx.spec @@ -2,8 +2,6 @@ # Without the packages, we have warnings in docs, but it's not a hard dependency # We don't want to support sphinxcontrib-* in RHEL, hence disabling the dependencies %bcond sphinxcontrib %{undefined rhel} -# RHEL does not include python3-snowballstemmer (SRPM: snowball) -%bcond snowballstemmer %{undefined rhel} # Also, we don't have all the tests requirements %bcond tests 1 @@ -16,13 +14,14 @@ # Build without BuildRequires ImageMagick, to skip imgconverter tests %bcond imagemagick_tests %{undefined rhel} +# Same for filelock -- we don't want it in RHEL just to run a handful of tests here +%bcond filelock_tests %{undefined rhel} # During texlive updates, sometimes the latex environment is unstable -# NOTE: LaTeX tests are never run when building for ELN. %bcond latex_tests 1 Name: python-sphinx -%global general_version 8.2.3 +%global general_version 7.2.6 #global prerel ... %global upstream_version %{general_version}%{?prerel} Version: %{general_version}%{?prerel:~%{prerel}} @@ -39,7 +38,7 @@ Source: %{pypi_source sphinx %{upstream_version}} # Allow extra themes to exist. We pull in python3-sphinx-theme-alabaster # which causes that test to fail. -Patch: sphinx-test_theming.patch +Patch: sphinx-test_theming.diff # Make the first party extensions optional # This removes the runtime dependencies on: @@ -57,13 +56,9 @@ Patch: sphinx-test_theming.patch # https://github.com/sphinx-doc/sphinx/pull/11747 Patch: Make-the-first-party-extensions-optional.patch -# Compatibility with Python 3.14 -Patch: https://github.com/sphinx-doc/sphinx/commit/8962398b761c3d85a.patch -Patch: https://github.com/sphinx-doc/sphinx/commit/e01e42f5fc738815b.patch -Patch: https://github.com/sphinx-doc/sphinx/pull/13527.patch -# Compatibility with docutils 0.22+ -Patch: https://github.com/sphinx-doc/sphinx/pull/13610.patch -Patch: https://github.com/sphinx-doc/sphinx/pull/13883.patch +# Fix the expected test docstring to match output in Python 3.11.7, 3.12.1 and later +# Proposed upstream. +Patch: https://github.com/sphinx-doc/sphinx/pull/11774.patch BuildArch: noarch @@ -93,68 +88,36 @@ BuildRequires: texinfo BuildRequires: ImageMagick %endif -%if %{undefined rhel} && %{with latex_tests} +%if %{with latex_tests} BuildRequires: texlive-collection-fontsrecommended BuildRequires: texlive-collection-latex -BuildRequires: texlive-gnu-freefont -BuildRequires: latexmk BuildRequires: texlive-dvipng BuildRequires: texlive-dvisvgm -BuildRequires: tex(article.cls) -BuildRequires: tex(utf8x.def) -# Other dependencies. -BuildRequires: tex(alltt.sty) -BuildRequires: tex(amsfonts.sty) BuildRequires: tex(amsmath.sty) -BuildRequires: tex(amssymb.sty) -BuildRequires: tex(amstext.sty) BuildRequires: tex(amsthm.sty) BuildRequires: tex(anyfontsize.sty) -BuildRequires: tex(atbegshi.sty) -BuildRequires: tex(babel.sty) -BuildRequires: tex(bm.sty) -BuildRequires: tex(booktabs.sty) +BuildRequires: tex(article.cls) BuildRequires: tex(capt-of.sty) BuildRequires: tex(cmap.sty) -BuildRequires: tex(colortbl.sty) -BuildRequires: tex(ellipse.sty) -BuildRequires: tex(etoolbox.sty) +BuildRequires: tex(color.sty) +BuildRequires: tex(ctablestack.sty) BuildRequires: tex(fancyhdr.sty) BuildRequires: tex(fancyvrb.sty) -BuildRequires: tex(float.sty) BuildRequires: tex(fncychap.sty) -BuildRequires: tex(fontawesome.sty) -BuildRequires: tex(fontawesome5.sty) -BuildRequires: tex(fontenc.sty) -BuildRequires: tex(fontspec.sty) BuildRequires: tex(framed.sty) +BuildRequires: tex(FreeSerif.otf) BuildRequires: tex(geometry.sty) -BuildRequires: tex(graphicx.sty) -BuildRequires: tex(hypcap.sty) BuildRequires: tex(hyperref.sty) -BuildRequires: tex(inputenc.sty) BuildRequires: tex(kvoptions.sty) -BuildRequires: tex(longtable.sty) -BuildRequires: tex(ltxcmds.sty) BuildRequires: tex(luatex85.sty) -BuildRequires: tex(makeidx.sty) -BuildRequires: tex(multicol.sty) BuildRequires: tex(needspace.sty) BuildRequires: tex(parskip.sty) -BuildRequires: tex(pict2e.sty) BuildRequires: tex(polyglossia.sty) -BuildRequires: tex(remreset.sty) -BuildRequires: tex(substitutefont.sty) BuildRequires: tex(tabulary.sty) -BuildRequires: tex(textalpha.sty) -BuildRequires: tex(textcomp.sty) -BuildRequires: tex(tgheros.sty) -BuildRequires: tex(tgtermes.sty) BuildRequires: tex(titlesec.sty) BuildRequires: tex(upquote.sty) -BuildRequires: tex(varwidth.sty) +BuildRequires: tex(utf8x.def) BuildRequires: tex(wrapfig.sty) -BuildRequires: tex(xcolor.sty) %endif %endif @@ -193,7 +156,6 @@ Summary: Python documentation generator Recommends: graphviz Recommends: ImageMagick -Recommends: make # Upstream Requires those, but we have a patch to remove the dependency. # We keep them Recommended to preserve the default user experience. @@ -234,93 +196,39 @@ the Python docs: snippets and inclusion of appropriately formatted docstrings. -%if %{undefined rhel} %package -n python%{python3_pkgversion}-sphinx-latex Summary: LaTeX builder dependencies for python%{python3_pkgversion}-sphinx Requires: python%{python3_pkgversion}-sphinx = %{epoch}:%{version}-%{release} -# Required dependencies as stated in the documentation [1]: -# -# - texlive-collection-latexrecommended -# - texlive-collection-fontsrecommended -# - texlive-collection-fontsextra -# - texlive-collection-latexextra -# - texlive-tex-gyre -# - latexmk -# -# [1] https://www.sphinx-doc.org/en/master/usage/builders/index.html#sphinx.builders.latex.LaTeXBuilder -# -# These packages install 2500+ other packages requiring ~3 GiB of space. -# Therefore, a more precise list of dependencies. - Requires: texlive-collection-fontsrecommended Requires: texlive-collection-latex -Requires: texlive-gnu-freefont -Requires: latexmk - -# Required by sphinx.ext.imgmath – Render math as images Requires: texlive-dvipng Requires: texlive-dvisvgm -#Requires: tex(preview.sty) Pulls in texlive-collection-latexrecommended - -Requires: tex(article.cls) -Requires: tex(utf8x.def) - -# Other dependencies. -# -- After searching for \RequirePackage{..} and \usepackage{..}. -Requires: tex(alltt.sty) -Requires: tex(amsfonts.sty) Requires: tex(amsmath.sty) -Requires: tex(amssymb.sty) -Requires: tex(amstext.sty) Requires: tex(amsthm.sty) Requires: tex(anyfontsize.sty) -Requires: tex(atbegshi.sty) -Requires: tex(babel.sty) -Requires: tex(bm.sty) -Requires: tex(booktabs.sty) +Requires: tex(article.cls) Requires: tex(capt-of.sty) Requires: tex(cmap.sty) -Requires: tex(colortbl.sty) -Requires: tex(ellipse.sty) -Requires: tex(etoolbox.sty) +Requires: tex(color.sty) +Requires: tex(ctablestack.sty) Requires: tex(fancyhdr.sty) Requires: tex(fancyvrb.sty) -Requires: tex(float.sty) Requires: tex(fncychap.sty) -Requires: tex(fontawesome.sty) -Requires: tex(fontawesome5.sty) -Requires: tex(fontenc.sty) -Requires: tex(fontspec.sty) Requires: tex(framed.sty) +Requires: tex(FreeSerif.otf) Requires: tex(geometry.sty) -Requires: tex(graphicx.sty) -Requires: tex(hypcap.sty) Requires: tex(hyperref.sty) -Requires: tex(inputenc.sty) Requires: tex(kvoptions.sty) -Requires: tex(longtable.sty) -Requires: tex(ltxcmds.sty) Requires: tex(luatex85.sty) -Requires: tex(makeidx.sty) -Requires: tex(multicol.sty) Requires: tex(needspace.sty) Requires: tex(parskip.sty) -Requires: tex(pict2e.sty) Requires: tex(polyglossia.sty) -Requires: tex(remreset.sty) -Requires: tex(substitutefont.sty) Requires: tex(tabulary.sty) -Requires: tex(textalpha.sty) -Requires: tex(textcomp.sty) -Requires: tex(tgheros.sty) -Requires: tex(tgtermes.sty) Requires: tex(titlesec.sty) Requires: tex(upquote.sty) -Requires: tex(varwidth.sty) +Requires: tex(utf8x.def) Requires: tex(wrapfig.sty) -Requires: tex(xcolor.sty) -#Requires: tex(xeCJK.sty) Pulls in pLaTeX and upLaTeX # No files in this package, automatic provides don't work: %py_provides python%{python3_pkgversion}-sphinx-latex @@ -335,7 +243,6 @@ useful to many other projects. This package pulls in the TeX dependencies needed by Sphinx's LaTeX builder. -%endif %package doc @@ -357,41 +264,27 @@ This package contains documentation in the HTML format. %prep %autosetup -n sphinx-%{upstream_version} -p1 -# Drop test-dependency on pytest-xdist -# This allows for parallel testing, but has a lot of dependencies. -# We want to avoid the dependency in RHEL, where it is not available. -%if 0%{?rhel} -sed -i -e '/pytest-xdist/d' pyproject.toml -%endif - -# Support for docutils 0.22+ -sed -i -e 's/docutils>=0.20,<0.22/docutils>=0.20,<0.23/' pyproject.toml - -# Drop test-dependency on defusedxml, -# use xml from the standard library instead. -# defusedxml is safer but this is only used in tests. -# Upstream uses defusedxml to be "safer for future contributors when they -# create/open branches and pull requests" -- that does not concern us. -# https://github.com/sphinx-doc/sphinx/pull/12168#discussion_r1535383868 -# We want to avoid the dependency in RHEL, but no harm in doing so unconditionally. -sed -i '/"defusedxml/d' pyproject.toml -sed -i 's/from defusedxml./from xml.etree./' sphinx/testing/util.py tests/test_theming/test_theming.py - -%if %{without snowballstemmer} -# Drop dependency on snowballstemmer for RHEL, implement dummy method instead -sed -i -e '/snowballstemmer/d' pyproject.toml -sed -i -e 's/^import \(snowballstemmer\)/from . import dummystemmer as \1/' sphinx/search/*.py -cat > sphinx/search/dummystemmer.py <<_EOF -class stemmer: - def __init__(self, *args, **kwargs): pass - def stemWord(self, word): return word -_EOF -%endif - %if %{without imagemagick_tests} -rm tests/test_extensions/test_ext_imgconverter.py +rm tests/test_ext_imgconverter.py %endif +%if %{without filelock_tests} +sed -i '/filelock/d' pyproject.toml +rm tests/test_build_linkcheck.py tests/test_ext_intersphinx.py +%endif + +%if %{defined rhel} +# unwanted dependency in RHEL, https://bugzilla.redhat.com/show_bug.cgi?id=1945182 +sed -i '/html5lib/d' pyproject.toml +%endif + +# Sphinx' tests import from each other, this feature is not supported by +# the 'importlib' import mode in pytest. Upstream mitigates this by invoking +# `python -m pytest` rather than `pytest` directly, but in the context of the +# RPM build we explicitly want to test the installed library rather than the +# one from PWD. +# https://github.com/sphinx-doc/sphinx/issues/11740 +sed -i '/"--import-mode=importlib",/d' pyproject.toml %generate_buildrequires %pyproject_buildrequires -r %{?with_tests:-x test} @@ -471,28 +364,25 @@ mkdir %{buildroot}%{python3_sitelib}/sphinxcontrib # Currently, all linkcheck tests and test_latex_images need internet # test_build_latex_doc needs internet to download pictures, # but fails also with it enabled, we decided to skip it entirely -# test_autodoc_type_aliases fails with Python 3.12.4, 3.13.0b3 -# skip temporarily until resolved: -# https://github.com/sphinx-doc/sphinx/issues/12430 -k="not test_autodoc_type_aliases" +# In RHEL builds, skip tests which use html5lib (excluded above) +%pytest \ +%if %{defined rhel} + --ignore tests/test_build_html.py \ + --ignore tests/test_build_latex.py \ + --ignore tests/test_build_texinfo.py \ + --ignore tests/test_domain_std.py \ + --ignore tests/test_smartquotes.py \ +%endif %if %{without internet} -k="${k} and not linkcheck and not test_latex_images and not test_build_latex_doc" + -k "not linkcheck and not test_latex_images and not test_build_latex_doc" \ +%endif +; %endif -%if %{without snowballstemmer} -# Without snowballstemmer, some tests have to be skipped as well, -# as the results with dummystemmer do not exactly match the testcases -k="${k} and not test_meta_keys_are_handled_for_language_en and not test_stemmer" -k="${k} and not test_term_in_heading_and_section and not test_IndexBuilder" -k="${k} and not test_check_js_search_indexes" -%endif - -%pytest -k "${k}" -%endif %files -n python%{python3_pkgversion}-sphinx -f sphinx.lang -%license LICENSE.rst -%doc README.rst +%license LICENSE +%doc AUTHORS CHANGES EXAMPLES README.rst %{_bindir}/sphinx-* %{python3_sitelib}/sphinx/ %dir %{python3_sitelib}/sphinxcontrib/ @@ -502,13 +392,13 @@ k="${k} and not test_check_js_search_indexes" %dir %{_datadir}/sphinx/locale/* %{_mandir}/man1/sphinx-* -%if %{undefined rhel} + %files -n python%{python3_pkgversion}-sphinx-latex # empty, this is a metapackage -%endif + %files doc -%license LICENSE.rst +%license LICENSE %doc html diff --git a/sources b/sources index df7d90d..aaab39a 100644 --- a/sources +++ b/sources @@ -1 +1 @@ -SHA512 (sphinx-8.2.3.tar.gz) = e7cbe251e4f44eb59ef6fd84d3918b1b29941943b75265da75aa9533379746e76331ac8a3ba8c1694840adeebd6886e0fc8eebf5407271aaeddf39594d8e1523 +SHA512 (sphinx-7.2.6.tar.gz) = 9a42e38c3c54429cc008b58892297ade4ccdd67561ee671e42a1fae976955895bb5383d58cb66a4f9f7edd1cc50dc2d1f083efeef036eac9fffc205979d3ccbc diff --git a/sphinx-test_theming.diff b/sphinx-test_theming.diff new file mode 100644 index 0000000..30994a1 --- /dev/null +++ b/sphinx-test_theming.diff @@ -0,0 +1,12 @@ +diff -ru Sphinx-1.7.6/tests/test_theming.py Sphinx-1.7.6_patched/tests/test_theming.py +--- Sphinx-1.7.6/tests/test_theming.py 2018-07-16 11:24:40.000000000 +0200 ++++ Sphinx-1.7.6_patched/tests/test_theming.py 2018-07-20 15:17:35.049263077 +0200 +@@ -25,7 +25,7 @@ + themes.append('alabaster') + + # test Theme class API +- assert set(app.registry.html_themes.keys()) == set(themes) ++ assert set(app.registry.html_themes.keys()) >= set(themes) + assert app.registry.html_themes['test-theme'] == str(app.srcdir / 'test_theme' / 'test-theme') + assert app.registry.html_themes['ziptheme'] == str(app.srcdir / 'ziptheme.zip') + assert app.registry.html_themes['staticfiles'] == str(app.srcdir / 'test_theme' / 'staticfiles') diff --git a/sphinx-test_theming.patch b/sphinx-test_theming.patch deleted file mode 100644 index 818a74e..0000000 --- a/sphinx-test_theming.patch +++ /dev/null @@ -1,25 +0,0 @@ -From 399ae81dfbedb7b8acf84e56b0e4b2d5023432ec Mon Sep 17 00:00:00 2001 -From: Karolina Surma -Date: Wed, 26 Feb 2025 10:43:44 +0100 -Subject: [PATCH] Patch test_theming to accomodate for Fedora-added theme - ---- - tests/test_theming/test_theming.py | 2 +- - 1 file changed, 1 insertion(+), 1 deletion(-) - -diff --git a/tests/test_theming/test_theming.py b/tests/test_theming/test_theming.py -index 173e0c9..515e546 100644 ---- a/tests/test_theming/test_theming.py -+++ b/tests/test_theming/test_theming.py -@@ -58,7 +58,7 @@ def test_theme_api(app: SphinxTestApp) -> None: - ] - - # test Theme class API -- assert set(app.registry.html_themes.keys()) == set(themes) -+ assert set(app.registry.html_themes.keys()) >= set(themes) - assert app.registry.html_themes['test-theme'] == ( - app.srcdir / 'test_theme' / 'test-theme' - ) --- -2.48.1 - diff --git a/tests/include-sphinxcontrib-jquery/main.fmf b/tests/include-sphinxcontrib-jquery/main.fmf deleted file mode 100644 index e447827..0000000 --- a/tests/include-sphinxcontrib-jquery/main.fmf +++ /dev/null @@ -1,11 +0,0 @@ -summary: run the basic documentation build -test: | - sphinx-build -M html source/ build/ && - grep '