Add descriptions to tox testenvs

[mudpy.git] / tox.ini

diff --git a/tox.ini b/tox.ini
index 4f7b576..cfade32 100644 (file)
--- a/tox.ini
+++ b/tox.ini
@@ -1,4 +1,4 @@
-# Copyright (c) 2016-2020 mudpy authors. Permission to use, copy,
+# Copyright (c) 2016-2021 mudpy authors. Permission to use, copy,
 # modify, and distribute this software is granted under terms
 # provided in the LICENSE file distributed with this software.
 
@@ -9,6 +9,7 @@ skipsdist = True
 ignore_basepython_conflict = True
 
 [testenv]
+description = run the functional selftest with optimized configuration
 basepython = python3
 usedevelop = True
 install_command = pip install {opts} {packages}
@@ -19,11 +20,13 @@ install_command = pip install {opts} {packages}
 # calling imp instead of importlib so probably not while we still support 3.6
 setenv =
     PYTHONWARNINGS=default::DeprecationWarning
+    VIRTUALENV_CREATOR=venv
 commands = mudpy_selftest mudpy/tests/fixtures/test_daemon.yaml
 
 [testenv:bandit]
 setenv =
     PYTHONWARNINGS=error
+description = check for potential security risks in source code
 deps = bandit
 commands = bandit -r mudpy -x mudpy/tests {posargs}
 usedevelop = False
@@ -31,14 +34,17 @@ usedevelop = False
 [testenv:codespell]
 setenv =
     PYTHONWARNINGS=error
+description = find common spelling mistakes in code and documentation
 deps = codespell
 commands = codespell {posargs}
 usedevelop = False
 
 [testenv:demo]
+description = start an interactive demo with the sample config
 commands = mudpy {posargs}
 
 [testenv:dist]
+description = build release artifacts and check for conformance
 allowlist_externals = rm
 deps =
     pbr
@@ -51,6 +57,7 @@ commands =
 usedevelop = False
 
 [testenv:docs]
+description = generate hypertext documentation
 allowlist_externals = rm
 deps =
     -r{toxinidir}/requirements.txt
@@ -64,6 +71,7 @@ usedevelop = False
 [testenv:flake8]
 setenv =
     PYTHONWARNINGS=error
+description = style checks and static analysis of source code
 deps =
     flake8
     flake8-bugbear
@@ -71,11 +79,13 @@ commands = flake8 {posargs}
 usedevelop = False
 
 [testenv:selftest_config]
+description = run the selftest with the included sample config
 commands = mudpy_selftest etc/mudpy.yaml
 
 [testenv:yamllint]
 setenv =
     PYTHONWARNINGS=error
+description = test data files for correct syntax and formatting
 deps = yamllint
 commands = yamllint --strict {posargs} .
 usedevelop = False