add document generation to tox, and trigger automatically at CI (also check links in documentation to avoid having dangling pointers to the internet)

1 files changed, 13 insertions, 5 deletions

diff --git a/tox.ini b/tox.ini
index d10573f..23ddfd8 100644
--- a/tox.ini
+++ b/tox.ini
@@ -6,8 +6,9 @@ envlist = py27,
           py36,
           pypy,
           pypy3,
-          coverage
-minversion = 2.7.0
+          coverage,
+          docs
+minversion = 2.9.0
 skip_missing_interpreters = true
 
 [testenv]
@@ -43,8 +44,15 @@ commands = python -m pip list --format=columns
 
 [coverage:run]
 source = dateutil
-omit = dateutil/test*
 
 [coverage:report]
-skip_covered=True
-show_missing=True
+skip_covered = True
+show_missing = True
+
+[testenv:docs]
+description = invoke sphinx-build to build the HTML docs, check that URIs are valid
+basepython = python3.6
+deps = sphinx >= 1.6.3, < 2
+       {[testenv]deps}
+commands = sphinx-build -d "{toxworkdir}/docs_doctree" docs "{toxworkdir}/docs_out" {posargs:-W --color -bhtml}
+           sphinx-build -d "{toxworkdir}/docs_doctree" docs "{toxworkdir}/docs_out" {posargs:-W --color -blinkcheck}