You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gentoo-overlay/dev-python/sphinx/sphinx-7.1.2.ebuild

133 lines
4.4 KiB

# Copyright 1999-2023 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2
EAPI=8
DISTUTILS_USE_PEP517=flit
PYTHON_COMPAT=( python3_{10..12} pypy3 )
PYTHON_REQ_USE="threads(+)"
inherit distutils-r1
DESCRIPTION="Python documentation generator"
HOMEPAGE="
https://www.sphinx-doc.org/
https://github.com/sphinx-doc/sphinx/
https://pypi.org/project/Sphinx/
"
SRC_URI="
https://github.com/sphinx-doc/sphinx/archive/v${PV}.tar.gz
-> ${P}.gh.tar.gz
"
LICENSE="BSD-2"
SLOT="0"
KEYWORDS="~alpha amd64 arm arm64 hppa ~ia64 ~loong ~m68k ~mips ppc ppc64 ~riscv ~s390 sparc x86 ~amd64-linux ~x86-linux ~ppc-macos ~x64-macos ~x64-solaris"
IUSE="doc latex"
RDEPEND="
<dev-python/alabaster-0.8[${PYTHON_USEDEP}]
>=dev-python/Babel-2.9[${PYTHON_USEDEP}]
<dev-python/docutils-0.21[${PYTHON_USEDEP}]
>=dev-python/docutils-0.18.1[${PYTHON_USEDEP}]
>=dev-python/imagesize-1.3[${PYTHON_USEDEP}]
>=dev-python/jinja-3.0[${PYTHON_USEDEP}]
>=dev-python/pygments-2.13[${PYTHON_USEDEP}]
>=dev-python/requests-2.25.0[${PYTHON_USEDEP}]
>=dev-python/snowballstemmer-2.0[${PYTHON_USEDEP}]
dev-python/sphinxcontrib-applehelp[${PYTHON_USEDEP}]
dev-python/sphinxcontrib-devhelp[${PYTHON_USEDEP}]
dev-python/sphinxcontrib-jsmath[${PYTHON_USEDEP}]
>=dev-python/sphinxcontrib-htmlhelp-2.0.0[${PYTHON_USEDEP}]
>=dev-python/sphinxcontrib-serializinghtml-1.1.5[${PYTHON_USEDEP}]
dev-python/sphinxcontrib-qthelp[${PYTHON_USEDEP}]
>=dev-python/packaging-21.0[${PYTHON_USEDEP}]
latex? (
dev-texlive/texlive-latexextra
dev-texlive/texlive-luatex
app-text/dvipng
)
!dev-python/namespace-sphinxcontrib
"
BDEPEND="
doc? (
dev-python/sphinxcontrib-websupport[${PYTHON_USEDEP}]
media-gfx/graphviz
)
test? (
app-text/dvipng
dev-python/cython[${PYTHON_USEDEP}]
dev-python/filelock[${PYTHON_USEDEP}]
dev-python/html5lib[${PYTHON_USEDEP}]
dev-texlive/texlive-fontsextra
dev-texlive/texlive-latexextra
dev-texlive/texlive-luatex
virtual/imagemagick-tools[jpeg,png,svg]
)
"
PATCHES=(
"${FILESDIR}/sphinx-3.2.1-doc-link.patch"
"${FILESDIR}/sphinx-4.3.2-doc-link.patch"
)
distutils_enable_tests pytest
python_prepare_all() {
# disable internet access
sed -i -e 's:^intersphinx_mapping:disabled_&:' \
doc/conf.py || die
distutils-r1_python_prepare_all
}
python_compile_all() {
# we can't use distutils_enable_sphinx because it would
# introduce a dep on itself
use doc && build_sphinx doc
}
python_test() {
mkdir -p "${BUILD_DIR}/sphinx_tempdir" || die
local -x SPHINX_TEST_TEMPDIR="${BUILD_DIR}/sphinx_tempdir"
local EPYTEST_DESELECT=(
# these tests require Internet access
tests/test_build_latex.py::test_latex_images
tests/test_build_linkcheck.py::test_defaults
tests/test_build_linkcheck.py::test_defaults_json
tests/test_build_linkcheck.py::test_anchors_ignored
tests/test_build_linkcheck.py::test_check_link_response_only
tests/test_build_linkcheck.py::test_linkcheck_exclude_documents
# TODO
tests/test_ext_autodoc.py::test_cython
tests/test_ext_autodoc_autoclass.py::test_classes
tests/test_ext_autodoc_autofunction.py::test_classes
tests/test_ext_math.py::test_imgmath_numfig_html
tests/test_ext_math.py::test_imgmath_png
tests/test_ext_inheritance_diagram.py::test_import_classes
# looks like a bug in lualatex
"tests/test_build_latex.py::test_build_latex_doc[lualatex-howto-None]"
"tests/test_build_latex.py::test_build_latex_doc[lualatex-manual-None]"
)
[[ ${EPYTHON} == pypy3 ]] && EPYTEST_DESELECT+=(
tests/test_ext_autodoc.py::test_autodoc_inherited_members_None
tests/test_ext_autodoc.py::test_automethod_for_builtin
tests/test_ext_autodoc.py::test_cython
tests/test_ext_autodoc.py::test_partialfunction
tests/test_ext_autodoc_autoclass.py::test_autodoc_process_bases
tests/test_ext_autodoc_autoclass.py::test_show_inheritance_for_decendants_of_generic_type
tests/test_ext_autodoc_autoclass.py::test_show_inheritance_for_subclass_of_generic_type
tests/test_ext_autodoc_autofunction.py::test_builtin_function
tests/test_ext_autodoc_autofunction.py::test_methoddescriptor
tests/test_ext_autodoc_automodule.py::test_automodule_inherited_members
tests/test_ext_autosummary.py::test_autosummary_generate_content_for_module
tests/test_ext_autosummary.py::test_autosummary_generate_content_for_module_skipped
tests/test_util_inspect.py::test_isattributedescriptor
tests/test_util_typing.py::test_stringify_type_hints_pep_585
)
# note: pytest-xdist causes random test failures
epytest
}