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 today
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.
Separate the list dependencies functionality to a separate abstract class allowing code reuse in plugins (such as tox-uv) by :gaborbernat\`.
<a name="release-4-20-0-added"></a>
tox-uv) by :gaborbernat`. (#3347)Separate the list dependencies functionality to a separate abstract class allowing code reuse in plugins (such as tox-uv) - by :gaborbernat`. (3347)
Support pypy- . environment names for PyPy environments by @gaborbernat.
<a name="release-4-19-0-added"></a>
pypy-<major>.<minor> environment names for PyPy environments by @gaborbernat. (#3346)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Support pypy-<major>.<minor> environment names for PyPy environments - by @gaborbernat . ( #3346 )
Support pypy-<major>.<minor> environment names for PyPy environments - by gaborbernat. (3346)
Fix and test the string spec for the sys.executable interpreter (introduced in #3325) by @hroncok
<a name="release-4-18-1-fixed"></a>
sys.executable interpreter (introduced in #3325) by @hroncok (#3327)<a name="release-4-18-1-documentation"></a>
tox_env_teardown docstring to explain the hook is called after a tox env was teared down. (#3305)Fix and test the string spec for the sys.executable interpreter (introduced in 3325) - by hroncok (3327)
Changes the tox_env_teardown docstring to explain the hook is called after a tox env was teared down. (3305)
Suppress spinner in parallel runs in CI by @ziima.
<a name="release-4-18-0-added"></a>
<a name="release-4-18-0-fixed"></a>
Suppress spinner in parallel runs in CI - by @ziima . ( #3318 )
Boost temporary directories cleanup in tests - by @ziima . ( #3278 )
Fix absolute base python paths conflicting - by @gaborbernat . ( #3325 )
Suppress spinner in parallel runs in CI - by ziima. (3318)
Boost temporary directories cleanup in tests - by ziima. (3278)
Fix absolute base python paths conflicting - by gaborbernat. (3325)
Support for running -e . has been lost, fixing it by @gaborbernat.
<a name="release-4-17-1-fixed"></a>
-e <major>.<minor> has been lost, fixing it by @gaborbernat. (#2849)base_python now accepts absolute paths to interpreter executable by @paveldikov. (#3191)Support for running -e <major>.<minor> has been lost, fixing it - by gaborbernat. (2849)
base_python now accepts absolute paths to interpreter executable - by paveldikov. (3191)
Add graalpy prefix as a supported base python
<a name="release-4-17-0-added"></a>
graalpy prefix as a supported base python (#3312)on_platform core configuration holding the tox platform and do not install package when exec an environment by @gaborbernat. (#3315)<a name="release-4-17-0-fixed"></a>
Add graalpy prefix as a supported base python ( #3312 )
Add on_platform core configuration holding the tox platform and do not install package when exec an environment by @gaborbernat . ( #3315 )
Add table with default environment variables per OS ( #2753 )
Add graalpy prefix as a supported base python (3312)
Add on_platform core configuration holding the tox platform and do not install package when exec an environment by gaborbernat. (3315)
Add table with default environment variables per OS (2753)
- Add windir to the default list of Windows pass_env environment variables. by @kurtmckee
<a name="release-4-16-0-fixed"></a>
windir to the default list of Windows pass_env environment variables. by @kurtmckee (#3302)<a name="release-4-16-0-documentation"></a>
Add windir to the default list of Windows pass_env environment variables. - by kurtmckee (3302)
Fix typo in configuration example and fix broken link to code style guide. - by srenfo (3297)
Fix skip_missing_interpreters option for package = wheel
<a name="release-4-15-1-added"></a>
skip_missing_interpreters option for package = wheel (#3269)<a name="release-4-15-1-fixed"></a>
ConfigSet.add_config to receive parameterized generics for of_type. (#3288)Fix skip_missing_interpreters option for package = wheel ( #3269 )
Fix section substitution with setenv. ( #3262 )
Allow ConfigSet.add_config to receive parameterized generics for of_type . ( #3288 )
Fix skip_missing_interpreters option for package = wheel (3269)
Fix section substitution with setenv. (3262)
Allow ConfigSet.add_config to receive parameterized generics for of_type. (3288)
Add support for multiple appending override options (-x, --override) on command line by @amitschang.
<a name="release-4-15-0-added"></a>
<a name="release-4-15-0-fixed"></a>
c was dropped from packages in constraints files by @jugmac00. (#3247)deps with --override testenv.deps+=foo by @stefanor. (#3256)rewrite in the documentation to main. (#3257)Distribution type by @stefanor. (#3260)--discover flag. by @mimre25 (#3272)<a name="release-4-15-0-documentation"></a>
--discover flag's description to avoid confusion between paths and executables. by @mimre25 (#3274)Add support for multiple appending override options (-x, --override) on command line - by amitschang. (3261)
Add support for inverting exit code success criteria using bang (!) (3271)
Fix issue that the leading character c was dropped from packages in constraints files - by jugmac00. (3247)
Allow appending to deps with --override testenv.deps+=foo - by stefanor. (3256)
Fix non-existing branch rewrite in the documentation to main. (3257)
Update test typing for build 1.2.0, which has an explicit Distribution type - by stefanor. (3260)
Fix broken input parsing for --discover flag. - by mimre25 (3272)
Rephrase --discover flag's description to avoid confusion between paths and executables. - by mimre25 (3274)
Add provision arguments to ToxParser to fix crash when provisioning new tox environment without list-dependencies by @seyidaniels
<a name="release-4-14-2-fixed"></a>
<a name="release-4-14-2-documentation"></a>
fresh_subprocess documentation. (#3241)Add provision arguments to ToxParser to fix crash when provisioning new tox environment without list-dependencies by seyidaniels (3190)
Removed unused line from the fresh_subprocess documentation. (3241)
Fix crash with fresh subprocess, if the build backend is setuptools automatically enable fresh subprocesses for build backend calls by @gaborbernat.
<a name="release-4-14-1-fixed"></a>
Fix crash with fresh subprocess, if the build backend is setuptools automatically enable fresh subprocesses for build backend calls - by gaborbernat. (3235)
Support enabling fresh subprocess for packaging build backends via fresh_subprocess by @gaborbernat.
<a name="release-4-14-0-added"></a>
fresh_subprocess by @gaborbernat. (#3227)--version via tox_append_version_info method in the plugin module by @gaborbernat. (#3234)Support enabling fresh subprocess for packaging build backends via fresh_subprocess - by gaborbernat. (3227)
Allow plugins attaching additional information to --version via tox_append_version_info method in the plugin module - by gaborbernat. (3234)
Extract virtual environment packaging code to its own base class not tied to virtualenv by @gaborbernat.
<a name="release-4-13-0-added"></a>
virtualenv by @gaborbernat. (#3221)<a name="release-4-13-0-documentation"></a>
pytest with tox run-parallel by @faph. (#3187)Extract virtual environment packaging code to its own base class not tied to virtualenv - by gaborbernat. (3221)
Documented usage of pytest with tox run-parallel - by faph. (3187)
Configuration: state in config directive sections their ini file sections - by 0cjs. (3194)
Development: summarize important points experienced developers need to know - by 0cjs. (3197)
Fixed bug where running with --installpkg and multiple envs could not clean up between tests
<a name="release-4-12-1-fixed"></a>
Fixed bug where running with --installpkg and multiple envs could not clean up between tests (3165)
Always pass FORCE_COLOR and NO_COLOR to the environment
<a name="release-4-12-0-added"></a>
FORCE_COLOR and NO_COLOR to the environment (#3172)<a name="release-4-12-0-fixed"></a>
--parallel-no-spinner flag now implies --parallel (#3158)<a name="release-4-12-0-documentation"></a>
open an issue link in development.rst (#3179)Always pass FORCE_COLOR and NO_COLOR to the environment ( #3172 )
--parallel-no-spinner flag now implies --parallel ( #3158 )
-Fix open an issue link in development.rst ( #3179 )
Always pass FORCE_COLOR and NO_COLOR to the environment (3172)
--parallel-no-spinner flag now implies --parallel (3158)
-Fix open an issue link in development.rst (3179)
Fix terminal size of tox subcommands (fixes ipython, ipdb, prompt_toolkit, ...).
<a name="release-4-11-4-fixed"></a>
quickstart command from requiring root positional argument (#3084)<a name="release-4-11-4-documentation"></a>
install_command by @hashar. (#3126)base_python by @rpatterson. (#3156)Fix terminal size of tox subcommands (fixes ipython, ipdb, prompt_toolkit, ...). (2999)
Fix quickstart command from requiring root positional argument (3084)
Added 'AppData' to the default passed environment variables on Windows. (3151)
Fix default value for install_command - by hashar. (3126)
Fix default value for base_python - by rpatterson. (3156)
Handle FileNotFoundError when the base_python interpreter doesn't exist
<a name="release-4-11-3-fixed"></a>
FileNotFoundError when the base_python interpreter doesn't exist (#3105)<a name="release-4-11-3-documentation"></a>
Handle FileNotFoundError when the base_python interpreter doesn't exist (3105)
Explain how plugins are registered and discovered - by hashar. (3116)
Fix bug in config.rst by removing stray colons left over from (#3111) by @posita.
Fix bug in config.rst by removing stray colons left over from (3111) - by posita. (3118)
Provide example to make CLI help more helpful for -x/--override - by posita. (3119)
Fix typos discovered by codespell - by cclauss. (3113)
Allow passing in multiple overrides using the ; character and fix , being used as splitting values by @gaborbernat.
<a name="release-4-11-1-fixed"></a>
; character and fix , being used as splitting values by @gaborbernat. (#3112)Allow passing in multiple overrides using the ; character and fix , being used as splitting values - by gaborbernat. (3112)
Add support for setting build backend config_settings in the configuration file by @gaborbernat.
<a name="release-4-11-0-added"></a>
config_settings in the configuration file by @gaborbernat. (#3090)Add support for setting build backend config_settings in the configuration file - by gaborbernat. (3090)
Change accepted environment name rule: must be made up of factors defined in configuration or match regex (pypy|py|cython|)((\d(\.\d+(\.\d+)?)?)|\d+)?
<a name="release-4-10-0-added"></a>
(pypy|py|cython|)((\d(\.\d+(\.\d+)?)?)|\d+)?. If an environment name does not match this fail, and if a close match found suggest that to the user. (#3099)<a name="release-4-10-0-fixed"></a>
--override foo+=bar appending syntax will now work correctly when foo wasn't defined in tox.ini. (#3100)Change accepted environment name rule: must be made up of factors defined in configuration or match regex (pypy|py|cython|)((\d(\.\d+(\.\d+)?)?)|\d+)?. If an environment name does not match this fail, and if a close match found suggest that to the user. (3099)
--override foo+=bar appending syntax will now work correctly when foo wasn't defined in tox.ini. (3100)
Disallow command line environments which are not explicitly specified in the config file by @tjsmart.
Disallow command line environments which are not explicitly specified in the config file - by tjsmart. (2858)
--override can now take options in the form of foo+=bar which will append bar to the end of an existing list/dict, rather than replacing it.
<a name="release-4-8-0-added"></a>
--override can now take options in the form of foo+=bar which will append bar to the end of an existing list/dict, rather than replacing it. (#3087)--override can now take options in the form of foo+=bar which will append bar to the end of an existing list/dict, rather than replacing it. (3087)
Make --hashseed default to PYTHONHASHSEED, if defined by @paravoid. The main motivation for this is to able to set the hash seed when building the doc
<a name="release-4-7-0-added"></a>
--hashseed default to PYTHONHASHSEED, if defined by @paravoid. The main motivation for this is to able to set the hash seed when building the documentation with tox -e docs, and thus avoid embedding a random value in the tox documentation for --help. This caused documentation builds to fail to build reproducibly. (#2942)<a name="release-4-7-0-fixed"></a>
<a name="release-4-7-0-documentation"></a>
Make --hashseed default to PYTHONHASHSEED, if defined - by paravoid. The main motivation for this is to able to set the hash seed when building the documentation with tox -e docs, and thus avoid embedding a random value in the tox documentation for --help. This caused documentation builds to fail to build reproducibly. (2942)
Update a regular expression in tests to match the exception message in both Python 3.12 and older. (3065)
Fix broken links - by gaborbernat. (3072)
Fix hang and zombie process on interrupt (CTRL-C).
<a name="release-4-6-4-fixed"></a>
Ensure that get_requires_for_build_wheel is called before prepare_metadata_for_build_wheel, and get_requires_for_build_editable is called before prepa
<a name="release-4-6-3-fixed"></a>
get_requires_for_build_wheel is called before prepare_metadata_for_build_wheel, and get_requires_for_build_editable is called before prepare_metadata_for_build_editable by @abravalheri. (#3043)<a name="release-4-6-3-documentation"></a>
set_env and pass_env config docs. (#3039)Ensure that get_requires_for_build_wheel is called before prepare_metadata_for_build_wheel, and get_requires_for_build_editable is called before prepare_metadata_for_build_editable - by abravalheri. (3043)
Linked environment variable substitutions docs in set_env and pass_env config docs. (3039)
Avoid cache collision between editable wheel build and normal wheel build -- by @f3flight.
<a name="release-4-6-2-fixed"></a>
Avoid cache collision between editable wheel build and normal wheel build -- by f3flight. (3035)
@tibortakacs made their first contribution in #3025
Added --list-dependencies and --no-list-dependencies CLI parameters. If unspecified, defaults to listing when in CI, but not otherwise.
<a name="release-4-6-0-added"></a>
--list-dependencies and --no-list-dependencies CLI parameters. If unspecified, defaults to listing when in CI, but not otherwise. (#3024)Added --list-dependencies and --no-list-dependencies CLI parameters. If unspecified, defaults to listing when in CI, but not otherwise. (3024)
Add 3.12 support by @gaborbernat in https://github.com/tox-dev/tox/pull/2998
<a name="release-4-5-2-added"></a>
<a name="release-4-5-2-fixed"></a>
tox --devenv venv by @asottile in https://github.com/tox-dev/tox/pull/3013Add 3.12 support by @gaborbernat in https://github.com/tox-dev/tox/pull/2998
fix legacy tox --devenv venv by @asottile in https://github.com/tox-dev/tox/pull/3013
Fix legacy devenv by @gaborbernat in https://github.com/tox-dev/tox/pull/3019
Add 3.12 support by gaborbernat in https://github.com/tox-dev/tox/pull/2998
fix legacy tox --devenv venv by asottile in https://github.com/tox-dev/tox/pull/3013
Fix legacy devenv by gaborbernat in https://github.com/tox-dev/tox/pull/3019
🐍 PyPI release 📜 Full Changelog
Fix tox --devenv venv invocation without -e by @asottile.
<a name="release-4-5-1-fixed"></a>
Fix tox --devenv venv invocation without -e - by @asottile . ( #2925 )
Fix tox --devenv venv invocation without -e - by asottile. (2925)
When run with verbosity=1, the per-step timing summaries are suppressed at the end of the run. Thanks to @nedbat at the PyCon 2023 sprints.
When run with verbosity=1, the per-step timing summaries are suppressed at the end of the run. Thanks to nedbat at the PyCon 2023 sprints. (2891)
Add FAQ entry on how to test EOL Python versions by jugmac00. (2989)
Avoid race conditions in tests using the demo_pkg_inline fixture.
<a name="release-4-4-12-fixed"></a>
demo_pkg_inline fixture. (#2985)Avoid race conditions in tests using the demo_pkg_inline fixture. (2985)
Fixed an issue where a tox plugin couldn't change the value of tox_root.
<a name="release-4-4-11-fixed"></a>
tox_root. (#2966)Fixed an issue where a tox plugin couldn't change the value of tox_root. (2966)
Fix issue where work_dir was not correctly including tox_root for test runs.
<a name="release-4-4-10-fixed"></a>
work_dir was not correctly including tox_root for test runs. (#2933)Fix issue where work_dir was not correctly including tox_root for test runs. (2933)
Instead of raising UnicodeDecodeError when command output includes non-utf-8 bytes, tox will now use surrogateescape error handling to convert the unr
<a name="release-4-4-9-fixed"></a>
UnicodeDecodeError when command output includes non-utf-8 bytes, tox will now use surrogateescape error handling to convert the unrecognized bytes to escape sequences according to PEP 383 by @masenf. (#2969)<a name="release-4-4-9-documentation"></a>
installation.rst. (#2964)Instead of raising UnicodeDecodeError when command output includes non-utf-8 bytes, tox will now use surrogateescape error handling to convert the unrecognized bytes to escape sequences according to PEP 383 - by masenf. (2969)
Document running tox within a Docker container. (1035)
Added python version 3.11 to installation.rst. (2964)
tox.ini is now included in source distributions in order to make all tests pass.
tox.ini is now included in source distributions in order to make all tests pass. (2939)
Fix --index-url and --find-links being used together in requirements.txt files. (2959)
docs(config): fix temp_dir default value by @thecesrom in https://github.com/tox-dev/tox/pull/2932
<a name="release-4-4-7-documentation"></a>
docs(config): fix temp_dir default value by thecesrom in https://github.com/tox-dev/tox/pull/2932
docs: set html_last_updated_fmt to format string by paravoid in https://github.com/tox-dev/tox/pull/2937
Plugins are now able to access tox.ini config sections using a custom prefix with the same suffix / name as a tox testenv by @masenf
Plugins are now able to access tox.ini config sections using a custom prefix with the same suffix / name as a tox testenv - by masenf (2926)
Ignore labels when tox will provision a runtime environment (.tox) so that environment configurations which depend on provisioned plugins or specific
<a name="release-4-4-5-fixed"></a>
Ignore labels when tox will provision a runtime environment (.tox) so that environment configurations which depend on provisioned plugins or specific tox versions are not accessed in the outer tox process where the configuration would be invalid - by masenf. (2916)
Forward HOME by default by @gschaffner.
Tox will now expand self-referential extras discovered in package deps to respect local modifications to package metadata. This allows a package extra
<a name="release-4-4-3-fixed"></a>
Tox will now expand self-referential extras discovered in package deps to respect local modifications to package metadata. This allows a package extra to explicitly depend on another package extra, which previously only worked with non-static metadata - by masenf. (2904)
Allow the user configuration file (default /tox/config.ini) to be overridden via the TOX_USER_CONFIG_FILE environment variable. Previously tox was loo
<a name="release-4-4-2-fixed"></a>
<appdir>/tox/config.ini) to be overridden via the TOX_USER_CONFIG_FILE environment variable. Previously tox was looking at the TOX_CONFIG_FILE to override the user configuration, however that environment variable is already used to override the main configuration by @masenf. (#2890)Allow the user configuration file (default <appdir>/tox/config.ini) to be overridden via the TOX_USER_CONFIG_FILE environment variable. Previously tox was looking at the TOX_CONFIG_FILE to override the user configuration, however that environment variable is already used to override the main configuration - by masenf. (2890)
In tox 4.4.0 constrain_package_deps was introduced with a default value of True. This has been changed back to False, which restores the original beha
In tox 4.4.0 constrain_package_deps was introduced with a default value of True. This has been changed back to False, which restores the original behavior of tox 4.3.5 - by masenf. (2897)
Test environments now recognize boolean config keys constrain_package_deps (default=true) and use_frozen_constraints (default=false), which control ho
<a name="release-4-4-0-added"></a>
constrain_package_deps (default=true) and use_frozen_constraints (default=false), which control how tox generates and applies constraints files when performing install_package_deps. If constrain_package_deps is true (default), then tox will write out {env_dir}{/}constraints.txt and pass it to pip during install_package_deps. If use_frozen_constraints is false (default), the constraints will be taken from the specifications listed under deps (and inside any requirements or constraints file referenced in deps). Otherwise, list_dependencies_command (pip freeze) is used to enumerate exact package specifications which will be written to the constraints file. In previous releases, conflicting package dependencies would silently override the deps named in the configuration, resulting in test runs against unexpected dependency versions, particularly when using tox factors to explicitly test with different versions of dependencies by @masenf. (#2386)<a name="release-4-4-0-fixed"></a>
shlex(..., posix=True), even on windows platforms, since non-POSIX mode does not handle escape characters and quoting like a shell would. This improves cross-platform configurations without hacks or esoteric quoting. To make this transition easier, on Windows, the backslash path separator will not treated as an escape character unless it precedes a quote, whitespace, or another backslash character. This allows paths to mostly be written in single or double backslash style. Note that double-backslash will no longer be escaped to a single backslash in substitutions, instead the double backslash will be consumed as part of command splitting, on either posix or windows platforms. In some instances superfluous double or single quote characters may be stripped from arg arrays in ways that do not occur in the default windows cmd.exe shell by @masenf. (#2635)<a name="release-4-4-0-documentation"></a>
list_dependencies_command configuration option is used. (#2883)When building a wheel or editable package with a PEP 517 backend, no longer pass an empty metadata_directory to the backend build_wheel or build_edita
<a name="release-4-3-5-fixed"></a>
wheel or editable package with a PEP 517 backend, no longer pass an empty metadata_directory to the backend build_wheel or build_editable endpoint. Some backends, such as PDM and poetry, will not generate package metadata in the presence of a metadata_directory, even if it is empty. Prior to this change, attempting to install a wheel created by tox using PDM or poetry would return an error like "There is no item named 'my-package.0.1.dist-info/WHEEL' in the archive" by @masenf. (#2880)When building a wheel or editable package with a PEP 517 backend, no longer pass an empty metadata_directory to the backend build_wheel or build_editable endpoint. Some backends, such as PDM and poetry, will not generate package metadata in the presence of a metadata_directory, even if it is empty. Prior to this change, attempting to install a wheel created by tox using PDM or poetry would return an error like "There is no item named 'my-package.0.1.dist-info/WHEEL' in the archive" - by masenf. (2880)
When executing via the provisioning environment (.tox by default), run tox in working directory of the parent process. Prior to this change (from tox
<a name="release-4-3-4-fixed"></a>
.tox by default), run tox in working directory of the parent process. Prior to this change (from tox 4.0.0), the provisioned tox would execute with {tox_root} as the working directory, which breaks when a relative path is passed to -c or --conf and tox is executed in a working directory other than {tox_root} by @masenf. (#2876)When executing via the provisioning environment (.tox by default), run tox in working directory of the parent process. Prior to this change (from tox 4.0.0), the provisioned tox would execute with {tox_root} as the working directory, which breaks when a relative path is passed to -c or --conf and tox is executed in a working directory other than {tox_root} - by masenf. (2876)
The provision environment (.tox) will never inherit from testenv. During provisioning, other test environments are not processed, allowing the use of
The provision environment (.tox) will never inherit from testenv. During provisioning, other test environments are not processed, allowing the use of keys and values that may be registered by later tox version or provisioned plugins - by masenf. (2862)
Fix regression introduced in 4.3.0 which occurred when a substitution expression for an environment variable that had previously been substituted appe
<a name="release-4-3-2-fixed"></a>
Fix regression introduced in 4.3.0 which occurred when a substitution expression for an environment variable that had previously been substituted appears in the ini file after a substitution expression for a different environment variable. This situation erroneously resulted in an exception about "circular chain between set" of those variables - by masenf. (2869)
Fix regression introduced in 4.3.0 by expanding substitution expressions ({...}) that result from a previous subsitution's replacement value (up to 10
<a name="release-4-3-1-fixed"></a>
{...}) that result from a previous subsitution's replacement value (up to 100 times). Note that recursive expansion is strictly depth-first; no replacement value will ever affect adjacent characters nor will expansion ever occur over the result of more than one replacement by @masenf. (#2863)Fix regression introduced in 4.3.0 by expanding substitution expressions ({...}) that result from a previous subsitution's replacement value (up to 100 times). Note that recursive expansion is strictly depth-first; no replacement value will ever affect adjacent characters nor will expansion ever occur over the result of more than one replacement - by masenf. (2863)
Rewrite substitution replacement parser by @masenf
<a name="release-4-3-0-added"></a>
\ acts as a proper escape for \ in ini-style substitutionsfind_replace_part is removed from tox.config.loader.ini.replacetox.config.loader.ini.replace: - find_replace_expr - MatchArg - MatchError - MatchExpression - Note: the API for replace itself is unchanged. (#2732)Rewrite substitution replacement parser - by masenf
\ acts as a proper escape for \ in ini-style substitutions
The resulting value of a substitution is no longer reprocessed in the context of the broader string. (Prior to this change, ini-values were repeatedly re-substituted until the expression no longer had modifications)
Migrate and update "Substitutions" section of Configuration page from v3 docs.
find_replace_part is removed from tox.config.loader.ini.replace
New names exported from tox.config.loader.ini.replace: - find_replace_expr - MatchArg - MatchError - MatchExpression - Note: the API for replace itself is unchanged. (2732)
Improved documentation for factors and test env names - by stephenfin. (2852)
Allow using package names with env markers for pip's --no-binary and --only-binary options by @q0w.
Allow using package names with env markers for pip's --no-binary and --only-binary options - by q0w. (2814)
A testenv with multiple factors, one of which conflicts with a base_python setting in tox.ini, will now use the correct Python interpreter version by
<a name="release-4-2-7-fixed"></a>
base_python setting in tox.ini, will now use the correct Python interpreter version by @stephenfin. (#2838)wheel as requirement for the tests, as some of the tests error without it. (#2843)py3.10.1), build architecture (e.g. pypy3-64) or do not define a py prefix or other supported prefix (e.g. 3.10). These complex factors were initially supported with the release of tox 4.0 but has proven complicated to support. Instead, the simple factors supported by tox 3 e.g. (py310, pypy3) or period-separated equivalent (py3.10) introduced in tox 4 should be used. Users who wish to specify more specific Python version information should configure the base_python setting by @stephenfin. (#2848)Handle properly pip --no-binary / --only-binary options in requirements.txt format files.
<a name="release-4-2-6-fixed"></a>
--no-binary / --only-binary options in requirements.txt format files. (#2814)Handle properly pip --no-binary / --only-binary options in requirements.txt format files. (2814)
The combination of usedevelop = true and --skip-missing-interpreters=false will no longer fail for environments that were *not* invoked by @stephenfin
<a name="release-4-2-5-fixed"></a>
usedevelop = true and --skip-missing-interpreters=false will no longer fail for environments that were not invoked by @stephenfin. (#2811)use_develop = true is set and an unsupported interpreter version is requested by @stephenfin. (#2826)The combination of usedevelop = true and --skip-missing-interpreters=false will no longer fail for environments that were not invoked - by stephenfin. (2811)
Fix an attribute error when use_develop = true is set and an unsupported interpreter version is requested - by stephenfin. (2826)
tox returns a non-zero error code if all envs are skipped. It will now correctly do this if only a single env was requested and this was skipped - by stephenfin. (2827)
Setting [testenv] basepython = python3 will no longer override the Python interpreter version requested by a factor, such as py311 by @stephenfin.
<a name="release-4-2-4-fixed"></a>
[testenv] basepython = python3 will no longer override the Python interpreter version requested by a factor, such as py311 by @stephenfin. (#2754)Setting [testenv] basepython = python3 will no longer override the Python interpreter version requested by a factor, such as py311 - by stephenfin. (2754)
Also accept tab after colon before factor filter expansion - by pdecat. (2823)
devenv does not respect the specified path when the package is a wheel file by @gaborbernat.
<a name="release-4-2-3-fixed"></a>
devenv does not respect the specified path when the package is a wheel file by @gaborbernat. (#2815)devenv does not respect the specified path when the package is a wheel file - by gaborbernat. (2815)
Require space after colon before factor filter expansion, unless it is the last character of the line - by pdecat. (2822)
Add CC, CFLAGS, CCSHARED, CXX, CPPFLAGS, LDFLAGS, PKG_CONFIG and PKG_CONFIG_SYSROOT_DIR to the default passed through environment variables list as th
<a name="release-4-2-2-fixed"></a>
CC, CFLAGS, CCSHARED, CXX, CPPFLAGS, LDFLAGS, PKG_CONFIG and PKG_CONFIG_SYSROOT_DIR to the default passed through environment variables list as these are needed for building various C-extensions by @gaborbernat. (#2818)Add CC, CFLAGS, CCSHARED, CXX, CPPFLAGS, LDFLAGS, PKG_CONFIG and PKG_CONFIG_SYSROOT_DIR to the default passed through environment variables list as these are needed for building various C-extensions - by gaborbernat. (2818)
Fix extracting extras from markers with more than 2 extras in an or chain by @dconathan.
<a name="release-4-2-1-fixed"></a>
Fix extracting extras from markers with more than 2 extras in an or chain - by dconathan. (2791)
One column per quarter.