From 9730b699a2d2030ca21df76b0917eec71b4b3604 Mon Sep 17 00:00:00 2001 From: Patrice Clement Date: Wed, 23 May 2018 00:34:20 +0200 Subject: [PATCH] app-admin/ansible: generate and install documentation using sphinx. Documentation generation and installation is now available when enabling the doc USE flag. Sphinx will generate the exact same website as the one available on http://docs.ansible.com. As to the manual pages installation, they are already installed automatically. Closes: https://bugs.gentoo.org/652376 Package-Manager: Portage-2.3.24, Repoman-2.3.6 --- app-admin/ansible/ansible-2.5.3-r1.ebuild | 66 +++++++++++++++++++++++ app-admin/ansible/ansible-9999.ebuild | 16 ++++-- 2 files changed, 77 insertions(+), 5 deletions(-) create mode 100644 app-admin/ansible/ansible-2.5.3-r1.ebuild diff --git a/app-admin/ansible/ansible-2.5.3-r1.ebuild b/app-admin/ansible/ansible-2.5.3-r1.ebuild new file mode 100644 index 000000000000..8f63e8546445 --- /dev/null +++ b/app-admin/ansible/ansible-2.5.3-r1.ebuild @@ -0,0 +1,66 @@ +# Copyright 1999-2018 Gentoo Foundation +# Distributed under the terms of the GNU General Public License v2 + +EAPI=6 + +PYTHON_COMPAT=( python2_7 python3_{5,6} ) + +inherit distutils-r1 eutils versionator + +DESCRIPTION="Model-driven deployment, config management, and command execution framework" +HOMEPAGE="https://ansible.com/" +SRC_URI="https://releases.ansible.com/${PN}/${P}.tar.gz" + +LICENSE="GPL-3" +SLOT="0" +KEYWORDS="~amd64 ~x86 ~x64-macos" +IUSE="doc test" + +RDEPEND=" + dev-python/paramiko[${PYTHON_USEDEP}] + dev-python/jinja[${PYTHON_USEDEP}] + dev-python/pyyaml[${PYTHON_USEDEP}] + dev-python/setuptools[${PYTHON_USEDEP}] + dev-python/cryptography[${PYTHON_USEDEP}] + dev-python/httplib2[${PYTHON_USEDEP}] + dev-python/six[${PYTHON_USEDEP}] + dev-python/netaddr[${PYTHON_USEDEP}] + net-misc/sshpass + virtual/ssh +" +DEPEND=" + dev-python/setuptools[${PYTHON_USEDEP}] + >=dev-python/packaging-16.6[${PYTHON_USEDEP}] + doc? ( dev-python/sphinx[${PYTHON_USEDEP}] ) + test? ( + ${RDEPEND} + dev-python/nose[${PYTHON_USEDEP}] + >=dev-python/mock-1.0.1[${PYTHON_USEDEP}] + dev-python/passlib[${PYTHON_USEDEP}] + dev-python/coverage[${PYTHON_USEDEP}] + dev-python/unittest2[${PYTHON_USEDEP}] + dev-vcs/git + )" + +# not included in release tarball +RESTRICT="test" + +python_compile_all() { + if use doc; then + cd docs/docsite || die + export CPUS=4 + emake -f Makefile.sphinx html + fi +} + +python_test() { + nosetests -d -w test/units -v --with-coverage --cover-package=ansible --cover-branches || die +} + +python_install_all() { + use doc && local HTML_DOCS=( docs/docsite/_build/html/. ) + distutils-r1_python_install_all + + doman docs/man/man1/*.1 + dodoc -r examples +} diff --git a/app-admin/ansible/ansible-9999.ebuild b/app-admin/ansible/ansible-9999.ebuild index cbb8b3767281..0ca97a267cc6 100644 --- a/app-admin/ansible/ansible-9999.ebuild +++ b/app-admin/ansible/ansible-9999.ebuild @@ -15,7 +15,7 @@ EGIT_BRANCH="devel" LICENSE="GPL-3" SLOT="0" KEYWORDS="" -IUSE="test" +IUSE="doc test" RDEPEND=" dev-python/paramiko[${PYTHON_USEDEP}] @@ -32,6 +32,7 @@ RDEPEND=" DEPEND=" dev-python/setuptools[${PYTHON_USEDEP}] >=dev-python/packaging-16.6[${PYTHON_USEDEP}] + doc? ( dev-python/sphinx[${PYTHON_USEDEP}] ) test? ( ${RDEPEND} dev-python/nose[${PYTHON_USEDEP}] @@ -42,6 +43,14 @@ DEPEND=" dev-vcs/git )" +python_compile_all() { + if use doc; then + cd docs/docsite || die + export CPUS=4 + emake -f Makefile.sphinx html + fi +} + python_prepare_all() { rm -fv MANIFEST.in || die distutils-r1_python_prepare_all @@ -51,11 +60,8 @@ python_test() { nosetests -d -w test/units -v --with-coverage --cover-package=ansible --cover-branches || die } -python_compile_all() { - emake -j1 docs -} - python_install_all() { + use doc && local HTML_DOCS=( docs/docsite/_build/html/. ) distutils-r1_python_install_all doman docs/man/man1/*.1 -- 2.26.2