X-Git-Url: https://mudpy.org/gitweb?p=mudpy.git;a=blobdiff_plain;f=tox.ini;h=f9074fab34967eec2ec12f53910c6081f1be2d3c;hp=da6723b4114f18d5fa42d4fc3ed573f84f4a2787;hb=8c920b5c4b87fd8b54fd566c462c47f9e7f47693;hpb=86687f01f1ee31acb004ec91ba6d90059b89d93e

diff --git a/tox.ini b/tox.ini
index da6723b..f9074fa 100644
--- 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,53 +9,59 @@ 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}
-# TODO(fungi) Switch this to "error" and remove env-specific copies once
-# https://review.opendev.org/752793 and https://review.opendev.org/752794
-# merge and appear in a new PBR release
+# TODO(fungi) Switch this to "error" once the following are solved
+#
+# py310... importlib._bootstrap raises ImportWarning:
+#   _SixMetaPathImporter.find_spec() not found; falling back to find_module()
+# all... pip._vendor.packaging.version raises DeprecationWarning: Creating a
+#   LegacyVersion has been deprecated and will be removed in the next major
+#   release
+# yamllint... pip._vendor.packaging.specifiers raises DeprecationWarning:
+#   Creating a LegacyVersion has been deprecated and will be removed in the
+#   next major release
+# py310... pip._vendor.packaging.tags and setuptools both raise
+#   DeprecationWarning: The distutils package is deprecated and slated for
+#   removal in Python 3.12. Use setuptools or check PEP 632 for potential
+#   alternatives
 setenv =
-    PYTHONWARNINGS=default::DeprecationWarning
+    PYTHONWARNINGS = error, ignore:::importlib._bootstrap, ignore:::pip._vendor.packaging.version, ignore:::pip._vendor.packaging.specifiers, ignore:::pip._vendor.packaging.tags, ignore:::setuptools
+    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
 
 [testenv:codespell]
-# TODO(fungi) switch to a proper PyPI dep once .codespellrc is supported in a
-# release version, and ratchet down deprecation warnings for it at that point
-#setenv =
-#    PYTHONWARNINGS=error
-#deps = codespell
-deps = git+https://github.com/codespell-project/codespell
+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]
-setenv =
-    PYTHONWARNINGS=error
+description = build release artifacts and check for conformance
 allowlist_externals = rm
 deps =
     pbr
     twine
     wheel
 commands =
-    rm -fr dist
+    rm -fr {toxinidir}/dist
     python setup.py bdist_wheel sdist
-    twine check dist/*
+    twine check --strict {toxinidir}/dist/*
 usedevelop = False
 
 [testenv:docs]
-setenv =
-    PYTHONWARNINGS=error
+description = generate hypertext documentation
 allowlist_externals = rm
 deps =
     -r{toxinidir}/requirements.txt
@@ -67,8 +73,7 @@ commands =
 usedevelop = False
 
 [testenv:flake8]
-setenv =
-    PYTHONWARNINGS=error
+description = style checks and static analysis of source code
 deps =
     flake8
     flake8-bugbear
@@ -76,15 +81,16 @@ 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
+commands =
+    mudpy_selftest mudpy/tests/fixtures/test_daemon.yaml
+    yamllint --strict {posargs} .
 
 [flake8]
 show-source = True
-exclude=.git,.tox,*lib/python*,*egg,build
+exclude = .git, .tox, *lib/python*, *egg, build