Create a virtual environment, install Tox, run it
Project description
Create a virtual environment to run Tox
[Home | Download | GitLab | PyPI | ReadTheDocs]
Overview
The vetox
tool creates a virtual environment, installs a suitable
version of Tox within it, and then runs Tox with the specified arguments.
It does not use any modules outside of the Python standard library, so
it is suitable for use when testing with different Python versions.
Note that the vetox
tool's main file, the src/vetox/__main__.py
file in
the source distribution, may be copied into another project's source tree and
invoked using a Python 3.x interpreter.
Invocation
The vetox
tool accepts two subcommands: run
and run-parallel
,
as well as a -c
/ --conf
option with the path to a tox.ini
file.
Any positional arguments after the run
or run-parallel
subcommand are
passed on to Tox unmodified.
Examples
Run Tox in an ephemeral virtual environment, use the tox.ini
file found in
the current working directory, run all the default Tox environments in parallel:
vetox run-parallel
Same, but use Tox 3.x and pass it some environment selection options:
vetox run-parallel -t '>= 3, < 4' -- -e first,second
Use the uv
tool to create the ephemeral virtual environment faster, and
(independently) install the tox-uv
plugin in there so that
Tox can create its own virtual environments faster:
vetox --uv --tox-uv run-parallel
Use the tox.ini
file in the parent directory, run the test environments
sequentially, one by one:
vetox -c ../tox.ini run
Display the version of the vetox
tool:
vetox version
Display the list of features supported by the vetox
tool in a format
compatible with the feature-check
tool:
vetox features
If the src/vetox/__main__.py
file was copied to another project, it may be
used to run that project's test suite:
python3 tests/vetox.py run-parallel
Contact
The vetox
tool was written by Peter Pentchev.
It is developed in a GitLab repository. This documentation is
hosted at Ringlet with a copy at ReadTheDocs.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.