docs: Modernize build process

pbr is slowly but surely removing its Sphinx magic. Switch to using
'sphinx-build' directly, replacing pbr features ourselves. Documentation
requirements are moved to the expected location.

Signed-off-by: Stephen Finucane <stephen@that.guru>

Author: stephenfin

docs/conf.py

@@ -2,6 +2,8 @@
 #
 # git-pw documentation build configuration file
 
+import git_pw
+
 try:
     import sphinx_rtd_theme
     has_rtd_theme = True
@@ -41,9 +43,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'1.0'
+version = '.'.join(git_pw.__version__.split('.')[:-1])
 # The full version, including alpha/beta/rc tags.
-release = u'1.0'
+release = git_pw.__version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

test-requirements.txt renamed to docs/requirements.txt

@@ -1,4 +1,4 @@
--r requirements.txt
+-r ../requirements.txt
 sphinx>=1.5,<2.0
 sphinx-click>=1.0,<2.0
 click-man>=0.2,<0.3

tox.ini

@@ -4,28 +4,28 @@ envlist = pep8,mypy,docs
 
 [testenv]
 deps =
-    -r{toxinidir}/test-requirements.txt
+    -r{toxinidir}/requirements.txt
 
 [testenv:pep8]
 deps = flake8
 commands =
     flake8 {posargs} git_pw
 
-[flake8]
-show-source = True
-
 [testenv:mypy]
 deps=
-    {[testenv]deps}
     mypy
 commands=
     mypy {posargs:--ignore-missing-imports --follow-imports=skip} git_pw
 
 [testenv:docs]
+deps =
+    -r{toxinidir}/docs/requirements.txt
 commands =
-    python setup.py build_sphinx {posargs}
+    sphinx-build {posargs:-E -W} docs docs/_build/html
 
 [testenv:man]
+deps =
+    -r{toxinidir}/docs/requirements.txt
 commands =
     python setup.py --command-packages=click_man.commands man_pages
 
@@ -36,3 +36,6 @@ deps =
 commands =
     python setup.py -q bdist_wheel sdist
     twine upload --skip-existing {toxinidir}/dist/*
+
+[flake8]
+show-source = True