Doc: add build to tox & QA tests, remove type hints (more readable)

.travis.yml

@@ -8,7 +8,7 @@ addons:
 jobs:
   include:
     - python: &python_main_version 3.8
-      env: TOXENV=black,flake8,isort,mypy,pylint
+      env: TOXENV=docs,black,flake8,isort,mypy,pylint
     - python: 3.6
       env: TOXENV=py36
     - python: 3.7

Makefile

@@ -1,6 +1,7 @@
+.PHONY: all
 all:
 	tox -p
 
 .PHONY: qa
 qa:
-	tox -p -e "black,flake8,isort,mypy,pylint"
+	tox -p -e "docs,black,flake8,isort,mypy,pylint"

docs/conf.py

@@ -34,6 +34,9 @@
 # ones.
 extensions = [ 'sphinx.ext.autodoc' ]
 
+# Type hints aren't very readable in the doc at the moment
+autodoc_typehints = "none"
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 

tox.ini

@@ -18,6 +18,10 @@ deps =
 commands =
   pytest {posargs}
 
+[testenv:docs]
+deps = sphinx
+commands = sphinx-build -d "{toxworkdir}/docs_doctree" docs "{toxworkdir}/docs_out" --color -W {posargs}
+
 [testenv:black]
 deps =
   black
@@ -32,6 +36,8 @@ deps = isort
 commands = isort --check pymediainfo tests
 
 [testenv:pylint]
+# TODO: remove constraint when this is fixed: https://github.com/PyCQA/pylint/issues/3882
+basepython = python3.8
 deps =
   pylint
   pytest