fixup! fixup! fixup! Add tox.ini, pyproject.toml & mypy. Add pylint to the GitHub Action view

Author: bernhardkaindl

tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist = py36-test, py37-test, py38-test, py39-test, py310-test,
+envlist = py36-test, py37-test, py38-test, py39-test, py310-cov,
     py311-mypy, py311-covcombine
 isolated_build = true
 skip_missing_interpreters = true
@@ -9,16 +9,18 @@ skip_missing_interpreters = true
 tox_pip_extensions_ext_venv_update = true
 
 [test]
-deps = -r requirements-dev.txt
+description = Run pytest in this environment with --cov for use in other stages
+deps        = -r requirements-dev.txt
+commands    = pytest --cov -v
 
 [testenv]
 description = Run in a {basepython} virtualenv:
-    test: pytest
-    cov: generate coverage html reports
-    covcombine: generate a combined coverage html report with py27-cov merged in
-    fox: generate coverage html reports and open them in firefox
-    mypy: mypy static analyis
-    covcp: copy the generated .converage and coverage.xml to the UPLOAD_DIR dir for upload
+    cov:        {[cov]description}
+    covcombine: {[covcombine]description}
+    covcp:      Copy the generated .converage and coverage.xml to the UPLOAD_DIR dir
+    fox:        {[fox]description}
+    mypy:       Run mypy for static analyis (in the future, add pyre, pytype, etc)
+    test:       {[test]description}
 deps =
     {cov,covcp,covcombine,mypy,fox,test}: {[test]deps}
     {cov,covcp,covcombine,fox}: coverage[toml]
@@ -55,7 +57,7 @@ setenv =
     COVERAGE_FILE={envlogdir}/.coverage
     {[cov]setenv}
 commands =
-    {cov,covcp,covcombine,fox,test}: pytest --cov -v
+    {cov,covcp,covcombine,fox,test}: {[test]commands}
     {cov,covcp,covcombine}: {[cov]commands}
     covcp: cp -av {envlogdir}/coverage.xml {env:UPLOAD_DIR:.}
     covcombine: {[covcombine]commands}
@@ -67,18 +69,20 @@ commands =
     fox: {[fox]commands}
 
 [cov]
-setenv =   PY3_DIFFCOVER_OPTIONS=--ignore-whitespace --show-uncovered
-    py27:  PY3_DIFFCOVER_OPTIONS=
-commands =
-    coverage xml  -o {envlogdir}/coverage.xml
+description = Generate coverage html reports (incl. diff-cover) for this environment
+setenv      = PY3_DIFFCOVER_OPTIONS=--ignore-whitespace --show-uncovered
+       py27:  PY3_DIFFCOVER_OPTIONS=
+commands    =
+    coverage xml  -o {envlogdir}/coverage.xml --fail-under 68
     coverage html -d {envlogdir}/htmlcov
     coverage html -d {envlogdir}/htmlcov-tests --include="tests/*"
     diff-cover --compare-branch=origin/master       \
-      {env:PY3_DIFFCOVER_OPTIONS} --fail-under 91   \
+      {env:PY3_DIFFCOVER_OPTIONS} --fail-under 94   \
       --html-report  {envlogdir}/coverage-diff.html \
                      {envlogdir}/coverage.xml
 
 [covcombine]
+description = Generate combined coverage reports with py27-test coverage merged
 commands =
     tox -e py27-test
     sh -c 'export COVERAGE_FILE=$COVERAGE_FILE-combined; \
@@ -111,6 +115,7 @@ commands =
                  cat {envlogdir}/pylint-warnings-on-changed-lines.txt;exit 5;fi'
 
 [fox]
+description = Generate combined coverage html reports and open them in firefox
 commands = firefox   {envlogdir}/coverage-diff.html       \
                      {envlogdir}/htmlcov/index.html       \
                      {envlogdir}/htmlcov-tests/index.html \