DX: colorize sphinx-build output

tox.ini

@@ -4,24 +4,21 @@ envlist =
   nb,
   py,
   sty,
-passenv = PYTHONPATH
 skip_install = True
 skip_missing_interpreters = True
 skipsdist = True
 
 [testenv]
-description =
-  Run all unit tests
 allowlist_externals =
   pytest
-setenv =
-  PYTHONHASHSEED = 0
 commands =
   pytest {posargs}
+description =
+  Run all unit tests
+setenv =
+  PYTHONHASHSEED = 0
 
 [testenv:cov]
-description =
-  Compute test coverage
 allowlist_externals =
   pytest
 commands =
@@ -30,30 +27,24 @@ commands =
     --cov-report=html \
     --cov-report=xml \
     --cov=ampform_dpd
+description =
+  Compute test coverage
 
 [testenv:doc]
-description =
-  Build documentation with Sphinx
 allowlist_externals =
   sphinx-build
-passenv =
-  EXECUTE_NB
-  TERM
-setenv =
-  PYTHONHASHSEED = 0
 commands =
   sphinx-build -nW --keep-going -b html docs/ docs/_build/html
+description =
+  Build documentation with Sphinx
+passenv = *
+setenv =
+  FORCE_COLOR = yes
+  PYTHONHASHSEED = 0
 
 [testenv:doclive]
-description =
-  Set up a server to directly preview changes to the HTML pages
 allowlist_externals =
   sphinx-autobuild
-passenv =
-  EXECUTE_NB
-  TERM
-setenv =
-  PYTHONHASHSEED = 0
 commands =
   sphinx-autobuild \
     --open-browser \
@@ -71,74 +62,78 @@ commands =
     --watch docs \
     --watch src \
     docs/ docs/_build/html
+description =
+  Set up a server to directly preview changes to the HTML pages
+passenv = *
+setenv =
+  FORCE_COLOR = yes
+  PYTHONHASHSEED = 0
 
 [testenv:docnb]
-description =
-  Execute Jupyter notebooks and build documentation with Sphinx
 allowlist_externals =
   sphinx-build
-passenv =
-  TERM
+commands =
+  sphinx-build -nW --keep-going -b html docs/ docs/_build/html
+description =
+  Execute Jupyter notebooks and build documentation with Sphinx
+passenv = *
 setenv =
   EXECUTE_NB = yes
+  FORCE_COLOR = yes
   PYTHONHASHSEED = 0
-commands =
-  sphinx-build -nW --keep-going -b html docs/ docs/_build/html
 
 [testenv:docnb-force]
-description =
-  Execute Jupyter notebooks and build documentation with Sphinx
 allowlist_externals =
   sphinx-build
-passenv =
-  TERM
+commands =
+  sphinx-build -nW --keep-going -b html docs/ docs/_build/html
+description =
+  Execute Jupyter notebooks and build documentation with Sphinx
 setenv =
+  FORCE_COLOR = yes
   FORCE_EXECUTE_NB = yes
   PYTHONHASHSEED = 0
-commands =
-  sphinx-build -nW --keep-going -b html docs/ docs/_build/html
 
 [testenv:jcache]
-description =
-  Inspect Jupyter cache
 allowlist_externals =
   jcache
-setenv =
-  PYTHONHASHSEED = 0
 changedir = docs/_build
 commands =
   jcache {posargs:notebook list}
+description =
+  Inspect Jupyter cache
+setenv =
+  PYTHONHASHSEED = 0
 
 [testenv:linkcheck]
-description =
-  Check external links in the documentation (requires internet connection)
-passenv =
-  EXECUTE_NB
-  READTHEDOCS_VERSION
 allowlist_externals =
   sphinx-build
 commands =
   sphinx-build \
-    --color \
     -T \
     -b linkcheck \
     docs/ docs/_build/linkcheck
+description =
+  Check external links in the documentation (requires internet connection)
+passenv = *
+setenv =
+  FORCE_COLOR = yes
 
 [testenv:nb]
-description =
-  Run all notebooks with pytest
 allowlist_externals =
   pytest
 commands =
   pytest --nbmake --nbmake-timeout=3600 {posargs:docs}
+description =
+  Run all notebooks with pytest
 
 [testenv:sty]
+allowlist_externals =
+  pre-commit
+commands =
+  pre-commit run {posargs} -a
 description =
   Perform all linting, formatting, and spelling checks
 setenv =
   PYTHONHASHSEED = 0
   SKIP = pyright
-allowlist_externals =
-  pre-commit
-commands =
-  pre-commit run {posargs} -a