NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #908 most downloaded on PyPI
tox is a generic virtualenv management and test command line tool
Latest stable
4.67.15
Last release 4 days ago
17 Nov 2026
Ships fairly regularly
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
16 years old
344 releases · first in 2010
Drag across the ruler to compare, or tap a release to open it.
Document breaking changes with tox 4 and packaging environments by @gaborbernat.
<a name="release-4-2-0-added"></a>
pkgenv section, allowing to set all your packaging options in one place, and support the deps key to set additional dependencies that will be installed after pyproject.toml static requires but before backends dynamic requires by @gaborbernat. (#2543)<a name="release-4-2-0-documentation"></a>
tox subcommands by @sirosen. (#2728)Packaging environments now inherit from the pkgenv section, allowing to set all your packaging options in one place, and support the deps key to set additional dependencies that will be installed after pyproject.toml static requires but before backends dynamic requires - by gaborbernat. (2543)
Document breaking changes with tox 4 and packaging environments - by gaborbernat. (2543)
Document how to handle environments whose names match tox subcommands - by sirosen. (2728)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Reuse package_env with --installpkg by @q0w.
<a name="release-4-1-3-fixed"></a>
--installpkg by @q0w. (#2442)install_command is empty by @jayaddison. (#2695)<a name="release-4-1-3-documentation"></a>
install_command values by @jayaddison. (#2695)Reuse package_env with --installpkg - by q0w. (2442)
Fail more gracefully when pip install_command is empty - by jayaddison. (2695)
Add breaking-change documentation for empty install_command values - by jayaddison. (2695)
Fix --skip-missing-interpreters behavior by @q0w.
<a name="release-4-1-2-fixed"></a>
Fix --skip-missing-interpreters behavior - by q0w. (2649)
Restore tox 3 behavior of showing the output of pip freeze, however now only active when running inside a CI environment - by gaborbernat. (2685)
Fix extracting extras from markers with many extras - by q0w. (2791)
Fix logging error with emoji in git branch name.
<a name="release-4-1-1-fixed"></a>
<a name="release-4-1-1-documentation"></a>
Fix logging error with emoji in git branch name. (2768)
Add faq entry about reuse of environments - by jugmac00. (2788)
-f can be used multiple times and on hyphenated factors (e.g. -f py311-django -f py39) by @sirosen.
<a name="release-4-1-0-added"></a>
-f can be used multiple times and on hyphenated factors (e.g. -f py311-django -f py39) by @sirosen. (#2766)<a name="release-4-1-0-documentation"></a>
-f can be used multiple times and on hyphenated factors (e.g. -f py311-django -f py39) - by sirosen. (2766)
Fix a grammatical typo in docs/user_guide.rst. (2787)
Create temp_dir if not exists by @q0w.
<a name="release-4-0-19-fixed"></a>
Strip leading and trailing whitespace when parsing elements in requirement files by @gaborbernat.
<a name="release-4-0-18-fixed"></a>
Strip leading and trailing whitespace when parsing elements in requirement files - by gaborbernat. (2773)
Suppress a report output when verbosity = 0.
<a name="release-4-0-17-added"></a>
<a name="release-4-0-17-fixed"></a>
Suppress a report output when verbosity = 0. ( #2697 )
Fix --sdistonly behavior. ( #2653 )
Override toxworkdir with –workdir. ( #2654 )
Suppress a report output when verbosity = 0. (2697)
Fix --sdistonly behavior. (2653)
Override toxworkdir with --workdir. (2654)
Fix change_dir is relative to current working directory rather than to the tox_root when using the -c argument to locate the tox.ini file by @gaborber
<a name="release-4-0-16-fixed"></a>
change_dir is relative to current working directory rather than to the tox_root when using the -c argument to locate the tox.ini file by @gaborbernat. (#2619)Fix change_dir is relative to current working directory rather than to the tox_root when using the -c argument to locate the tox.ini file - by gaborbernat. (2619)
Fix tox auto-provisioning not working and relax min_version default from 4.0 to no version constraint by @gaborbernat.
<a name="release-4-0-15-fixed"></a>
min_version default from 4.0 to no version constraint by @gaborbernat. (#2634)test_result_json_sequential when interpreter _base_executable is a hardlink (macOS homebrew) by @masenf. (#2720)Fix tox auto-provisioning not working and relax min_version default from 4.0 to no version constraint - by gaborbernat. (2634)
Fix assertion in test_result_json_sequential when interpreter _base_executable is a hardlink (macOS homebrew) by masenf. (2720)
Complex negative factor filters not working - by gaborbernat. (2747)
Do not include non test environment sections or factor filters in INI configuration to factor discovery by @gaborbernat.
<a name="release-4-0-14-fixed"></a>
Do not include non test environment sections or factor filters in INI configuration to factor discovery - by gaborbernat. (2746)
A plain section in INI configuration matching a tox environment name shadowed the laters configuration by @gaborbernat.
<a name="release-4-0-13-fixed"></a>
A plain section in INI configuration matching a tox environment name shadowed the laters configuration - by gaborbernat. (2636)
Fix space not accepted in factor filter expression - by gaborbernat. (2718)
Fix legacy CLI flags --pre, --force-deps, --sitepackages and --alwayscopy not working, and mark them as deprecated by @gaborbernat.
<a name="release-4-0-12-fixed"></a>
--pre, --force-deps, --sitepackages and --alwayscopy not working, and mark them as deprecated by @gaborbernat. (#2690)<a name="release-4-0-12-documentation"></a>
If tox is running in a tty, allocate a pty (pseudo terminal) for commands and copy termios attributes to show colors and improve interactive use - by masenf. (1773)
Fix python hash seed not being set - by gaborbernat. (2645)
Fix legacy CLI flags --pre, --force-deps, --sitepackages and --alwayscopy not working, and mark them as deprecated - by gaborbernat. (2690)
Document user level config. (2633)
Modified handling of NO_COLOR environment variable, consistent with de facto conventions: any non-empty string will enable NO_COLOR (disable colorized
<a name="release-4-0-11-added"></a>
NO_COLOR environment variable, consistent with de facto conventions: any non-empty string will enable NO_COLOR (disable colorized output); no NO_COLOR variable or NO_COLOR with an empty string will disable NO_COLOR (enable colorized output) by @ptmcg. (#2719)<a name="release-4-0-11-fixed"></a>
TOX_SKIP_ENV environment variable now works again, and can also be set via the CLI argument --skip-env for any command where -e can be set by @mgedmin. (#2698)tox config should only show env_list arguments by default instead of ALL by @gaborbernat. (#2726)Modified handling of NO_COLOR environment variable, consistent with de facto conventions: any non-empty string will enable NO_COLOR (disable colorized output); no NO_COLOR variable or NO_COLOR with an empty string will disable NO_COLOR (enable colorized output) - by ptmcg. (2719)
TOX_SKIP_ENV environment variable now works again, and can also be set via the CLI argument --skip-env for any command where -e can be set - by mgedmin. (2698)
tox config should only show env_list arguments by default instead of ALL - by gaborbernat. (2726)
Add py_dot_ver and py_impl constants to environments to show the current Python implementation and dot version (e.g. 3.11) for the current environment
<a name="release-4-0-10-added"></a>
py_dot_ver and py_impl constants to environments to show the current Python implementation and dot version (e.g. 3.11) for the current environment. These can be also used as substitutions in tox.ini by @gaborbernat. (#2640)<a name="release-4-0-10-fixed"></a>
--help now reports the default verbosity level (which is WARNING) correctly. (#2707)Add py_dot_ver and py_impl constants to environments to show the current Python implementation and dot version (e.g. 3.11) for the current environment. These can be also used as substitutions in tox.ini - by gaborbernat. (2640)
--help now reports the default verbosity level (which is WARNING) correctly. (2707)
Add tox_on_install and tox_env_teardown plugin hooks by @gaborbernat.
<a name="release-4-0-9-added"></a>
tox_on_install and tox_env_teardown plugin hooks by @gaborbernat. (#2687)PKG_CONFIG_PATH to the default pass through environment list for python tox environments by @gaborbernat. (#2700)Add tox_on_install and tox_env_teardown plugin hooks - by gaborbernat. (2687)
Add PKG_CONFIG_PATH to the default pass through environment list for python tox environments - by gaborbernat. (2700)
Fix multiple substitution on factor filtering in tox.ini when multiple factor filters match by @gaborbernat.
<a name="release-4-0-8-fixed"></a>
tox.ini when multiple factor filters match by @gaborbernat. (#2650)requirements.txt parsing by @gaborbernat. (#2682)Fix multiple substitution on factor filtering in tox.ini when multiple factor filters match - by gaborbernat. (2650)
Fix regression in requirements.txt parsing - by gaborbernat. (2682)
Support for --no-deps flag within the deps by @gaborbernat.
<a name="release-4-0-7-fixed"></a>
--no-deps flag within the deps by @gaborbernat. (#2674)Support for --no-deps flag within the deps - by @gaborbernat . ( #2674 )
Support for --no-deps flag within the deps - by gaborbernat. (2674)
Fail on pass_env/passenv entries containing whitespace by @ericzolf.
<a name="release-4-0-6-added"></a>
Fail on pass_env / passenv entries containing whitespace - by @ericzolf . ( #2658 )
Fail on pass_env/passenv entries containing whitespace - by ericzolf. (2658)
Normalize extra names passed in (fixes extra groups not being picked up during installation) by @gaborbernat.
<a name="release-4-0-5-fixed"></a>
Normalize extra names passed in (fixes extra groups not being picked up during installation) - by gaborbernat. (2655)
Disable logging from distlib.util and filelock as these log messages are too verbose by @gaborbernat.
<a name="release-4-0-4-fixed"></a>
distlib.util and filelock as these log messages are too verbose by @gaborbernat. (#2655)!r and repr() to better display erroneous values in exception from StrConverter.to_bool() by @ptmcg. (#2665)<a name="release-4-0-4-documentation"></a>
--showconfig or --help-ini with the -v flag will add interleaved debugging information, whereas tox v3 added extra lines at the start by @jugmac00. (#2622)-U when defining dependencies via deps by @jugmac00. (#2631)Disable logging from distlib.util and filelock as these log messages are too verbose - by gaborbernat. (2655)
Use !r and repr() to better display erroneous values in exception from StrConverter.to_bool() - by ptmcg. (2665)
Document that running --showconfig or --help-ini with the -v flag will add interleaved debugging information, whereas tox v3 added extra lines at the start - by jugmac00. (2622)
Document that tox v4 errors when using -U when defining dependencies via deps - by jugmac00. (2631)
Always set environment variable PYTHONIOENCODING to utf-8 to ensure tox works under Windows custom encodings by @gaborbernat.
<a name="release-4-0-3-fixed"></a>
PYTHONIOENCODING to utf-8 to ensure tox works under Windows custom encodings by @gaborbernat. (#2422)change_dir is created if does not exist before executing commands by @gaborbernat. (#2620)NUMBER_OF_PROCESSORS on Windows as is needed for multiprocessing.cpu_count by @gaborbernat. (#2629)host_python key showing the host python executable path by @gaborbernat. (#2630)<a name="release-4-0-3-documentation"></a>
passenv and instead one should use comma by @gaborbernat. (#2615)# within INI configuration by @jugmac00. (#2617)Always set environment variable PYTHONIOENCODING to utf-8 to ensure tox works under Windows custom encodings - by gaborbernat. (2422)
Ensure change_dir is created if does not exist before executing commands - by gaborbernat. (2620)
Pass through NUMBER_OF_PROCESSORS on Windows as is needed for multiprocessing.cpu_count - by gaborbernat. (2629)
The core tox configuration now contains host_python key showing the host python executable path - by gaborbernat. (2630)
Document that space separator is no longer valid for the passenv and instead one should use comma - by gaborbernat. (2615)
Document necessity to escape # within INI configuration - by jugmac00. (2617)
Unescaped comma in substitution should not be replaced during INI expansion by @gaborbernat.
<a name="release-4-0-2-fixed"></a>
tox --showconfig -e py311 reports tox section, though it should not by @gaborbernat. (#2624)Unescaped comma in substitution should not be replaced during INI expansion - by gaborbernat. (2616)
tox --showconfig -e py311 reports tox section, though it should not - by gaborbernat. (2624)
Create session views of the build wheel/sdist into the temp_dir folder by @gaborbernat.
<a name="release-4-0-1-fixed"></a>
temp_dir folder by @gaborbernat. (#2612)Create session views of the build wheel/sdist into the temp_dir folder - by gaborbernat. (2612)
Default tox min_version to 4.0 instead of current tox version - by gaborbernat. (2613)
Enumerate breaking changes of tox 4 in the FAQ, and also list major new improvements by @gaborbernat.
<a name="release-4-0-0-fixed"></a>
.temp instead of .tmp by @gaborbernat. (#2608)<a name="release-4-0-0-documentation"></a>
The temporary folder within the tox environment was named .temp instead of .tmp - by gaborbernat. (2608)
Enumerate breaking changes of tox 4 in the FAQ, and also list major new improvements - by gaborbernat. (2587)
Document in the FAQ that tox 4 will raise a warning when finding conflicting environment names - by gaborbernat. (2602)
Remove deprecated configuration option whitelist_externals which was replaced by allowlist_externals by @jugmac00.
<a name="release-4-0-0rc4-fixed"></a>
<a name="release-4-0-0rc4-deprecated"></a>
Fix extras not being kept for install dependencies - by @gaborbernat . ( #2603 )
Remove deprecated configuration option whitelist_externals which was replaced by allowlist_externals - by @jugmac00 . ( #2599 )
Fix extras not being kept for install dependencies - by gaborbernat. (2603)
Remove deprecated configuration option whitelist_externals which was replaced by allowlist_externals - by jugmac00. (2599)
Add --exit-and-dump-after flag that allows automatically killing tox if does not finish within the passed seconds, and dump the thread stacks (useful
<a name="release-4-0-0rc3-added"></a>
--exit-and-dump-after flag that allows automatically killing tox if does not finish within the passed seconds, and dump the thread stacks (useful to debug tox when it seemingly hangs) by @gaborbernat. (#2595)<a name="release-4-0-0rc3-fixed"></a>
tox4 r -e py311 &; tox4 r -e py310) by @gaborbernat. (#2594)Add --exit-and-dump-after flag that allows automatically killing tox if does not finish within the passed seconds, and dump the thread stacks (useful to debug tox when it seemingly hangs) - by gaborbernat. (2595)
Ensure that two parallel tox instance invocations on different tox environment targets will work by holding a file lock onto the packaging operations (e.g., in bash tox4 r -e py311 &; tox4 r -e py310) - by gaborbernat. (2594)
Fix leaking backend processes when the build backend does not support editable wheels and fix failure when multiple environments exist that have a build backend that does not support editable wheels - by gaborbernat. (2595)
Support for recursive extras in Python package dependencies by @gaborbernat.
<a name="release-4-0-0rc2-added"></a>
<a name="release-4-0-0rc2-fixed"></a>
- without a subsequent space too by @gaborbernat. (#2561)editable-legacy if package target is editable but the build backend does not have build_editable hook by @gaborbernat. (#2567)- character by @gaborbernat. (#2569)COLUMNS or LINES environment to the current TTY size if already set by the user by @gaborbernat. (#2575)build[virtualenv]<build> test dependency by @ssbarnea. (#2576)Support for recursive extras in Python package dependencies - by gaborbernat. (2567)
Support in INI files for ignore exit code marker the - without a subsequent space too - by gaborbernat. (2561)
Ensure paths constructed by tox are stable by resolving relative paths to fully qualified one, this insures that running tox from a different folder than project root still generates meaningful paths - by gaborbernat. (2562)
Ensure only on run environment operates at a time on a packaging environment (fixes unexpected failures when running in parallel mode) - by gaborbernat. (2564)
Fallback to editable-legacy if package target is editable but the build backend does not have build_editable hook - by gaborbernat. (2567)
Allow reference replacement in INI configuration via keys that contain the - character - by gaborbernat. (2569)
Resolve symlinks when saving Python executable path - by ssbarnea. (2574)
Do not set COLUMNS or LINES environment to the current TTY size if already set by the user - by gaborbernat. (2575)
Add missing build[virtualenv] test dependency - by ssbarnea. (2576)
Add support for generative section headers by @gaborbernat.
<a name="release-4-0-0rc1-added"></a>
<a name="release-4-0-0rc1-fixed"></a>
Add support for generative section headers - by @gaborbernat . ( #2362 )
Allow installing relative paths that go outside tox root folder. - by @ssbarnea . ( #2366 )
Add support for generative section headers - by gaborbernat. (2362)
Allow installing relative paths that go outside tox root folder. - by ssbarnea. (2366)
Improve coloring of logged commands by @ssbarnea.
<a name="release-4-0-0b3-added"></a>
PROGRAMDATA, PROGRAMFILES(x86), PROGRAMFILES environments on Windows by default as it is needed for discovering the VS C++ compiler and start testing against 3.11 by @gaborbernat. (#2492)dev-legacy mode to editable-legacy by @gaborbernat. (#2502)<a name="release-4-0-0b3-fixed"></a>
TERM=dumb or NO_COLOR environment variables. by @ssbarnea. (#1290)tox --version by @mxd4. (#2358)--hash to be specified in requirements.txt files. by @masenf. (#2373)<a name="release-4-0-0b3-documentation"></a>
Improve coloring of logged commands - by ssbarnea. (2356)
Pass PROGRAMDATA, PROGRAMFILES(x86), PROGRAMFILES environments on Windows by default as it is needed for discovering the VS C++ compiler and start testing against 3.11 - by gaborbernat. (2492)
Support PEP-621 static metadata for getting package dependencies - by gaborbernat. (2499)
Add support for editable wheels, make it the default development mode and rename dev-legacy mode to editable-legacy - by gaborbernat. (2502)
Recognize TERM=dumb or NO_COLOR environment variables. - by ssbarnea. (1290)
Allow passing config directory without filename. - by ssbarnea. (2340)
Avoid ignored explicit argument 're' console message. - by ssbarnea. (2342)
Display registered plugins with tox --version - by mxd4. (2358)
Allow --hash to be specified in requirements.txt files. - by masenf. (2373)
Avoid impossible minversion version requirements. - by ssbarnea. (2414)
Add new documentation for tox 4 - by gaborbernat. (2408)
Use tox console entry point name instead of tox4 by @gaborbernat.
<a name="release-4-0-0b2-added"></a>
tox console entry point name instead of tox4 by @gaborbernat. (#2344).tox as working directory instead of .tox/4 by @gaborbernat. (#2346)hatchling as build backend instead of setuptools by @gaborbernat. (#2368)<a name="release-4-0-0b2-fixed"></a>
-va with ignored explicit argument 'a' by @gaborbernat. (#2343)tox.ini configuration files by @gaborbernat. (#2350)<a name="release-4-0-0b2-documentation"></a>
Use tox console entry point name instead of tox4 - by gaborbernat. (2344)
Use .tox as working directory instead of .tox/4 - by gaborbernat. (2346)
Switch to hatchling as build backend instead of setuptools - by gaborbernat. (2368)
Fix CLI raises an error for -va with ignored explicit argument 'a' - by gaborbernat. (2343)
Do not interpolate values when parsing tox.ini configuration files - by gaborbernat. (2350)
Deleted the tox mailing list -- by jugmac00 (2364)
Display a hint for unrecognized argument CLI parse failures to use -- separator to pass arguments to commands by @gaborbernat.
<a name="release-4-0-0b1-added"></a>
-- separator to pass arguments to commands by @gaborbernat. (#2183)<a name="release-4-0-0b1-fixed"></a>
add_config when adding a container type by @gaborbernat. (#2233)TOX_WORK_DIR, TOX_ENV_NAME, TOX_ENV_DIR and VIRTUAL_ENV into the environment variables for all tox environments to keep contract with tox version 3 by @gaborbernat. (#2259)-p flag without arguments by @gaborbernat. (#2299)-rv (when we cannot guess upfront the verbosity level from the CLI arguments) by @gaborbernat. (#2324)devenv command does not respect specified path by @gaborbernat. (#2325)<a name="release-4-0-0b1-documentation"></a>
tox.wiki root domain by @gaborbernat. (#2242)loaders by @gaborbernat. (#2287)Display a hint for unrecognized argument CLI parse failures to use -- separator to pass arguments to commands - by gaborbernat. (2183)
Do not allow extending the config set beyond setup to ensures that all configuration values are visible via the config sub-command. - by gaborbernat. (2243)
Print a message when ignoring outcome of commands - by gaborbernat. (2315)
Fix type annotation is broken for tox.config.sets.ConfigSet.add_config when adding a container type - by gaborbernat. (2233)
Insert TOX_WORK_DIR, TOX_ENV_NAME, TOX_ENV_DIR and VIRTUAL_ENV into the environment variables for all tox environments to keep contract with tox version 3 - by gaborbernat. (2259)
Fix plugin initialization order - core plugins first, then 3rd party and finally inline - by gaborbernat. (2264)
Legacy parallel mode should accept -p flag without arguments - by gaborbernat. (2299)
Sequential run fails because the packaging environment is deleted twice for sequential runs with recreate flag on - by gaborbernat. (2300)
Require Python 3.10 to generate docs - by jugmac00. (2321)
Environment assignment for output breaks when using -rv (when we cannot guess upfront the verbosity level from the CLI arguments) - by gaborbernat. (2324)
devenv command does not respect specified path - by gaborbernat. (2325)
Enable link check during documentation build - by gaborbernat. (806)
Document ownership of the tox.wiki root domain - by gaborbernat. (2242)
Document tox.config.sets.ConfigSet.loaders - by gaborbernat. (2287)
Fix CLI documentation is missing and broken documentation references - by gaborbernat. (2310)
Support for grouping environment values together by applying labels to them either at core and environment level, and allow selecting them via the -m
<a name="release-4-0-0a10-added"></a>
core and environment level, and allow selecting them via the -m flag from the CLI by @gaborbernat. (#238)set_env configuration via the file| prefix by @gaborbernat. (#1938)--no-provision flag by @gaborbernat. (#1951)pyproject.toml or setup.py file at the tox root folder without the --install-pkg flag assumes no packaging by @gaborbernat. (#1964)external package type for package (see external-package-builder), and extract package dependencies for packages passed in via --installpkg by @gaborbernat. (#2204)TOX_LIMITED_SHEBANG environment variable is set and not empty by @gaborbernat. (#2208)--discover CLI flag by @gaborbernat. (#2245)pyproject-api and use it as a dependency by @gaborbernat. (#2274)-f CLI environment flag by @gaborbernat. (#2290)<a name="release-4-0-0a10-fixed"></a>
CTRL+C is not stopping the process on Windows by @gaborbernat. (#2159)<a name="release-4-0-0a10-deprecated"></a>
tox_add_core_config and tox_add_env_config now take a state: State argument instead of a configuration one, and Config not longer provides the envs property (instead users should migrate to State.envs) by @gaborbernat. (#2275)Support for grouping environment values together by applying labels to them either at core and environment level, and allow selecting them via the -m flag from the CLI - by gaborbernat. (238)
Support for environment files within the set_env configuration via the file| prefix - by gaborbernat. (1938)
Support for --no-provision flag - by gaborbernat. (1951)
Missing pyproject.toml or setup.py file at the tox root folder without the --install-pkg flag assumes no packaging - by gaborbernat. (1964)
Add external package type for package (see external-package-builder), and extract package dependencies for packages passed in via --installpkg - by gaborbernat. (2204)
Add support for rewriting script invocations that have valid shebang lines when the TOX_LIMITED_SHEBANG environment variable is set and not empty - by gaborbernat. (2208)
Support for the --discover CLI flag - by gaborbernat. (2245)
Moved the python packaging logic into a dedicate package pyproject-api and use it as a dependency - by gaborbernat. (2274)
Drop python 3.6 support - by gaborbernat. (2275)
Support for selecting target environments with a given factor via the -f CLI environment flag - by gaborbernat. (2290)
Fix CTRL+C is not stopping the process on Windows - by gaborbernat. (2159)
Fix list/depends commands can create tox package environment as runtime environment and display an error message - by gaborbernat. (2234)
tox_add_core_config and tox_add_env_config now take a state: State argument instead of a configuration one, and Config not longer provides the envs property (instead users should migrate to State.envs) - by gaborbernat. (2275)
Expose the parsed CLI arguments on the main configuration object for plugins and allow plugins to define their own configuration section -- by @gaborb
<a name="release-4-0-0a9-added"></a>
tox_add_env_config plugin hook called after the configuration environment is created for a tox environment and removed tox_configure. Add the main configuration object as argument to tox_add_core_config. Move the environment list method from the state to the main configuration object to allow its use within plugins -- by @gaborbernat. (#2200)tox_before_run_commands and tox_after_run_commands plugin points -- by @gaborbernat. (#2201)set_env and change the pass_env configurations -- by @gaborbernat. (#2215)<a name="release-4-0-0a9-fixed"></a>
ConfigSet directly and implement __contains__ for Loader -- by @gaborbernat. (#2209)<a name="release-4-0-0a9-documentation"></a>
tox-dev organization by @gaborbernat. (#1881)Expose the parsed CLI arguments on the main configuration object for plugins and allow plugins to define their own configuration section -- by gaborbernat. (2191)
Let tox run fail when all envs are skipped -- by jugmac00. (2195)
Expose the configuration loading mechanism to plugins to define and load their own sections. Add tox_add_env_config plugin hook called after the configuration environment is created for a tox environment and removed tox_configure. Add the main configuration object as argument to tox_add_core_config. Move the environment list method from the state to the main configuration object to allow its use within plugins -- by gaborbernat. (2200)
Allow running code in plugins before and after commands via tox_before_run_commands and tox_after_run_commands plugin points -- by gaborbernat. (2201)
Allow plugins to update the set_env and change the pass_env configurations -- by gaborbernat. (2215)
Fix env variable substitutions with defaults containing colon (e.g. URL) -- by comabrewer. (2182)
Do not allow constructing ConfigSet directly and implement __contains__ for Loader -- by gaborbernat. (2209)
Fix old-new value on recreate cache miss-match are swapped -- by gaborbernat. (2211)
Report fails when report does not support Unicode characters -- by gaborbernat. (2213)
Adopt furo theme, update our state diagram and description in user docs (SVG + light/dark variant), split the Python API into its own page from under the plugin page, and document plugin adoption under the tox-dev organization - by gaborbernat. (1881)
Add support for allowlist_externals, commands not matching error by @gaborbernat.
<a name="release-4-0-0a8-added"></a>
allowlist_externals, commands not matching error by @gaborbernat. (#1127)--result-json) under the result key containing success boolean, exit_code integer and duration float value by @gaborbernat. (#1405)exec subcommand that allows users to run an arbitrary command within the tox environment (without needing to modify their configuration) by @gaborbernat. (#1790)ignore_base_python_conflict is not set or False by @gaborbernat. (#1840)pass_env by @gaborbernat. (#2121)args_are_paths flag by @gaborbernat. (#2122)env_log_dir (compared to tox 3 extend content and keep only last run entries) by @gaborbernat. (#2123){:} substitution in ini files as placeholder for the OS path separator by @gaborbernat. (#2125)env_log_dir, env_tmp_dir and packaging metadata folders) do not delete the directory itself and recreate, but instead just delete its content (this allows the user to cd into it and still be in a valid folder after a new run) by @gaborbernat. (#2139)<a name="release-4-0-0a8-fixed"></a>
# character in path for the tox project by @gaborbernat. (#763)--recreate flag, and once specified the output does not reflect the impact of the CLI flags by @gaborbernat. (#2037)suicide_timeout, interrupt_timeout and terminate_timeout by @gaborbernat. (#2124)<a name="release-4-0-0a8-documentation"></a>
base_python by @gaborbernat. (#1975)--runner is missing default value and documentation unclear by @gaborbernat. (#2004)Add support for allowlist_externals, commands not matching error - by gaborbernat. (1127)
Add outcome of environments into the result json (--result-json) under the result key containing success boolean, exit_code integer and duration float value - by gaborbernat. (1405)
Add exec subcommand that allows users to run an arbitrary command within the tox environment (without needing to modify their configuration) - by gaborbernat. (1790)
Add check to validate the base Python names and the environments name do not conflict Python spec wise, when they do raise error if ignore_base_python_conflict is not set or False - by gaborbernat. (1840)
Allow any Unix shell-style wildcards expression for pass_env - by gaborbernat. (2121)
Add support for args_are_paths flag - by gaborbernat. (2122)
Add support for env_log_dir (compared to tox 3 extend content and keep only last run entries) - by gaborbernat. (2123)
Add support for {:} substitution in ini files as placeholder for the OS path separator - by gaborbernat. (2125)
When cleaning directories (for tox environment, env_log_dir, env_tmp_dir and packaging metadata folders) do not delete the directory itself and recreate, but instead just delete its content (this allows the user to cd into it and still be in a valid folder after a new run) - by gaborbernat. (2139)
Changes to help plugin development: simpler tox env creation argument list, expose python creation directly, allow skipping list dependencies install command for pip and executable is only part of the python cache for virtualenv - by gaborbernat. (2172)
Support # character in path for the tox project - by gaborbernat. (763)
If the command expression fails to parse with shlex fallback to literal pass through of the remaining elements - by gaborbernat. (1944)
tox config fails on --recreate flag, and once specified the output does not reflect the impact of the CLI flags - by gaborbernat. (2037)
Virtual environment creation for Python is always triggered at every run - by gaborbernat. (2041)
Add support for setting suicide_timeout, interrupt_timeout and terminate_timeout - by gaborbernat. (2124)
Parallel show output not working when there's a packaging phase in the run - by gaborbernat. (2161)
Note constraint files are a subset of requirement files - by gaborbernat. (1939)
Add a note about having a package with different Python requirements than tox and not specifying base_python - by gaborbernat. (1975)
Fix --runner is missing default value and documentation unclear - by gaborbernat. (2004)
Add support for configuration taken from the setup.cfg file -by @gaborbernat.
<a name="release-4-0-0a7-added"></a>
setup.cfg file -by @gaborbernat. (#1836)pyproject.toml file, tox section legacy_tox_ini key by @gaborbernat. (#1837)[] substitution (alias for {posargs}) by @hexagonrecursion. (#1928)[testenv] ignore_outcome - "a failing result of this testenv will not make tox fail" by @hexagonrecursion. (#1947)tox_.py. This is loaded where the tox config source is discovered. It's a Python file that can contain arbitrary Python code, such as definition of a plugin. Eventually we'll add a plugin that allows succinct declaration/generation of new tox environments by @gaborbernat. (#1963)pip package, also attach to this the requirements file parsing which got a major rework by @gaborbernat. (#1991)3.10 -by @gaborbernat. (#2014)<a name="release-4-0-0a7-fixed"></a>
tox to achieve full equivalency (such as support for the per requirement --install-option and --global-option flags) by @gaborbernat. (#1929)\{posargs} {posargs} used to expand to literal {posargs} {posargs}. Now the second {posargs} is expanded. \{posargs} {posargs} expands to {posargs} positional arguments here by @hexagonrecursion. (#1956)upstream repository for the coverage diff report. This has been hardcoded to upstream/rewrite until now. by @jugmac00. (#1972)testenv: prefix by @jugmac00, @obestwalter, @eumiro. (#1985)__import__ by @dmendek. (#1995)command keys by @jugmac00. (#2002)ALL is provided to the legacy env command by @jugmac00. (#2112)appdirs to platformdirs by @gaborbernat. (#2117)toml to tomli by @gaborbernat. (#2118)<a name="release-4-0-0a7-documentation"></a>
tox_register_tox_env, tox_add_option, tox_add_core_config, tox_configure by @gaborbernat. (#1991)-v and -q flags play together to determine CLI verbosity level by @jugmac00. (#2005)Add support for configuration taken from the setup.cfg file -by gaborbernat. (1836)
Add support for configuration taken from the pyproject.toml file, tox section legacy_tox_ini key - by gaborbernat. (1837)
Add configuration documentation - by gaborbernat. (1914)
Implemented [] substitution (alias for {posargs}) - by hexagonrecursion. (1928)
Implement [testenv] ignore_outcome - "a failing result of this testenv will not make tox fail" - by hexagonrecursion. (1947)
Inline plugin support via tox_.py. This is loaded where the tox config source is discovered. It's a Python file that can contain arbitrary Python code, such as definition of a plugin. Eventually we'll add a plugin that allows succinct declaration/generation of new tox environments - by gaborbernat. (1963)
Introduce the installer concept, and collect pip installation into a pip package, also attach to this the requirements file parsing which got a major rework - by gaborbernat. (1991)
Support CPython 3.10 -by gaborbernat. (2014)
Environments with a platform mismatch are no longer silently skipped, but properly reported - by jugmac00. (1926)
Port pip requirements file parser to tox to achieve full equivalency (such as support for the per requirement --install-option and --global-option flags) - by gaborbernat. (1929)
Support for extras with paths for Python deps and requirement files - by gaborbernat. (1933)
Due to a bug \{posargs} {posargs} used to expand to literal {posargs} {posargs}. Now the second {posargs} is expanded. \{posargs} {posargs} expands to {posargs} positional arguments here - by hexagonrecursion. (1956)
Enable setting a different upstream repository for the coverage diff report. This has been hardcoded to upstream/rewrite until now. by jugmac00. (1972)
Enable replacements (a.k.a section substitutions) for section names containing a dash in sections without the testenv: prefix - by jugmac00, obestwalter, eumiro. (1985)
Fix legacy list env command for empty/missing envlist - by jugmac00. (1987)
Requirements and constraints files handling got reimplemented, which should fix all open issues related to this area - by gaborbernat. (1991)
Use importlib instead of __import__ - by dmendek. (1995)
Evaluate factor conditions for command keys - by jugmac00. (2002)
Prefer f-strings instead of the str.format method - by eumiro. (2012)
Fix regex validation for SHA 512 hashes - by jugmac00. (2018)
Actually run all environments when ALL is provided to the legacy env command - by jugmac00. (2112)
Move from appdirs to platformdirs - by gaborbernat. (2117)
Move from toml to tomli - by gaborbernat. (2118)
Start documenting the plugin interface. Added tox_register_tox_env, tox_add_option, tox_add_core_config, tox_configure - by gaborbernat. (1991)
Explain how -v and -q flags play together to determine CLI verbosity level - by jugmac00. (2005)
Start polishing the documentation for the upcoming final release - by jugmac00. (2006)
Update documentation about changelog entries for trivial changes - by jugmac00. (2007)
Add basic quickstart implementation (just use pytest with the current Python version) by @gaborbernat.
<a name="release-4-0-0a6-added"></a>
# character within the ini configuration (to force a literal # use \#) by @gaborbernat. (#1831)install_command settings in the virtual env test environments by @gaborbernat. (#1832)package_root setupdir ( Python scoped) configuration that sets the root directory used for packaging (the location of the historical setup.py and modern pyproject.toml). This can be set at root level, or at tox environment level (the later takes precedence over the former) by @gaborbernat. (#1838)--installpkg CLI flag by @gaborbernat. (#1839)list_dependencies_command settings in the virtual env test environments by @gaborbernat. (#1842)ignore_errors settings in tox test environments by @gaborbernat. (#1843)pip_pre settings for virtual environment based tox environments by @gaborbernat. (#1844)platform settings in tox test environments by @gaborbernat. (#1845)recreate settings in tox test environments by @gaborbernat. (#1846)_TOX_SHOW_THREAD environment variable can be used to print alive threads when tox exists (useful to debug when tox hangs because of some non-finished thread) and also now prints the pid of the local subprocess when reporting the outcome of an execution by @gaborbernat. (#1915)<a name="release-4-0-0a6-fixed"></a>
testenv section and our target is testenv:fix) by @gaborbernat. (#1833)--alwayscopy and --sitepackages legacy only flags do not work by @gaborbernat. (#1839)commands_pre/commands/commands_post to be in line with tox 3 (returned incorrect exit codes and post was not always executed) by @gaborbernat. (#1843)--hash constraints by @gaborbernat. (#1903)<a name="release-4-0-0a6-deprecated"></a>
sdistsrc flag because introduces a significant complexity and is barely used (5 hits on a github search).--skip-missing-interpreters, --notest, --sdistonly, --installpkg, --develop and --skip-pkg-install CLI flags are no longer available for devenv (enforce the only sane value for these). By @gaborbernat (#1839)Add basic quickstart implementation (just use pytest with the current Python version) - by gaborbernat. (1829)
Support comments via the # character within the ini configuration (to force a literal # use \#) - by gaborbernat. (1831)
Add support for the install_command settings in the virtual env test environments - by gaborbernat. (1832)
Add support for the package_root setupdir ( Python scoped) configuration that sets the root directory used for packaging (the location of the historical setup.py and modern pyproject.toml). This can be set at root level, or at tox environment level (the later takes precedence over the former) - by gaborbernat. (1838)
Implement support for the --installpkg CLI flag - by gaborbernat. (1839)
Add support for the list_dependencies_command settings in the virtual env test environments - by gaborbernat. (1842)
Add support for the ignore_errors settings in tox test environments - by gaborbernat. (1843)
Add support for the pip_pre settings for virtual environment based tox environments - by gaborbernat. (1844)
Add support for the platform settings in tox test environments - by gaborbernat. (1845)
Add support for the recreate settings in tox test environments - by gaborbernat. (1846)
Allow Python test and packaging environments with version 2.7 - by gaborbernat. (1900)
Do not construct a requirements file for deps in virtualenv, instead pass content as CLI argument to pip - by gaborbernat. (1906)
Do not display status update environment reports when interrupted or for the final environment ran (because at the final report will be soon printed and makes the status update redundant) - by gaborbernat. (1909)
The _TOX_SHOW_THREAD environment variable can be used to print alive threads when tox exists (useful to debug when tox hangs because of some non-finished thread) and also now prints the pid of the local subprocess when reporting the outcome of an execution - by gaborbernat. (1915)
Normalize description text to collapse newlines and one or more than whitespace to a single space - by gaborbernat. (1829)
Support aliases in show config key specification (will print with the primary key) - by gaborbernat. (1831)
Show config no longer marks as unused keys that are inherited (e.g. if the key is coming from testenv section and our target is testenv:fix) - by gaborbernat. (1833)
--alwayscopy and --sitepackages legacy only flags do not work - by gaborbernat. (1839)
Fix handling of commands_pre/commands/commands_post to be in line with tox 3 (returned incorrect exit codes and post was not always executed) - by gaborbernat. (1843)
Support requirement files containing --hash constraints - by gaborbernat. (1903)
Fix a bug that caused tox to never finish when pulling configuration from a tox run environment that was never executed - by gaborbernat. (1915)
Drop support for sdistsrc flag because introduces a significant complexity and is barely used (5 hits on a github search).
--skip-missing-interpreters, --notest, --sdistonly, --installpkg, --develop and --skip-pkg-install CLI flags are no longer available for devenv (enforce the only sane value for these). By gaborbernat (1839)
Remove Jenkins override support: this feature goes against the spirit of tox - blurring the line between the CI and local runs. It also singles out a single CI provider, which opens the door for other CIs wanting similar functionality. Finally, only 54 code file examples came back on a Github search, showing this is a not widely used feature. People who still want Jenkins override support may create a tox plugin to achieve this functionality - by gaborbernat. (1841)
Support the system_site_packages/sitepackages flag for virtual environment based tox environments by @gaborbernat.
<a name="release-4-0-0a5-added"></a>
system_site_packages/sitepackages flag for virtual environment based tox environments by @gaborbernat. (#1847)always_copy/alwayscopy flag for virtual environment based tox environments by @gaborbernat. (#1848)download flag for virtual environment based tox environments by @gaborbernat. (#1849)virtualenv version changes by @gaborbernat. (#1865)<a name="release-4-0-0a5-fixed"></a>
= separator in requirement file flags, directories as requirements and correctly set the root of the requirements file when using the --root CLI flag to change the root by @gaborbernat. (#1853)ResourceWarning: unclosed file errors when running with env PYTHONTRACEMALLOC=5 PYTHONDEVMODE=y under a Python built with --with-pydebug) by @gaborbernat. (#1857)PIP_DISABLE_PIP_VERSION_CHECK)HandledError in the ini file loader,<a name="release-4-0-0a5-documentation"></a>
Support the system_site_packages/sitepackages flag for virtual environment based tox environments - by gaborbernat. (1847)
Support the always_copy/alwayscopy flag for virtual environment based tox environments - by gaborbernat. (1848)
Support the download flag for virtual environment based tox environments - by gaborbernat. (1849)
Recreate virtual environment based tox environments when the virtualenv version changes - by gaborbernat. (1865)
Not all package dependencies are installed when different tox environments in the same run use different set of extras by gaborbernat. (1868)
Support = separator in requirement file flags, directories as requirements and correctly set the root of the requirements file when using the --root CLI flag to change the root - by gaborbernat. (1853)
Cleanup local subprocess file handlers when exiting runs (fixes ResourceWarning: unclosed file errors when running with env PYTHONTRACEMALLOC=5 PYTHONDEVMODE=y under a Python built with --with-pydebug) - by gaborbernat. (1857)
Various small bugfixes:
honor updating default environment variables set by internal tox via set env (PIP_DISABLE_PIP_VERSION_CHECK)
do not multi-wrap HandledError in the ini file loader,
skipped environments are logged now with their fail message at default verbosity level,
fix an error that made the show configuration command crash when making the string of a config value failed,
support empty-new lines within the set env configurations replacements, by gaborbernat. (1864)
Add CLI documentation - by gaborbernat. (1852)
Use .tox/4 instead of .tox4 folder (so ignores for tox 3 works for tox 4 too), reminder we'll rename this to just .tox before public release, however
<a name="release-4-0-0a4-added"></a>
.tox/4 instead of .tox4 folder (so ignores for tox 3 works for tox 4 too), reminder we'll rename this to just .tox before public release, however to encourage testing tox 4 in parallel with tox 3 this is helpful by @gaborbernat. (1812)config command: section headers are yellow, keys are green, values remained white, exceptions are light red and comments are cyan by @gaborbernat. (#1821)<a name="release-4-0-0a4-fixed"></a>
-cconstraint.txt) of constraint files in deps, and expand constraint files too when viewing inside the deps or calculating weather our environment is up to date or not by @gaborbernat. (#1788)deps escape space, unless already escaped to support running specifying transitive requirements files within deps by @gaborbernat. (#1792)--recreate failed with AttributeError by @gaborbernat. (#1793)RequirementsFile from tox is rendered incorrectly in config command by @gaborbernat. (#1820)ValueError with descriptive message when a requirements file specified does not exist by @gaborbernat. (#1828)deps of the tox.ini by @gaborbernat. (#1834)<a name="release-4-0-0a4-documentation"></a>
Use .tox/4 instead of .tox4 folder (so ignores for tox 3 works for tox 4 too), reminder we'll rename this to just .tox before public release, however to encourage testing tox 4 in parallel with tox 3 this is helpful - by gaborbernat. (1812)
Colorize the config command: section headers are yellow, keys are green, values remained white, exceptions are light red and comments are cyan - by gaborbernat. (1821)
Support legacy format (-cconstraint.txt) of constraint files in deps, and expand constraint files too when viewing inside the deps or calculating weather our environment is up to date or not - by gaborbernat. (1788)
When specifying requirements/editable/constraint paths within deps escape space, unless already escaped to support running specifying transitive requirements files within deps - by gaborbernat. (1792)
When using a provisioned tox environment requesting --recreate failed with AttributeError - by gaborbernat. (1793)
Fix RequirementsFile from tox is rendered incorrectly in config command - by gaborbernat. (1820)
Fix a bug in the configuration system where referring to the same named key in another env/section causes circular dependency error - by gaborbernat. (1821)
Raise ValueError with descriptive message when a requirements file specified does not exist - by gaborbernat. (1828)
Support all valid requirement file specification without delimiting space in the deps of the tox.ini - by gaborbernat. (1834)
Add code style guide for contributors - by gaborbernat. (1734)
Raise exception when set env enters into a circular reference by @gaborbernat.
<a name="release-4-0-0a3-added"></a>
{/} as substitution for os specific path separator.{env_bin_dir} constant substitution.--discover flag by @gaborbernat. (#1784)<a name="release-4-0-0a3-fixed"></a>
set_env does not reference environments from set_env by @gaborbernat. (#1776)env substitution does not uses values from set_env by @gaborbernat. (#1779)LANG, LANGUAGE, CURL_CA_BUNDLE, SSL_CERT_FILE , LD_LIBRARY_PATH and REQUESTS_CA_BUNLDE,SYSTEMDRIVE by @gaborbernat. (#1780)PYTHONPATH (to empty string) if backend-path is empty.\ - instead users should use the new {\}, and on parsed arguments strip both ' and " quoted outcomes).: character used to separate substitution arguments may also be present in paths on Windows - do not support single capital letter values as substitution arguments) by @gaborbernat. (#1784).package to .pkg,sdist, wheel and dev separate packaging implementations into one, and internally dynamically pick the one that's needed,sdist and dev packages,wheel_build_env, if the target Python major/minor and implementation for the run tox environment and the base package tox environment matches set this to .pkg, otherwise this is .pkg-{implementation}{major}{minor},depends to use the packaging logic,Add option to disable colored output, and support NO_COLOR and FORCE_COLOR environment variables by @gaborbernat.
<a name="release-4-0-0a2-added"></a>
NO_COLOR and FORCE_COLOR environment variables by @gaborbernat. (#1630)<a name="release-4-0-0a2-fixed"></a>
\n instead of os.linesep,_overlapped.ReadFileInto by @gaborbernat. (#1556)<a name="release-4-0-0a2-documentation"></a>
Add option to disable colored output, and support NO_COLOR and FORCE_COLOR environment variables - by gaborbernat. (1630)
Fix coverage generation in CI - by gaborbernat. (1551)
Fix the CI failures:
drop Python 3.5 support as it's not expected to get to a release before EOL,
fix test using \n instead of os.linesep,
Windows Python 3.6 does not contain _overlapped.ReadFileInto - by gaborbernat. (1556)
Add base documentation by merging virtualenv structure with tox 3 - by gaborbernat. (1551)
Support provision of tox 4 with the min_version option by @hroncok #2661
Replaced deprecated license_file key with license_files in setup.cfg -- by @mgorny. #2521
Replaced deprecated license_file key with license_files in setup.cfg -- by mgorny. #2521
Add env cleanup to envreport - fix PYTHONPATH leak into "envreport" -- by f3flight. #2528
Dropped --build-option in isolated builds, an alternative fix for the SetuptoolsDeprecationWarning about using --global-option -- by @adamchainz #2497
<a name="release-3-27-0-fixed"></a>
--build-option in isolated builds, an alternative fix for the SetuptoolsDeprecationWarning about using --global-option -- by @adamchainz #2497ensure_empty_dir. #2498.tox directory when provision_tox_env is used. by @masenf #2515<a name="release-3-27-0-documentation"></a>
install_command only takes one command by @jugmac00 #2433Dropped --build-option in isolated builds, an alternative fix for the SetuptoolsDeprecationWarning about using --global-option -- by adamchainz #2497
Remove read-only files in ensure_empty_dir. #2498
Multiple tox instances no longer clobber the .tox directory when provision_tox_env is used. - by masenf #2515
Clarify that install_command only takes one command - by jugmac00 #2433
Documented problems with plugin and provision env - by ziima. #2469
Fixed SetuptoolsDeprecationWarning about using --global-option -- by @adamchainz #2478
<a name="release-3-26-0-added"></a>
tomllib on Python 3.11 or later and tomli instead of toml library on lower versions by @hroncok. #2463<a name="release-3-26-0-fixed"></a>
python environment when isolated_build = true is set -- by @Unrud #2474SetuptoolsDeprecationWarning about using --global-option -- by @adamchainz #2478Use tomllib on Python 3.11 or later and tomli instead of toml library on lower versions - by hroncok. #2463
Fix fallback to python environment when isolated_build = true is set -- by Unrud #2474
Fixed SetuptoolsDeprecationWarning about using --global-option -- by adamchainz #2478
Avoid importing pipes on Python 3.3+ to avoid DeprecationWarning on Python 3.11 -- by @adamchainz #2417
<a name="release-3-25-1-fixed"></a>
sitepackages = true will add user's site-package to the python path on Windows as expected -- by @niander #2402pipes on Python 3.3+ to avoid DeprecationWarning on Python 3.11 -- by @adamchainz #2417isolated_build when the build process produces stderr at exit. #2449<a name="release-3-25-1-documentation"></a>
PIP_CONSTRAINT environment variable over --constraint argument. #2423sitepackages = true will add user's site-package to the python path on Windows as expected -- by niander #2402
Avoid importing pipes on Python 3.3+ to avoid DeprecationWarning on Python 3.11 -- by adamchainz #2417
Fix isolated_build when the build process produces stderr at exit. #2449
Explain advantages of PIP_CONSTRAINT environment variable over --constraint argument. #2423
Ignore missing commands if they are prefixed by - -- by @cdown. #2315
<a name="release-3-25-0-added"></a>
- -- by @cdown. #2315PROGRAMFILES, PROGRAMFILES(X86), and PROGRAMDATA environment variables are now passed through, unmasking system values necessary to locate resources such as a C compiler. #2382<a name="release-3-25-0-fixed"></a>
build_requires. -- by @zariiii9003 #2332<a name="release-3-25-0-documentation"></a>
Ignore missing commands if they are prefixed by - -- by cdown. #2315
Add default environment variables (such as http_proxy) regardless of their case to passenv on UNIX -- by poggenhans. #2372
On Windows PROGRAMFILES, PROGRAMFILES(X86), and PROGRAMDATA environment variables are now passed through, unmasking system values necessary to locate resources such as a C compiler. #2382
Fixed failing isolated_build because setuptools warning was captured in build_requires. -- by zariiii9003 #2332
Avoid potential 30s delay caused by socket.getfqdn(). -- by ssbarnea #2375
Deleted the tox mailing list -- by jugmac00 #2364
Fixed an issue where usedevelop would cause an invocation error if setup.py does not exist. -- by @VincentVanlaer #2197
<a name="release-3-24-5-fixed"></a>
usedevelop would cause an invocation error if setup.py does not exist. -- by @VincentVanlaer #2197Fixed an issue where usedevelop would cause an invocation error if setup.py does not exist. -- by VincentVanlaer #2197
Fixed handling of -e ALL in parallel mode by ignoring the ALL in subprocesses -- by @guahki. #2167
<a name="release-3-24-4-fixed"></a>
-e ALL in parallel mode by ignoring the ALL in subprocesses -- by @guahki. #2167TOX_LIMITED_SHEBANG -- by @jdknight. #2208<a name="release-3-24-4-documentation"></a>
Fixed handling of -e ALL in parallel mode by ignoring the ALL in subprocesses -- by guahki. #2167
Prevent tox from using a truncated interpreter when using TOX_LIMITED_SHEBANG -- by jdknight. #2208
Enabled the use of the favicon in the Sphinx docs first introduced in 764 but not integrated fully -- webknjaz #2177
--parallel reports now show ASCII OK/FAIL/SKIP lines when full Unicode output is not available by @brettcs #1421
--parallel reports now show ASCII OK/FAIL/SKIP lines when full Unicode output is not available - by brettcs #1421
Started enforcing valid references in Sphinx docs -- webknjaz #2168
include LC_ALL to implicit list of passenv variables by @ssbarnea #2162
get_requires_for_build_sdist hook (PEP 517) is assumed to return an empty list if left unimplemented by the backend build system by @oczkoisse #2130
<a name="release-3-24-1-fixed"></a>
get_requires_for_build_sdist hook (PEP 517) is assumed to return an empty list if left unimplemented by the backend build system by @oczkoisse #2130<a name="release-3-24-1-documentation"></a>
install_command now also mentions that you can provide arbitrary commands by @jugmac00 #2081get_requires_for_build_sdist hook (PEP 517) is assumed to return an empty list if left unimplemented by the backend build system - by oczkoisse #2130
The documentation of install_command now also mentions that you can provide arbitrary commands - by jugmac00 #2081
tox no longer shows deprecation warnings for distutils.sysconfig on Python 3.10 by @9999years #2100
<a name="release-3-24-0-fixed"></a>
--devenv no longer modifies the directory in which the .tox environment is provisioned by @isaac-ped #2065<a name="release-3-24-0-documentation"></a>
<a name="release-3-24-0-deprecated"></a>
tox no longer shows deprecation warnings for distutils.sysconfig on Python 3.10 by @9999years #2100--devenv no longer modifies the directory in which the .tox environment is provisioned - by isaac-ped #2065
Fix show config when the package names are not in canonical form - by gaborbernat. #2103
Extended environment variables section - by majiang #2036
tox no longer shows deprecation warnings for distutils.sysconfig on Python 3.10 - by 9999years #2100
Distinguish between normal Windows Python and MSYS2 Python when looking for virtualenv executable path. Adds os.sep to tox.interpreters.InterpreterInf
<a name="release-3-23-1-fixed"></a>
tox.interpreters.InterpreterInfo by @jschwartzentruber #1982tox-conda isolation build bug by @AntoineD. #2056<a name="release-3-23-1-documentation"></a>
setenv in the [testenv] sections, not wrongly in the [tox] main section. by @AndreyNautilus #1999<a name="release-3-23-1-packaging"></a>
Distinguish between normal Windows Python and MSYS2 Python when looking for virtualenv executable path. Adds os.sep to tox.interpreters.InterpreterInfo - by jschwartzentruber #1982
Fix a tox-conda isolation build bug - by AntoineD. #2056
Update examples in the documentation to use setenv in the [testenv] sections, not wrongly in the [tox] main section. - by AndreyNautilus #1999
Enable building tox with setuptools_scm 6+ by hroncok #1984
tox can now be invoked with a new --no-provision flag that prevents provision, if requires or minversion are not satisfied, tox will fail; if a path i
<a name="release-3-23-0-added"></a>
--no-provision flag that prevents provision, if requires or minversion are not satisfied, tox will fail; if a path is specified as an argument to the flag (e.g. as tox --no-provision missing.json) and provision is prevented, provision metadata are written as JSON to that path by @hroncok #1921pyproject.toml by @domdfcoding #1940tox can now be invoked with a new --no-provision flag that prevents provision, if requires or minversion are not satisfied, tox will fail; if a path is specified as an argument to the flag (e.g. as tox --no-provision missing.json) and provision is prevented, provision metadata are written as JSON to that path - by hroncok #1921
Unicode support in pyproject.toml - by domdfcoding #1940
The value of the requires configuration option is now exposed via the tox.config.Config object by @hroncok #1918
The value of the requires configuration option is now exposed via the tox.config.Config object - by hroncok #1918
Adapt tests not to assume the easy_install command exists, as it was removed from setuptools 52.0.0+ by @hroncok #1893
Adapt tests not to assume the easy_install command exists, as it was removed from setuptools 52.0.0+ - by hroncok #1893
Fix a killed tox (via SIGTERM) leaving the commands subprocesses running by handling it as if it were a KeyboardInterrupt by @dajose #1772
Fix a killed tox (via SIGTERM) leaving the commands subprocesses running by handling it as if it were a KeyboardInterrupt - by dajose #1772
Newer coverage tools update the COV_CORE_CONTEXT environment variable, add it to the list of environment variables that can change in our pytest plugi
<a name="release-3-21-2-fixed"></a>
COV_CORE_CONTEXT environment variable, add it to the list of environment variables that can change in our pytest plugin by @gaborbernat. #1854Newer coverage tools update the COV_CORE_CONTEXT environment variable, add it to the list of environment variables that can change in our pytest plugin - by gaborbernat. #1854
Prevent .tox in envlist by @jayvdb #1684
<a name="release-3-21-1-added"></a>
<a name="release-3-21-1-fixed"></a>
<a name="release-3-21-1-packaging"></a>
Prevent .tox in envlist - by @jayvdb #1684
Fix regression that broke using install_command in config replacements - by @jayvdb #1777
Fix regression parsing posargs default containing colon. - by @jayvdb #1785
Enable building tox with setuptools_scm 4 and 5 by @hroncok #1799
Prevent .tox in envlist - by jayvdb #1684
Fix regression that broke using install_command in config replacements - by jayvdb #1777
Fix regression parsing posargs default containing colon. - by jayvdb #1785
Enable building tox with setuptools_scm 4 and 5 by hroncok #1799
One column per quarter.