SUMMARY="Python documentation generator"
DESCRIPTION="Sphinx makes it easy to create intelligent and beautiful documentation.

Sphinx uses reStructuredText as its markup language, and many of its strengths come from the \
power and straightforwardness of reStructuredText and its parsing and translating suite, the \
Docutils.

Features:
* Output formats: HTML, PDF, plain text, EPUB, TeX, manual pages, and more
* Extensive cross-references: semantic markup and automatic links for functions, classes, \
glossary terms and similar pieces of information
* Hierarchical structure: easy definition of a document tree, with automatic links to siblings, \
parents and children
* Automatic indices: general index as well as a module index
* Code highlighting: automatic highlighting using the Pygments highlighter
* Templating: Flexible HTML output using the Jinja 2 templating engine
* Extension ecosystem: Many extensions are available, for example for automatic function \
documentation or working with Jupyter notebooks.
* Language Support: Python, C, C++, JavaScript, mathematics, and many other languages through \
extensions."
HOMEPAGE="https://www.sphinx-doc.org/"
COPYRIGHT="2023 Georg Brandl"
LICENSE="BSD (2-clause)"
REVISION="5"
SOURCE_URI="https://github.com/sphinx-doc/sphinx/archive/refs/tags/v$portVersion.tar.gz"
CHECKSUM_SHA256="b41c04543148937b887097f396d7b2b54ae49d0597b68625f06ffdf702d4d917"
PATCHES="sphinx-$portVersion.patchset"

ARCHITECTURES="any"

PROVIDES="
	$portName = $portVersion
	"
REQUIRES="
	haiku
	"

BUILD_REQUIRES="
	haiku_devel
	"


PYTHON_VERSIONS=(3.10)
defaultVersion=3.10
defaultTestVersion=$defaultVersion

for i in "${!PYTHON_VERSIONS[@]}"; do
	pythonVersion=${PYTHON_VERSIONS[$i]}
	pythonPackage=python${pythonVersion//.}

	eval "PROVIDES_$pythonPackage=\"
		${portName}_$pythonPackage = $portVersion
		cmd:sphinx_apidoc_$pythonVersion = $portVersion
		cmd:sphinx_autogen_$pythonVersion = $portVersion
		cmd:sphinx_build_$pythonVersion = $portVersion
		cmd:sphinx_quickstart_$pythonVersion = $portVersion
		\""
	# Provide non-suffixed cmd only for the default Python version
	if [ $pythonVersion = $defaultVersion ]; then
		eval "PROVIDES_$pythonPackage+=\"
			cmd:sphinx_apidoc = $portVersion
			cmd:sphinx_autogen = $portVersion
			cmd:sphinx_build = $portVersion
			cmd:sphinx_quickstart = $portVersion
			\""
	fi

	eval "REQUIRES_$pythonPackage=\"
		haiku
		alabaster_$pythonPackage
		babel_$pythonPackage
		docutils_$pythonPackage
		imagesize_$pythonPackage
		jinja2_$pythonPackage
		packaging_$pythonPackage
		pygments_$pythonPackage
		requests_$pythonPackage
		snowballstemmer_$pythonPackage
		sphinxcontrib_applehelp_$pythonPackage
		sphinxcontrib_devhelp_$pythonPackage
		sphinxcontrib_htmlhelp_$pythonPackage
		sphinxcontrib_jsmath_$pythonPackage
		sphinxcontrib_qthelp_$pythonPackage
		sphinxcontrib_serializinghtml_$pythonPackage
		cmd:python$pythonVersion
		\""

	BUILD_REQUIRES+="
		build_$pythonPackage
		flit_core_$pythonPackage
		installer_$pythonPackage
		"
	BUILD_PREREQUIRES+="
		cmd:python$pythonVersion
		"
done

TEST_REQUIRES="
#	cython_$pythonPackage
	filelock_$defaultTestVersion
	html5lib_$defaultTestVersion
#	sphinx_$defaultTestVersion
	cmd:cython$pythonVersion
	cmd:sphinx_build
	cmd:pytest
	"

INSTALL()
{
	for i in "${!PYTHON_VERSIONS[@]}"; do
		pythonVersion=${PYTHON_VERSIONS[$i]}
		pythonPackage=python${pythonVersion//.}

		python=python$pythonVersion

		$python -m build --wheel --skip-dependency-check --no-isolation
		$python -m installer -p $prefix dist/*.whl

		# Version suffix all the scripts
		for f in $binDir/*; do
			mv $f $f-$pythonVersion
		done

		# And provide suffix-less symlinks for the default version
		if [ $pythonVersion = $defaultVersion ]; then
			for f in $binDir/*; do
				ln -sr $f ${f%-$pythonVersion}
			done
		fi

		packageEntries $pythonPackage \
			$prefix/lib/python* \
			$prefix/bin
	done
}

TEST()
{
	pytest -v
}