tox.ini: Add descriptions to various tox envs

Add descriptions to our various tox environments and make `tox list`
look nice and provide useful hints.

Signed-off-by: John Mulligan <[email protected]>

Author: phlogistonjohn

tox.ini

@@ -4,6 +4,7 @@ envlist = formatting, {py3,py39}-mypy, py3, py39, schemacheck, py3-sys
 isolated_build = True
 
 [testenv]
+description = Run unit tests
 passenv =
     WRITABLE_PASSWD
     NSS_WRAPPER_PASSWD
@@ -17,6 +18,7 @@ commands =
     py.test -v --cov=sambacc --cov-report=html {posargs:tests}
 
 [testenv:{py3,py39}-mypy]
+description = Run mypy static checker tool
 deps =
     mypy
     types-setuptools
@@ -28,6 +30,7 @@ commands =
     mypy sambacc tests
 
 [testenv:py3-sys]
+description = Run unit tests with system packages to validate Samba integration
 # py3-sys -- more like sisyphus, am I right?
 #
 # In order to run tests that rely on "system level" packages (samba,
@@ -48,6 +51,7 @@ allowlist_externals =
     /usr/bin/py.test
 
 [testenv:formatting]
+description = Check the formatting for the source files
 deps =
     flake8
     black>=23, <24
@@ -56,6 +60,7 @@ commands =
     black --check -v .
 
 [testenv:schemacheck]
+description = Check the JSON Schema files are valid
 deps =
     black>=23, <24
     PyYAML
@@ -71,6 +76,7 @@ setenv =
     MULTIDICT_NO_EXTENSIONS=1
 
 [testenv:schemaupdate]
+description = Regenerate source files from JSON Schema file(s)
 deps =
     black>=23, <24
     PyYAML
@@ -80,6 +86,7 @@ commands =
 # this gitlint rule is not run by default.
 # Run it manually with: tox -e gitlint
 [testenv:gitlint]
+description = Check the formatting of Git commit messages
 deps =
     gitlint==0.19.1
 commands =