# 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 }