Merge https://github.com/jaraco/skeleton

Author: jaraco

.github/workflows/main.yml

@@ -16,7 +16,7 @@ env:
 
   # Ensure tests can sense settings about the environment
   TOX_OVERRIDE: >-
-    testenv.pass_env+=GITHUB_*
+    testenv.pass_env+=GITHUB_*,FORCE_COLOR
 
 
 jobs:

tox.ini

@@ -1,4 +1,5 @@
 [testenv]
+description = perform primary checks (tests, style, types, coverage)
 deps =
 setenv =
 	PYTHONWARNDEFAULTENCODING = 1
@@ -11,6 +12,7 @@ extras =
 	testing
 
 [testenv:diffcov]
+description = run tests and check that diff from main is covered
 deps =
 	diff-cover
 commands =
@@ -19,6 +21,7 @@ commands =
 	diff-cover coverage.xml --compare-branch=origin/main --fail-under=100
 
 [testenv:docs]
+description = build the documentation
 extras =
 	docs
 	testing
@@ -28,22 +31,24 @@ commands =
 	python -m sphinxlint
 
 [testenv:finalize]
+description = assemble changelog and tag a release
 skip_install = True
 deps =
 	towncrier
 	jaraco.develop >= 7.23
-passenv = *
+pass_env = *
 commands =
 	python -m jaraco.develop.finalize
 
 
 [testenv:release]
+description = publish the package to PyPI and GitHub
 skip_install = True
 deps =
 	build
 	twine>=3
 	jaraco.develop>=7.1
-passenv =
+pass_env =
 	TWINE_PASSWORD
 	GITHUB_TOKEN
 setenv =