---
name: "tox-delay"
section: "1"
platform: "linux"
package: "tox-delay"
version: "0.1.2-1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/tox-delay"
---

# tox-delay(1)

run some Tox tests after others have completed

## NAME

**tox-delay** – run some Tox tests after others have completed

## SYNOPSIS

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

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

## DESCRIPTION

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:

- **-e** *envlist* \| **--envlist** *envlist*

  Specify the environments for which to delay the run.

- **-p** *value* \| **--parallel** *value*

  Pass a parallel execution option to Tox for the first set of environment runs.

- **-h** \| **--help**

  Display program usage information and exit.

- **-V** \| **--version**

  Display program version information and exit.

- **--features**

  List the features supported by the program and exit.

## ENVIRONMENT

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

## FILES

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

## EXAMPLES

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
```

## DIAGNOSTICS

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

## SEE ALSO

[tox(1)](/tox/1.md)

## STANDARDS

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

## HISTORY

The **tox-delay** utility was written by Peter Pentchev in 2022.

## AUTHORS

Peter Pentchev ⟨roam@ringlet.net⟩

## BUGS

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