[Python-modules-commits] [python-cycler] 07/08: Build and provide documentation; Closes: #800907

[Sandro Tosi]

This is an automated email from the git hooks/post-receive script.

morph pushed a commit to branch master
in repository python-cycler.

commit f8b78512108beaeaded1da3e2313046f19f09a85
Author: Sandro Tosi <morph at debian.org>
Date:   Sat Apr 9 14:03:15 2016 +0100

    Build and provide documentation; Closes: #800907
---
 debian/changelog                  |  3 ++-
 debian/control                    | 18 +++++++++++++++++-
 debian/python-cycler-doc.doc-base |  9 +++++++++
 debian/rules                      | 10 +++++++++-
 4 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 3b0cf86..6d7d4a7 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -7,12 +7,13 @@ python-cycler (0.10.0-1) UNRELEASED; urgency=medium
     - bump Standards-Version to 3.9.7 (no changes needed)
   * debian/{control, rules}
     - run tests at build time; Closes: #800908
+  * Build and provide documentation; Closes: #800907
 
   [ Ondřej Nový ]
   * Fixed homepage (https)
   * Fixed VCS URL (https)
 
- -- Sandro Tosi <morph at debian.org>  Sat, 09 Apr 2016 11:30:38 +0100
+ -- Sandro Tosi <morph at debian.org>  Sat, 09 Apr 2016 13:41:38 +0100
 
 python-cycler (0.9.0-1) unstable; urgency=low
 
diff --git a/debian/control b/debian/control
index 45668c8..b20be5e 100644
--- a/debian/control
+++ b/debian/control
@@ -3,7 +3,7 @@ Section: python
 Priority: optional
 Maintainer: Sandro Tosi <morph at debian.org>
 Uploaders: Debian Python Modules Team <python-modules-team at lists.alioth.debian.org>
-Build-Depends: debhelper (>= 9), python-all, python3-all, dh-python, python-six, python3-six, python-setuptools, python3-setuptools, python-nose, python3-nose
+Build-Depends: debhelper (>= 9), python-all, python3-all, dh-python, python-six, python3-six, python-setuptools, python3-setuptools, python-nose, python3-nose, python-sphinx, python-matplotlib, ipython, python-numpydoc
 Standards-Version: 3.9.7
 Homepage: http://matplotlib.org/cycler/
 Vcs-Git: https://anonscm.debian.org/git/python-modules/packages/python-cycler.git
@@ -12,6 +12,7 @@ Vcs-Browser: https://anonscm.debian.org/cgit/python-modules/packages/python-cycl
 Package: python-cycler
 Architecture: all
 Depends: ${python:Depends}, ${misc:Depends}
+Suggests: python-cycler-doc
 Description: composable kwarg iterator (Python 2)
  When using matplotlib and plotting more than one line, it is common to want to
  be able to cycle over one  or more artist styles; but the plotting logic can
@@ -23,6 +24,7 @@ Description: composable kwarg iterator (Python 2)
 Package: python3-cycler
 Architecture: all
 Depends: ${python3:Depends}, ${misc:Depends}
+Suggests: python-cycler-doc
 Description: composable kwarg iterator (Python 3)
  When using matplotlib and plotting more than one line, it is common to want to
  be able to cycle over one  or more artist styles; but the plotting logic can
@@ -32,3 +34,17 @@ Description: composable kwarg iterator (Python 3)
  class, a composable kwarg iterator, was developed.
  .
  This package contains the Python 3 version of Cycler.
+
+Package: python-cycler-doc
+Section: doc
+Architecture: all
+Depends: ${misc:Depends}, ${sphinxdoc:Depends}, libjs-mathjax
+Description: composable kwarg iterator (documentation)
+ When using matplotlib and plotting more than one line, it is common to want to
+ be able to cycle over one  or more artist styles; but the plotting logic can
+ quickly become very involved.
+ .
+ To address this and allow easy cycling over arbitrary 'kwargs' the `Cycler`
+ class, a composable kwarg iterator, was developed.
+ .
+ This package contains the documentation for Cycler.
diff --git a/debian/python-cycler-doc.doc-base b/debian/python-cycler-doc.doc-base
new file mode 100644
index 0000000..6037bdf
--- /dev/null
+++ b/debian/python-cycler-doc.doc-base
@@ -0,0 +1,9 @@
+Document: python-cycler-doc
+Title: Composable cycles documentation
+Author: Matplotlib Developers
+Abstract: Composable style cycles
+Section: Programming/Python
+
+Format: HTML
+Index: /usr/share/doc/python-cycler-doc/html/index.html
+Files: /usr/share/doc/python-cycler-doc/html/*
diff --git a/debian/rules b/debian/rules
index 332213a..74d8868 100755
--- a/debian/rules
+++ b/debian/rules
@@ -4,7 +4,7 @@ PY2VERS := $(shell pyversions -s)
 PY3VERS := $(shell py3versions -s)
 
 %:
-	dh $@ --with python2,python3
+	dh $@ --with python2,python3,sphinxdoc
 
 override_dh_auto_clean:
 	dh_auto_clean
@@ -17,6 +17,9 @@ override_dh_auto_build:
 		$$python setup.py build; \
 	done
 
+	LIB=$$(python -c "from distutils.command.build import build ; from distutils.core import Distribution ; b = build(Distribution()) ; b.finalize_options() ; print(b.build_purelib)")
+	PYTHONPATH=$(CURDIR)/$$LIB $(MAKE) -C doc html
+
 override_dh_auto_test:
 ifeq ($(filter nocheck,$(DEB_BUILD_OPTIONS)),)
 	# run tests
@@ -37,3 +40,8 @@ override_dh_auto_install:
 		$$python setup.py install --root=debian/python3-cycler --install-layout=deb; \
 	done
 
+override_dh_installdocs:
+	dh_installdocs
+	ln -s /usr/share/javascript/mathjax/MathJax.js $(CURDIR)/doc/build/html/_static/MathJax.js
+	find doc/build/html -name "*.html" -exec sed -i "s|https://cdn.mathjax.org/mathjax/latest/MathJax.js|_static/MathJax.js|" {} \;
+	dh_installdocs -ppython-cycler-doc doc/build/html

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/python-cycler.git