summaryrefslogtreecommitdiffstats
path: root/python/python-sphinx_selective_exclude.spec
diff options
context:
space:
mode:
Diffstat (limited to 'python/python-sphinx_selective_exclude.spec')
-rw-r--r--python/python-sphinx_selective_exclude.spec70
1 files changed, 70 insertions, 0 deletions
diff --git a/python/python-sphinx_selective_exclude.spec b/python/python-sphinx_selective_exclude.spec
new file mode 100644
index 0000000..9a26570
--- /dev/null
+++ b/python/python-sphinx_selective_exclude.spec
@@ -0,0 +1,70 @@
+%global srcname sphinx_selective_exclude
+
+# Upstream does not have any tests yet
+%bcond_with tests
+
+Name: python-%{srcname}
+Version: 1.0.3
+Release: 1%{?dist}
+Summary: Sphinx eager ".. only::" directive and other selective rendition extensions
+
+License: BSD
+Url: https://github.com/pfalcon/sphinx_selective_exclude
+Source0: %{pypi_source}
+
+BuildArch: noarch
+
+%global _description %{expand:
+The implementation of ".. only::" directive in Sphinx documentation generation
+tool is known to violate principles of least user surprise and user expectations
+in general. Instead of excluding content early in the pipeline (preprocessor
+style), Sphinx defers exclusion until output phase, and what's the worst,
+various stages processing ignore "only" blocks and their exclusion status, so
+they may leak unexpected information into ToC, indexes, etc.
+
+This projects tries to rectify situation on users' side. It actually changes the
+way Sphinx processes "only" directive, but does this without forking the
+project, and instead is made as a standard Sphinx extension, which a user may
+add to their documentation config. Unlike normal extensions, extensions provided
+in this package monkey-patch Sphinx core to work in a way expected by users.}
+
+%description %_description
+
+
+%package -n python3-%{srcname}
+Summary: %{summary}
+BuildRequires: python3-devel
+BuildRequires: python3-setuptools
+BuildRequires: python3-sphinx
+Requires: python3-sphinx
+
+%description -n python3-%{srcname} %_description
+
+
+%prep
+%autosetup -n %{srcname}-%{version}
+
+
+%build
+%py3_build
+
+
+%install
+%py3_install
+
+
+%if %{with tests}
+%check
+%endif
+
+
+%files -n python3-%{srcname}
+%license LICENSE
+%doc README.md
+%{python3_sitelib}/%{srcname}-*.egg-info/
+%{python3_sitelib}/%{srcname}/
+
+
+%changelog
+* Fri Nov 20 2020 Michel Alexandre Salim <salimma@fedoraproject.org> - 1.0.3-1
+- Initial package