Weaken the runtime dependency on the first party sphinxcontrib packages
For now, we don't BuildRequire them, to allow orphaning + retirement without reporting sphinx as impacted. Later, we can BuildRequire the remaining ones to produce a more complete documentation.
This commit is contained in:
parent
72bb1987ee
commit
3ae8dffd93
189
11747.patch
Normal file
189
11747.patch
Normal file
@ -0,0 +1,189 @@
|
||||
From a8371a919b4f1552853a879377251ad25c3d988f Mon Sep 17 00:00:00 2001
|
||||
From: =?UTF-8?q?Miro=20Hron=C4=8Dok?= <miro@hroncok.cz>
|
||||
Date: Mon, 6 Nov 2023 13:44:17 +0100
|
||||
Subject: [PATCH] Make the first party extensions optional, add [extensions]
|
||||
extra
|
||||
|
||||
---
|
||||
pyproject.toml | 33 +++++++++++++++++++++++++++------
|
||||
sphinx/application.py | 18 ++++++++++++++----
|
||||
sphinx/testing/fixtures.py | 6 ++++++
|
||||
tests/test_api_translator.py | 2 ++
|
||||
tests/test_build_html.py | 3 +++
|
||||
5 files changed, 52 insertions(+), 10 deletions(-)
|
||||
|
||||
diff --git a/pyproject.toml b/pyproject.toml
|
||||
index a0ada3cd3ae..7cb0112897a 100644
|
||||
--- a/pyproject.toml
|
||||
+++ b/pyproject.toml
|
||||
@@ -55,12 +55,6 @@ classifiers = [
|
||||
"Topic :: Utilities",
|
||||
]
|
||||
dependencies = [
|
||||
- "sphinxcontrib-applehelp",
|
||||
- "sphinxcontrib-devhelp",
|
||||
- "sphinxcontrib-jsmath",
|
||||
- "sphinxcontrib-htmlhelp>=2.0.0",
|
||||
- "sphinxcontrib-serializinghtml>=1.1.9",
|
||||
- "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",
|
||||
+]
|
||||
+devhelp = [
|
||||
+ "sphinxcontrib-devhelp",
|
||||
+]
|
||||
+jsmath = [
|
||||
+ "sphinxcontrib-jsmath",
|
||||
+]
|
||||
+htmlhelp = [
|
||||
+ "sphinxcontrib-htmlhelp>=2.0.0",
|
||||
+]
|
||||
+serializinghtml = [
|
||||
+ "sphinxcontrib-serializinghtml>=1.1.9",
|
||||
+]
|
||||
+qthelp = [
|
||||
+ "sphinxcontrib-qthelp",
|
||||
+]
|
||||
+extensions = [
|
||||
+ "sphinx[applehelp]",
|
||||
+ "sphinx[devhelp]",
|
||||
+ "sphinx[jsmath]",
|
||||
+ "sphinx[htmlhelp]",
|
||||
+ "sphinx[serializinghtml]",
|
||||
+ "sphinx[qthelp]",
|
||||
+]
|
||||
docs = [
|
||||
"sphinxcontrib-websupport",
|
||||
+ "sphinx[extensions]",
|
||||
]
|
||||
lint = [
|
||||
"flake8>=3.5.0",
|
||||
diff --git a/sphinx/application.py b/sphinx/application.py
|
||||
index d5fbaa9f30a..776bafa1ee3 100644
|
||||
--- a/sphinx/application.py
|
||||
+++ b/sphinx/application.py
|
||||
@@ -24,7 +24,12 @@
|
||||
from sphinx import locale, package_dir
|
||||
from sphinx.config import Config
|
||||
from sphinx.environment import BuildEnvironment
|
||||
-from sphinx.errors import ApplicationError, ConfigError, VersionRequirementError
|
||||
+from sphinx.errors import (
|
||||
+ ApplicationError,
|
||||
+ ConfigError,
|
||||
+ ExtensionError,
|
||||
+ VersionRequirementError,
|
||||
+)
|
||||
from sphinx.events import EventManager
|
||||
from sphinx.highlighting import lexer_classes
|
||||
from sphinx.locale import __
|
||||
@@ -226,7 +231,7 @@ def __init__(self, srcdir: str | os.PathLike[str], confdir: str | os.PathLike[st
|
||||
# load all built-in extension modules, first-party extension modules,
|
||||
# and first-party themes
|
||||
for extension in builtin_extensions:
|
||||
- self.setup_extension(extension)
|
||||
+ self.setup_extension(extension, optional=extension in _first_party_extensions)
|
||||
|
||||
# load all user-given extension modules
|
||||
for extension in self.config.extensions:
|
||||
@@ -395,7 +400,7 @@ def build(self, force_all: bool = False, filenames: list[str] | None = None) ->
|
||||
|
||||
# ---- general extensibility interface -------------------------------------
|
||||
|
||||
- def setup_extension(self, extname: str) -> None:
|
||||
+ def setup_extension(self, extname: str, optional: bool = False) -> None:
|
||||
"""Import and setup a Sphinx extension module.
|
||||
|
||||
Load the extension given by the module *name*. Use this if your
|
||||
@@ -403,7 +408,12 @@ def setup_extension(self, extname: str) -> None:
|
||||
called twice.
|
||||
"""
|
||||
logger.debug('[app] setting up extension: %r', extname)
|
||||
- self.registry.load_extension(self, extname)
|
||||
+ try:
|
||||
+ self.registry.load_extension(self, extname)
|
||||
+ except ExtensionError:
|
||||
+ logger.debug('[app] extension not found: %r', extname)
|
||||
+ if not optional:
|
||||
+ raise
|
||||
|
||||
@staticmethod
|
||||
def require_sphinx(version: tuple[int, int] | str) -> None:
|
||||
diff --git a/sphinx/testing/fixtures.py b/sphinx/testing/fixtures.py
|
||||
index 0cc4882fe1c..f57f709b415 100644
|
||||
--- a/sphinx/testing/fixtures.py
|
||||
+++ b/sphinx/testing/fixtures.py
|
||||
@@ -22,6 +22,7 @@
|
||||
'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.',
|
||||
]
|
||||
|
||||
@@ -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:
|
||||
+ pytest.importorskip("sphinxcontrib." + arg)
|
||||
+
|
||||
# ##### process pytest.mark.sphinx
|
||||
|
||||
pargs = {}
|
||||
diff --git a/tests/test_api_translator.py b/tests/test_api_translator.py
|
||||
index 9f2bd448863..81575b71946 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, status, warning):
|
||||
translator_class = app.builder.get_translator_class()
|
||||
@@ -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, status, warning):
|
||||
translator_class = app.builder.get_translator_class()
|
||||
diff --git a/tests/test_build_html.py b/tests/test_build_html.py
|
||||
index a89a6fcafaf..8bd44111853 100644
|
||||
--- a/tests/test_build_html.py
|
||||
+++ b/tests/test_build_html.py
|
||||
@@ -1547,6 +1547,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']})
|
||||
@@ -1567,6 +1568,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'],
|
||||
@@ -1575,6 +1577,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'],
|
@ -25,7 +25,7 @@ Name: python-sphinx
|
||||
#global prerel ...
|
||||
%global upstream_version %{general_version}%{?prerel}
|
||||
Version: %{general_version}%{?prerel:~%{prerel}}
|
||||
Release: 1%{?dist}
|
||||
Release: 2%{?dist}
|
||||
Epoch: 1
|
||||
Summary: Python documentation generator
|
||||
|
||||
@ -40,6 +40,21 @@ Source: %{pypi_source sphinx %{upstream_version}}
|
||||
# which causes that test to fail.
|
||||
Patch: sphinx-test_theming.diff
|
||||
|
||||
# Make the first party extensions optional
|
||||
# This removes the runtime dependencies on:
|
||||
# - sphinxcontrib.applehelp
|
||||
# - sphinxcontrib.devhelp
|
||||
# - sphinxcontrib.jsmath
|
||||
# - sphinxcontrib.htmlhelp
|
||||
# - sphinxcontrib.serializinghtml
|
||||
# - sphinxcontrib.qthelp
|
||||
# The majority of Fedora RPM packages does not need any of those.
|
||||
# By removing the dependencies, we minimize the stuff that's pulled into
|
||||
# the buildroots of 700+ of packages.
|
||||
#
|
||||
# The change is proposed upstream.
|
||||
Patch: https://github.com/sphinx-doc/sphinx/pull/11747.patch
|
||||
|
||||
BuildArch: noarch
|
||||
|
||||
BuildRequires: make
|
||||
@ -132,6 +147,17 @@ Summary: Python documentation generator
|
||||
Recommends: graphviz
|
||||
Recommends: ImageMagick
|
||||
|
||||
# Upstream Requires those, but we have a patch to remove the dependency.
|
||||
# We keep them Recommended to preserve the default user experience.
|
||||
# (We don't desire them in RHEL.)
|
||||
%if %{undefined rhel}
|
||||
Recommends: python%{python3_pkgversion}-sphinxcontrib-applehelp
|
||||
Recommends: python%{python3_pkgversion}-sphinxcontrib-devhelp
|
||||
Recommends: python%{python3_pkgversion}-sphinxcontrib-jsmath
|
||||
Recommends: python%{python3_pkgversion}-sphinxcontrib-htmlhelp
|
||||
Recommends: python%{python3_pkgversion}-sphinxcontrib-serializinghtml
|
||||
Recommends: python%{python3_pkgversion}-sphinxcontrib-qthelp
|
||||
%endif
|
||||
|
||||
%description -n python%{python3_pkgversion}-sphinx
|
||||
Sphinx is a tool that makes it easy to create intelligent and
|
||||
@ -369,6 +395,16 @@ mkdir %{buildroot}%{python3_sitelib}/sphinxcontrib
|
||||
|
||||
|
||||
%changelog
|
||||
* Wed Nov 08 2023 Miro Hrončok <mhroncok@redhat.com> - 1:7.2.6-2
|
||||
- Weaken the runtime dependency on:
|
||||
- python3-sphinxcontrib-applehelp
|
||||
- python3-sphinxcontrib-devhelp
|
||||
- python3-sphinxcontrib-jsmath
|
||||
- python3-sphinxcontrib-htmlhelp
|
||||
- python3-sphinxcontrib-serializinghtml
|
||||
- python3-sphinxcontrib-qthelp
|
||||
- Packages that want to use them during build need to BuildRequire them explicitly
|
||||
|
||||
* Thu Oct 26 2023 Karolina Surma <ksurma@redhat.com> - 1:7.2.6-1
|
||||
- Update to 7.2.6
|
||||
- Fixes rhbz#2232469
|
||||
|
Loading…
Reference in New Issue
Block a user