tox.ini

# To use tox, see https://tox.readthedocs.io
# Simply pip or conda install tox
# If you use conda, you may also want to install tox-conda
# then run `tox` or `tox -- {pytest args}`
# To run in parallel using `tox -p` (this does not appear to work for this repo)

# To rebuild the tox environment, for example when dependencies change, use
# `tox -r`

[tox]
# Note: py313-sphinx6 excluded - unlikely combination that generates 1870+
# deprecation warnings from Sphinx 6's use of datetime.utcfromtimestamp()
envlist = py{310,311,312}-sphinx{6,7,8},py313-sphinx{7,8}
skip_missing_interpreters = true

[testenv]
usedevelop=true
recreate = false

[testenv:py{310,311,312,313}-pre-commit]
extras = code_style
commands = pre-commit run {posargs}

[testenv:py{310,311,312}-sphinx{6,7,8},py313-sphinx{7,8}]
skip_install = false
package = editable
# Use the 'testing' extras from pyproject.toml, but constrain Sphinx version
# This ensures the Sphinx version specified in deps takes precedence
extras = testing
constrain_package_deps = true
use_frozen_constraints = true
deps =
	sphinx6: sphinx>=6.1,<7
	sphinx7: sphinx>=7,<8
	py310-sphinx8: sphinx>=8.1,<8.2
	py{311,312,313}-sphinx8: sphinx>=8.2,<9
commands = pytest --verbose {posargs}

[testenv:docs-{update,clean}]
extras = rtd
whitelist_externals = rm
commands =
	clean: rm -rf docs/build
	sphinx-build {posargs} -b html docs/source docs/build/html