TOX-DELAY(1) General Commands Manual TOX-DELAY(1)

tox-delay — run some Tox tests after others have completed

tox-delay [-p value | --parallel value] -e envlist [-- tox-options...]

tox-delay [-V | -h | --version | --help | --features]

The tox-delay tool is in maintenance mode, it is no longer developed. Only important bugfixes will be applied. Please switch to using the tox-stages tool from the test-stages Python library instead.

The tox-delay tool postpones the run of the specified Tox environments after the run of all the others has completed successfully. This may be useful if e.g. there are unit or functional test environments, which it would make no sense to run if the static checkers (pylint, mypy, etc) find any problems.

The tox-delay tool accepts the following command-line options:

envlist | envlist
Specify the environments for which to delay the run.
value | value
Pass a parallel execution option to Tox for the first set of environment runs.
|
Display program usage information and exit.
|
Display program version information and exit.
List the features supported by the program and exit.

The operation of the tox-delay utility is not directly influenced by any environment variables.

The operation of the tox-delay utility is not directly influenced by the contents of any files.

Run some static checkers in parallel, leave the unit and functional tests for last:

tox-delay -p all -e unit-tests,functional

Pass some options to Tox:

tox-delay -e unit-tests,functional -- --workdir /tmp/tox

Also pass some arguments to the Tox test environments (accessed via {posargs} in the tox.ini file:

tox-delay -e unit-tests,functional -- --workdir /tmp/tox -- -k chosen

Run the unit and functional tests in parallel, too:

tox-delay -p all -e unit-tests,functional -- -p all

The tox-delay utility exits 0 on success, and >0 if an error occurs.

tox(1)

No standards were harmed during the production of the tox-delay utility.

The tox-delay utility was written by Peter Pentchev in 2022. It was declared as deprecated in 2024 after the test-stages Python library was judged feature-complete.

Peter Pentchev ⟨roam@ringlet.net⟩

No, thank you :) But if you should actually find any, please report them to the author.

February 26, 2024 Debian