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 5 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.
Allow { and } in default of {envdefault}. by @jayvdb #1502
<a name="release-3-21-0-added"></a>
<a name="release-3-21-0-fixed"></a>
congratulations message that appears when a KeyboardInterrupt occurs during package installation. by @gnikonorov #1453platform support for install_command. by @jayvdb #1464{} and require {: is only followed by }. by @jayvdb #1711MissingSubstitution on access of broken ini setting. by @jayvdb #1716<a name="release-3-21-0-documentation"></a>
platform setting. by @prakhargurunani #1144indexserver in documentation with environment variables by @ziima. #1357passenv environment setting is case insensitive. by @gnikonorov #1534Your coding agent can read these notes before it upgrades. Set up the MCP server →
Allow { and } in default of {env:key:default}. - by jayvdb #1502
Allow {posargs} in setenv. - by jayvdb #1695
Allow {/} to refer to os.sep. - by jayvdb #1700
Make parsing [testenv] sections in setup.cfg official. - by mauvilsa #1727
Relax importlib requirement to allow 3.0.0 or any newer version - by pkolbus #1763
Fix the false congratulations message that appears when a KeyboardInterrupt occurs during package installation. - by gnikonorov #1453
Fix platform support for install_command. - by jayvdb #1464
Fixed regression in v3.20.0 that caused escaped curly braces in setenv to break usage of the variable elsewhere in tox.ini. - by jayvdb #1690
Prevent {} and require {: is only followed by }. - by jayvdb #1711
Raise MissingSubstitution on access of broken ini setting. - by jayvdb #1716
Document more info about using platform setting. - by prakhargurunani #1144
Replace indexserver in documentation with environment variables - by ziima. #1357
Document that the passenv environment setting is case insensitive. - by gnikonorov #1534
Relax importlib requirement to allow version\<3 by @usamasadiq #1682
<a name="release-3-20-1-fixed"></a>
Relax importlib requirement to allow version<3 - by @usamasadiq #1682
Support for comments within setenv and environment files via the files| prefix. by @gaborbernat #1667
<a name="release-3-20-0-added"></a>
setenv and environment files via the files| prefix. by @gaborbernat #1667<a name="release-3-20-0-fixed"></a>
get-build-requires. by @nizox #1654Support for comments within setenv and environment files via the files| prefix. - by gaborbernat #1667
Allow hyphens and empty factors in generative section name. - by tyagdit #1636
Support for PEP517 in-tree build backend-path key in get-build-requires. - by nizox #1654
Allow escaping curly braces in setenv. - by mkenigs #1656
Implement support for building projects having PEP 517 backend-path setting by @webknjaz #1575
<a name="release-3-19-0-added"></a>
backend-path setting by @webknjaz #1575tox --devenv by @hroncok #1643<a name="release-3-19-0-fixed"></a>
<a name="release-3-19-0-documentation"></a>
Implement support for building projects having PEP 517#in-tree-build-backends backend-path setting - by @webknjaz #1575
Don’t require a tox config file for tox --devenv - by @hroncok #1643
skip setup.cfg if it has no tox:tox namespace - by @hroncok #1045
Fixed grammar in top-level documentation - by @tfurf #1631
Implement support for building projects having :PEP:`517#in-tree-build-backends` backend-path setting - by webknjaz #1575
Don't require a tox config file for tox --devenv - by hroncok #1643
skip setup.cfg if it has no tox:tox namespace - by hroncok #1045
Fixed grammar in top-level documentation - by tfurf #1631
Fix TypeError when using isolated_build with backends that are not submodules (e.g. maturin) #1629
<a name="release-3-18-1-fixed"></a>
TypeError when using isolated_build with backends that are not submodules (e.g. maturin) #1629Fix TypeError when using isolated_build with backends that are not submodules (e.g. maturin) #1629
Add allowlist_externals alias to whitelist_externals (whitelist_externals is now deprecated). by @dajose #1491
Add allowlist_externals alias to whitelist_externals (whitelist_externals is now deprecated). - by dajose #1491
Fix tests when the HOSTNAME environment variable is set, but empty string by @hroncok #1616
The long arguments --verbose and --quiet (rather than only their short forms, -v and -q) are now accepted. #1612
<a name="release-3-17-0-added"></a>
--verbose and --quiet (rather than only their short forms, -v and -q) are now accepted. #1612ResultLog now prefers HOSTNAME environment variable value (if set) over the full qualified domain name of localhost. This makes it possible to disable an undesired DNS lookup, which happened on all tox invocations, including trivial ones by @hroncok #1615<a name="release-3-17-0-documentation"></a>
The long arguments --verbose and --quiet (rather than only their short forms, -v and -q) are now accepted. #1612
The ResultLog now prefers HOSTNAME environment variable value (if set) over the full qualified domain name of localhost. This makes it possible to disable an undesired DNS lookup, which happened on all tox invocations, including trivial ones - by hroncok #1615
Update packaging information for Flit. #1613
Fixed the support for using {temp_dir} in tox.ini by @webknjaz #1609
Allow skipping the package and installation step when passing the --skip-pkg-install. This should be used in pair with the --notest, so you can separa
<a name="release-3-16-0-added"></a>
--skip-pkg-install. This should be used in pair with the --notest, so you can separate environment setup and test run: .. code-block:: console tox -e py --notest tox -e py --skip-pkg-install by @gaborbernat. #1605<a name="release-3-16-0-performance"></a>
Allow skipping the package and installation step when passing the --skip-pkg-install. This should be used in pair with the --notest, so you can separate environment setup and test run: .. code-block:: console tox -e py --notest tox -e py --skip-pkg-install by gaborbernat. #1605
Improve config parsing performance by precompiling commonly used regular expressions - by brettlangdon #1603
Allow to run the tests with pip 19.3.1 once again while preserving the ability to use pip 20.1 by @hroncok #1594
<a name="release-3-15-2-added"></a>
<a name="release-3-15-2-fixed"></a>
Script folder instead of bin. by @gaborbernat #1597Allow to run the tests with pip 19.3.1 once again while preserving the ability to use pip 20.1 - by hroncok #1594
Add an option to allow a process to suicide before sending the SIGTERM. - by jhesketh #1497
PyPy 7.3.1 on Windows uses the Script folder instead of bin. - by gaborbernat #1597
tox --showconfig no longer tries to interpolate '%' signs. #1585
<a name="release-3-15-1-fixed"></a>
tox --showconfig no longer tries to interpolate '%' signs. #1585tox --showconfig no longer tries to interpolate ‘%’ signs. #1585
Allow parallel mode without arguments. by @ssbarnea #1418
<a name="release-3-15-0-added"></a>
<a name="release-3-15-0-fixed"></a>
PATH via setenv by @aklajnert. #1423<a name="release-3-15-0-documentation"></a>
Allow parallel mode without arguments. - by ssbarnea #1418
Allow generative section name expansion. - by bruchar1 #1545
default to passing the env var PIP_EXTRA_INDEX_URL by georgealton. #1561
Respect attempts to change PATH via setenv - by aklajnert. #1423
Fix parsing of architecture in python interpreter name. - by bruchar1 #1542
Prevent exception when command is empty. - by bruchar1 #1544
Fix irrelevant Error message for invalid argument when running outside a directory with tox support files by nkpro2000sr. #1547
Improve documentation about config by adding tox environment description at start - by stephenfin. #1573
Exclude virtualenv dependency versions with known regressions (20.0.[0-7]) by @webknjaz. #1537
<a name="release-3-14-6-fixed"></a>
tox -h and tox --hi shows an error when run outside a directory with tox support files by @nkpro2000sr. #1539tox -l for a tox.ini file that does not contain an envlist definition. by @jquast. #1343Exclude virtualenv dependency versions with known regressions (20.0.[0-7]) - by webknjaz. #1537
Fix tox -h and tox --hi shows an error when run outside a directory with tox support files by nkpro2000sr. #1539
Fix ValueError on tox -l for a tox.ini file that does not contain an envlist definition. - by jquast. #1343
Add --discover (fallback to TOX_DISCOVER environment variable via path separator) to inject python executables to try as first step of a discovery - n
<a name="release-3-14-5-added"></a>
--discover (fallback to TOX_DISCOVER environment variable via path separator) to inject python executables to try as first step of a discovery - note the executable still needs to match the environment by @gaborbernat. #1526Add --discover (fallback to TOX_DISCOVER environment variable via path separator) to inject python executables to try as first step of a discovery - note the executable still needs to match the environment by gaborbernat. #1526
Add interrupt_timeout and terminate_timeout that configure delay between SIGINT, SIGTERM and SIGKILL when tox is interrupted. by @sileht #1493
<a name="release-3-14-4-added"></a>
interrupt_timeout and terminate_timeout that configure delay between SIGINT, SIGTERM and SIGKILL when tox is interrupted. by @sileht #1493HTTP_PROXY, HTTPS_PROXY and NO_PROXY to default passenv. by @pfmoore #1498<a name="release-3-14-4-fixed"></a>
Add interrupt_timeout and terminate_timeout that configure delay between SIGINT, SIGTERM and SIGKILL when tox is interrupted. - by sileht #1493
Add HTTP_PROXY, HTTPS_PROXY and NO_PROXY to default passenv. - by pfmoore #1498
Bump minimal six version needed to avoid using one incompatible with newer virtualenv. - by ssbarnea #1519
Avoid pypy test failure due to undefined printout var. - by ssbarnea #1521
Relax importlib requirement to allow either version 0 or 1 by @chyzzqo2 #1476
<a name="release-3-14-3-fixed"></a>
<a name="release-3-14-3-packaging"></a>
Relax importlib requirement to allow either version 0 or 1 - by chyzzqo2 #1476
Clarify legacy setup.py error message: python projects should commit to a strong consistency of message regarding packaging. We no-longer tell people to add a setup.py to their already configured pep-517 project, otherwise it could imply that pyproject.toml isn't as well supported and recommended as it truly is - by graingert #1478
Fix fallback to global configuration when running in Jenkins. by @daneah #1428
<a name="release-3-14-2-fixed"></a>
<a name="release-3-14-2-performance"></a>
<a name="release-3-14-2-packaging"></a>
Fix fallback to global configuration when running in Jenkins. - by daneah #1428
Fix coloring on windows: colorama is a dep. - by 1138-4EB #1471
improve performance with internal lookup of Python version information - by blueyed #1462
Use latest version of importlib_metadata package - by kammala #1472
Mark poetry related tests as xfail since its dependency pyrsistent won't install in ci due to missing wheels/build deps. - by RonnyPfannschmidt #1474
Fix provisioning from a pyvenv interpreter. — by @kentzo #1452 Deprecations (removal in next major release)
<a name="release-3-14-1-fixed"></a>
CURL_CA_BUNDLE, REQUESTS_CA_BUNDLE, SSL_CERT_FILE to the default passenv values. by @ssbarnea #1437_TOX_PARALLEL_ENV) from the variable that informs the tests that tox is running in parallel mode (TOX_PARALLEL_ENV). — by @hroncok #14443.4 is no longer supported. — by @gaborbernat #1456fix reporting of exiting due to (real) signals - by blueyed #1401
Bump minimal virtualenv to 16.0.0 to improve own transitive deps handling in some ancient envs. — by webknjaz #1429
Adds CURL_CA_BUNDLE, REQUESTS_CA_BUNDLE, SSL_CERT_FILE to the default passenv values. - by ssbarnea #1437
Fix nested tox execution in the parallel mode by separating the environment variable that let's tox know it is invoked in the parallel mode (_TOX_PARALLEL_ENV) from the variable that informs the tests that tox is running in parallel mode (TOX_PARALLEL_ENV). — by hroncok #1444
Fix provisioning from a pyvenv interpreter. — by kentzo #1452 Deprecations (removal in next major release)
Python 3.4 is no longer supported. — by gaborbernat #1456
Add support for minor versions with multiple digits tox -e py310 works for python3.10 by @asottile #1374
<a name="release-3-14-0-added"></a>
tox -e py310 works for python3.10 by @asottile #1374md5 hashing algorithm by @asottile #1384<a name="release-3-14-0-changes"></a>
.github/PULL_REQUEST_TEMPLATE.md — by @webknjaz #1363importlib_metadata backport with importlib.metadata from the standard library on Python 3.8+ by @hroncok #1367docs/changelog/ directory view on GitHub — by @webknjaz #1370<a name="release-3-14-0-fixed"></a>
PythonSpec detection of python3.10 by @asottile #1374py## factors by @asottile #1377current_tox_py for pypy / pypy3 by @asottile #1378requires list by @asottile #1380.tox-config1 (the marker file created by tox) by @asottile #1383<a name="release-3-14-0-documentation"></a>
Add support for minor versions with multiple digits tox -e py310 works for python3.10 - by asottile #1374
Remove dependence on md5 hashing algorithm - by asottile #1384
Fix relative URLs to files in the repo in .github/PULL_REQUEST_TEMPLATE.md — by webknjaz #1363
Replace importlib_metadata backport with importlib.metadata from the standard library on Python 3.8+ - by hroncok #1367
Render the change fragment help on the docs/changelog/ directory view on GitHub — by webknjaz #1370
Fix PythonSpec detection of python3.10 - by asottile #1374
Fix regression failing to detect future and past py## factors - by asottile #1377
Fix current_tox_py for pypy / pypy3 - by asottile #1378
Honor environment markers in requires list - by asottile #1380
improve recreate check by allowing directories containing .tox-config1 (the marker file created by tox) - by asottile #1383
Recognize correctly interpreters that have suffixes (like python3.7-dbg). #1415
clarify behavior if recreate is set to false - by PJCampi #1399
on venv cleanup: add explicit check for pypy venv to make it possible to recreate it by @obestwalter #1355
<a name="release-3-13-2-fixed"></a>
requires cause infinite provisioning loop by @gaborbernat #1359on venv cleanup: add explicit check for pypy venv to make it possible to recreate it - by obestwalter #1355
non canonical names within requires cause infinite provisioning loop - by gaborbernat #1359
Fix isolated build double-requirement by @asottile. #1349
<a name="release-3-13-1-fixed"></a>
Replace pkg_resources with importlib_metadata for speed by @asottile. #1324
<a name="release-3-13-0-added"></a>
pkg_resources with importlib_metadata for speed by @asottile. #1324--devenv ENVDIR option for creating development environments from [testenv] configurations by @asottile. #1326envdir if it doesn't look like a virtualenv by @asottile. #1340<a name="release-3-13-0-fixed"></a>
Replace pkg_resources with importlib_metadata for speed - by asottile. #1324
Add the --devenv ENVDIR option for creating development environments from [testenv] configurations - by asottile. #1326
Refuse to delete envdir if it doesn't look like a virtualenv - by asottile. #1340
tox used Windows shell rules on non-Windows platforms when transforming positional arguments to a string - by barneygale. #1336
Ensure TOX_WORK_DIR is a native string in os.environ by @asottile. #1313
Ensure TOX_WORK_DIR is a native string in os.environ - by asottile. #1313
Fix import and usage of winreg for python2.7 on windows - by asottile. #1315
Fix Windows selects incorrect spec on first discovery - by gaborbernat #1317
Adding TOX_PARALLEL_NO_SPINNER environment variable to disable the spinner in parallel mode for the purposes of clean output when using CI tools by @z
<a name="release-3-12-0-added"></a>
TOX_PARALLEL_NO_SPINNER environment variable to disable the spinner in parallel mode for the purposes of clean output when using CI tools by @zeroshift #1184<a name="release-3-12-0-fixed"></a>
--parallel with --result-json the test results are now included the same way as with serial runs by @fschulze #1295py -0p is not stable yet and varies depending on various edge cases. Instead now we read the interpreter values directly from registry via PEP-514 by @gaborbernat. #1306Adding TOX_PARALLEL_NO_SPINNER environment variable to disable the spinner in parallel mode for the purposes of clean output when using CI tools - by zeroshift #1184
When using --parallel with --result-json the test results are now included the same way as with serial runs - by fschulze #1295
Turns out the output of the py -0p is not stable yet and varies depending on various edge cases. Instead now we read the interpreter values directly from registry via PEP-514 - by gaborbernat. #1306
When creating virtual environments we no longer ask the python to tell its path, but rather use the discovered path. #1301
<a name="release-3-11-1-fixed"></a>
When creating virtual environments we no longer ask the python to tell its path, but rather use the discovered path. #1301
now fully generated via the config parser, so anyone can load it by using the built-in python config parser
<a name="release-3-11-0-added"></a>
--showconfig overhaul:
tox section contains all configuration data from configtox section contains a host_python key detailing the path of the host pythontox:version section contains the versions of all packages tox depends on with their version-l now allows only listing default target envs-e cli flag or the TOXENV environment variable, in this case the tox and tox:version section is only shown if at least one verbosity flag is passed this should help inspecting the options. #1298Virtual environments created now no longer upgrade pip/wheel/setuptools to the latest version. Instead the start packages after virtualenv creation no
<a name="release-3-10-0-added"></a>
python3.7, python3) matches or the base python is an absolute path, use that. - Third, check if the the canonical name without version matches (e.g. python, pypy) matches.py.exe to list registered interpreters and any of those match. - Third, check if the the canonical name (e.g. python3.7, python3) matches or the base python is an absolute path, use that. - Fourth, check if the the canonical name without version matches (e.g. python, pypy) matches. - Finally, check for known locations (c:\python{major}{minor}\python.exe). tox environment configuration generation is now done in parallel (to alleviate the slowdown due to extra checks). #1290<a name="release-3-10-0-fixed"></a>
tox -l command: do not allow setting the TOXENV or the -e flag to override the listed default environment variables, they still show up under extra if non defined target by @gaborbernat #720Allow having inline comments in deps — by @webknjaz #1262
<a name="release-3-9-0-added"></a>
<a name="release-3-9-0-fixed"></a>
Allow having inline comments in deps — by @webknjaz #1262
Fix congratulations when using ^C during virtualenv creation - by @asottile #1257
Allow having inline comments in deps — by webknjaz #1262
Fix congratulations when using ^C during virtualenv creation - by asottile #1257
parallel_show_output does not work with tox 3.8 #1245
the isolated build env now ignores sitepackages, deps and description as these do not make sense by @gaborbernat #1239
<a name="release-3-8-5-fixed"></a>
sitepackages, deps and description as these do not make sense by @gaborbernat #1239the isolated build env now ignores sitepackages, deps and description as these do not make sense - by gaborbernat #1239
Do not print timings with more than 3 decimal digits on Python 3 - by mgedmin. #1241
Fix sdist creation on python2.x when there is non-ascii output. #1234
Fix sdist creation on python2.x when there is non-ascii output. #1234
fix typos in isolated.py that made it impossible to install package with requirements in pyproject.toml - by unmade #1236
don't crash when version information is not available for a proposed base python by @gaborbernat #1227
<a name="release-3-8-3-fixed"></a>
don't crash when version information is not available for a proposed base python - by gaborbernat #1227
Do not print exception traceback when the provisioned tox fails - by gaborbernat #1228
using -v and -e connected (as -ve) fails by @gaborbernat #1218
<a name="release-3-8-2-fixed"></a>
PYTHONPATH), and action.popen no longer returns the command identifier information from within the logs. No public facing changes. #1222UnicodeEncodeError by @gaborbernat #1223using -v and -e connected (as -ve) fails - by gaborbernat #1218
Changes to the plugin tester module (cmd no longer sets PYTHONPATH), and action.popen no longer returns the command identifier information from within the logs. No public facing changes. #1222
Spinner fails in CI on UnicodeEncodeError - by gaborbernat #1223
The -eALL command line argument now expands the envlist key and includes all its environment. #1155
<a name="release-3-8-1-fixed"></a>
-eALL command line argument now expands the envlist key and includes all its environment. #1155--result-json puts the command into setup section instead of test (pre and post commands are now also correctly put into the commands section) by @gaborbernat #1210setup.cfg encoding to UTF-8 as it contains Unicode characters. #1212The -eALL command line argument now expands the envlist key and includes all its environment. #1155
Isolated build environment dependency overrides were not taken in consideration (and such it inherited the deps from the testenv section) - by gaborbernat #1207
--result-json puts the command into setup section instead of test (pre and post commands are now also correctly put into the commands section) - by gaborbernat #1210
Set setup.cfg encoding to UTF-8 as it contains Unicode characters. #1212
Fix tox CI, better error reporting when locating via the py fails - by gaborbernat #1215
tox now auto-provisions itself if needed (see auto-provisioning). Plugins or minimum version of tox no longer need to be manually satisfied by the use
<a name="release-3-8-0-added"></a>
auto-provisioning). Plugins or minimum version of tox no longer need to be manually satisfied by the user, increasing their ease of use. by @gaborbernat #998TOX_PARALLEL_ENV environment variable, set to the current running tox environment name, only when running in parallel mode. by @gaborbernat #1139--result-json by @gaborbernat #1159sys.platform with platform mismatch by @blueyed. #1176TOX_REPORTER_TIMESTAMP to 1 will enable showing for each output line its delta since the tox startup. This can be especially handy when debugging parallel runs.- by @gaborbernat #1203<a name="release-3-8-0-fixed"></a>
py2 and py3 with a specific basepython will no longer raise a warning unless the major version conflicts by @demosdemon. #1153tox -e unknown when tox.ini declares envlist. by @medmunds #1160toxworkdir by @blueyed. #1169ResourceWarning: unclosed file in Action by @BoboTiG. #1179--parallel and having environments with lots of output by @asottile. #1183--parallel and -p when using posargs by @timdaman #1192<a name="release-3-8-0-documentation"></a>
poetry examples to packaging by @gaborbernat #1163tox now auto-provisions itself if needed (see auto-provisioning). Plugins or minimum version of tox no longer need to be manually satisfied by the user, increasing their ease of use. - by gaborbernat #998
tox will inject the TOX_PARALLEL_ENV environment variable, set to the current running tox environment name, only when running in parallel mode. - by gaborbernat #1139
Parallel children now save their output to a disk logfile - by gaborbernat #1143
Parallel children now are added to --result-json - by gaborbernat #1159
Display pattern and sys.platform with platform mismatch - by blueyed. #1176
Setting the environment variable TOX_REPORTER_TIMESTAMP to 1 will enable showing for each output line its delta since the tox startup. This can be especially handy when debugging parallel runs.- by gaborbernat #1203
In a posix shell, setting the PATH environment variable to an empty value is equivalent to not setting it at all; therefore we no longer if the user sets PYTHONPATH an empty string on python 3.4 or later - by gaborbernat. #1092
Fixed bug of children process calls logs clashing (log already exists) - by gaborbernat #1137
Interpreter discovery and virtualenv creation process calls that failed will now print out on the screen their output (via the logfile we automatically save) - by gaborbernat #1150
Using py2 and py3 with a specific basepython will no longer raise a warning unless the major version conflicts - by demosdemon. #1153
Fix missing error for tox -e unknown when tox.ini declares envlist. - by medmunds #1160
Resolve symlinks with toxworkdir - by blueyed. #1169
Interrupting a tox call (e.g. via CTRL+C) now will ensure that spawn child processes (test calls, interpreter discovery, parallel sub-instances, provisioned hosts) are correctly stopped before exiting (via the pattern of INTERRUPT - 300 ms, TERMINATE - 200 ms, KILL signals) - by gaborbernat #1172
Fix a ResourceWarning: unclosed file in Action - by BoboTiG. #1179
Fix deadlock when using --parallel and having environments with lots of output - by asottile. #1183
Removed code that sometimes caused a difference in results between --parallel and -p when using posargs - by timdaman #1192
Add a poetry examples to packaging - by gaborbernat #1163
Parallel mode added (alternative to detox which is being deprecated), for more details see parallel_mode by @gaborbernat. #439
<a name="release-3-7-0-added"></a>
detox which is being deprecated), for more details see parallel_mode by @gaborbernat. #439-s for --skip-missing-interpreters by @evandrocoan #1119 Deprecations (removal in next major release)<a name="release-3-7-0-documentation"></a>
Parallel mode added (alternative to detox which is being deprecated), for more details see parallel_mode - by gaborbernat. #439
Added command line shortcut -s for --skip-missing-interpreters - by evandrocoan #1119 Deprecations (removal in next major release)
Whitelisting of externals will be mandatory in tox 4: issue a deprecation warning as part of the already existing warning - by obestwalter #1129
Clarify explanations in examples and avoid unsupported end line comments - by obestwalter #1110
Set to PULL_REQUEST_TEMPLATE.md use relative instead of absolute URLs - by evandrocoan Fixed PULL_REQUEST_TEMPLATE.md path for changelog/examples.rst to docs/changelog/examples.rst - by evandrocoan #1120
if the packaging phase successfully builds a package set it as environment variable under TOX_PACKAGE (useful to make assertions on the built package
<a name="release-3-6-1-added"></a>
TOX_PACKAGE (useful to make assertions on the built package itself, instead of just how it ends up after installation) by @gaborbernat (#1081)if the packaging phase successfully builds a package set it as environment variable under TOX_PACKAGE (useful to make assertions on the built package itself, instead of just how it ends up after installation) - by gaborbernat (#1081)
On windows, check sys.executable before others for interpreter version lookup. This matches what happens on non-windows.
<a name="release-3-6-0-fixed"></a>
sys.executable before others for interpreter version lookup. This matches what happens on non-windows. (#1087){posargs} substitution for absolute paths. (#1095)tox --notest when setup fails. (#1097)<a name="release-3-6-0-documentation"></a>
<a name="release-3-6-0-packaging"></a>
On windows, check sys.executable before others for interpreter version lookup. This matches what happens on non-windows. (#1087)
Don't rewrite {posargs} substitution for absolute paths. (#1095)
Correctly fail tox --notest when setup fails. (#1097)
Update Contributor Covenant URL to use https:// - by jdufresne. (#1082)
Correct the capitalization of PyPI throughout the documentation - by jdufresne. (#1084)
Link to related projects (Invoke and Nox) from the documentation - by theacodes. (#1088)
Include the license file in the wheel distribution - by jdufresne. (#1083)
Fix bug with incorrectly defactorized dependencies by @bartsanchez
<a name="release-3-5-3-fixed"></a>
egg_info folders that pkg_resources does; this makes it possible for hyphenated names to use the develop-inst-noop optimization (cf. 910), which previously only worked with non-hyphenated egg names by @hashbrowncipher (#1051)setup.py --name emitted extra information to stderr, tox would capture it and consider it part of the project's name; now, emissions to stderr are printed to the console by @hashbrowncipher (#1052)jython interpreter, note to create jython envs one needs virtualenv > 16.0 which will be released later @gaborbernat (#1073)<a name="release-3-5-3-documentation"></a>
commands_pre/commands_post support. (#1071)Fix bug with incorrectly defactorized dependencies - by bartsanchez (#706)
do the same transformation to egg_info folders that pkg_resources does; this makes it possible for hyphenated names to use the develop-inst-noop optimization (cf. 910), which previously only worked with non-hyphenated egg names - by hashbrowncipher (#1051)
previously, if a project's setup.py --name emitted extra information to stderr, tox would capture it and consider it part of the project's name; now, emissions to stderr are printed to the console - by hashbrowncipher (#1052)
change the way we acquire interpreter information to make it compatible with jython interpreter, note to create jython envs one needs virtualenv > 16.0 which will be released later gaborbernat (#1073)
document substitutions with additional content starting with a space cannot be alone on a line inside the ini file - by gaborbernat (#437)
change the spelling of a single word from constrains to the proper word, constraints - by metasyn (#1061)
Mention the minimum version required for commands_pre/commands_post support. (#1071)
level three verbosity (-vvv) show the packaging output by @gaborbernat
<a name="release-3-5-2-added"></a>
-vvv) show the packaging output by @gaborbernat (#1047)<a name="release-3-5-2-fixed"></a>
level three verbosity (-vvv) show the packaging output - by gaborbernat (#1047)
session packages are now put inside a numbered directory (instead of prefix numbering it, because pip fails when wheels are not named according to PEP-491, and prefix numbering messes with this) - by gaborbernat (#1042)
fix regression with 3.5.0: specifying --installpkg raises AttributeError: 'str' object has no attribute 'basename'
<a name="release-3-5-1-fixed"></a>
3.5.0: specifying --installpkg raises AttributeError: 'str' object has no attribute 'basename' (#1042)fix regression with 3.5.0: specifying --installpkg raises AttributeError: 'str' object has no attribute 'basename' (#1042)
…now on by default (--parallel--safe-build is now deprecated) by @gaborbernat
<a name="release-3-5-0-added"></a>
temp_dir folder configuration (defaults to {toxworkdir}/.tmp) that contains tox temporary files. Package builds now create a hard link (if possible, otherwise copy - notably in case of Windows Python 2.7) to the built file, and feed that file downstream (e.g. for pip to install it). The hard link is removed at the end of the run (what it points though is kept inside distdir). This ensures that a tox session operates on the same package it built, even if a parallel tox run builds another version. Note distdir will contain only the last built package in such cases. by @gaborbernat (#1026)<a name="release-3-5-0-fixed"></a>
--parallel--safe-build, instead of mangling with the file paths now uses a lock to make the package build operation thread safe and is now on by default (--parallel--safe-build is now deprecated) by @gaborbernat (#1026)<a name="release-3-5-0-documentation"></a>
recreate) by @gaborbernat (#93)--help how to disable colorized output via the PY_COLORS operating system environment variable by @gaborbernat (#163)Added temp_dir folder configuration (defaults to {toxworkdir}/.tmp) that contains tox temporary files. Package builds now create a hard link (if possible, otherwise copy - notably in case of Windows Python 2.7) to the built file, and feed that file downstream (e.g. for pip to install it). The hard link is removed at the end of the run (what it points though is kept inside distdir). This ensures that a tox session operates on the same package it built, even if a parallel tox run builds another version. Note distdir will contain only the last built package in such cases. by gaborbernat (#1026)
intermittent failures with --parallel--safe-build, instead of mangling with the file paths now uses a lock to make the package build operation thread safe and is now on by default (--parallel--safe-build is now deprecated) - by gaborbernat (#1026)
document tox environment recreate rules (recreate) - by gaborbernat (#93)
document inside the --help how to disable colorized output via the PY_COLORS operating system environment variable - by gaborbernat (#163)
document all global tox flags and a more concise format to express default and type - by gaborbernat (#683)
document command line interface under the config section cli - by gaborbernat (#829)
add commands_pre and commands_post that run before and after running the commands (setup runs always, commands only if setup succeeds, teardown always
<a name="release-3-4-0-added"></a>
commands_pre and commands_post that run before and after running the commands (setup runs always, commands only if setup succeeds, teardown always - all run until the first failing command) by @gaborbernat (#167)pyproject.toml config support initially by just inline the tox.ini under tool.tox.legacy_tox_ini key; config source priority order is pyproject.toml, tox.ini and then setup.cfg by @gaborbernat (#814)TOX_SKIP_ENV to filter out tox environment names from the run list (set by envlist) by @gaborbernat (#824)PIP_USER=0 (do not install into the user site package, but inside the virtual environment created) and PIP_NO_DEPS=0 (installing without dependencies can cause broken package installations) inside tox by @gaborbernat (#838)TOX_WORK_DIR env var is set to the tox work directory, TOX_ENV_NAME is set to the current running tox environment name, TOX_ENV_DIR is set to the current tox environments working dir by @gaborbernat (#847)--skip-missing-interpreters cli flag by @gaborbernat (#903){tty} substitution by @gaborbernat (#947)-vv will print out why a virtual environment is re-created whenever this operation is triggered by @gaborbernat (#1004)<a name="release-3-4-0-fixed"></a>
--exists-action w to default pip flags to handle better VCS dependencies (pip documentation on this) by @gaborbernat (#503)ignore_basepython_conflict flag by @gaborbernat (#908)<a name="release-3-4-0-documentation"></a>
python and pip refer to the virtual environments executable by @gaborbernat (#305)setup.cfg tox configuration needs to be inside the tox:tox namespace by @gaborbernat (#545)add commands_pre and commands_post that run before and after running the commands (setup runs always, commands only if setup succeeds, teardown always - all run until the first failing command) - by gaborbernat (#167)
pyproject.toml config support initially by just inline the tox.ini under tool.tox.legacy_tox_ini key; config source priority order is pyproject.toml, tox.ini and then setup.cfg - by gaborbernat (#814)
use the os environment variable TOX_SKIP_ENV to filter out tox environment names from the run list (set by envlist) - by gaborbernat (#824)
always set PIP_USER=0 (do not install into the user site package, but inside the virtual environment created) and PIP_NO_DEPS=0 (installing without dependencies can cause broken package installations) inside tox - by gaborbernat (#838)
tox will inject some environment variables that to indicate a command is running within tox: TOX_WORK_DIR env var is set to the tox work directory, TOX_ENV_NAME is set to the current running tox environment name, TOX_ENV_DIR is set to the current tox environments working dir - by gaborbernat (#847)
While running tox invokes various commands (such as building the package, pip installing dependencies and so on), these were printed in case they failed as Python arrays. Changed the representation to a shell command, allowing the users to quickly replicate/debug the failure on their own - by gaborbernat (#851)
skip missing interpreters value from the config file can now be overridden via the --skip-missing-interpreters cli flag - by gaborbernat (#903)
keep additional environments config order when listing them - by gaborbernat (#921)
allow injecting config value inside the ini file dependent of the fact that we're connected to an interactive shell or not via exposing a {tty} substitution - by gaborbernat (#947)
do not build sdist if skip install is specified for the envs to be run - by gaborbernat (#974)
when verbosity level increases above two start passing through verbosity flags to pip - by gaborbernat (#982)
when discovering the interpreter to use check if the tox host Python matches and use that if so - by gaborbernat (#994)
-vv will print out why a virtual environment is re-created whenever this operation is triggered - by gaborbernat (#1004)
add --exists-action w to default pip flags to handle better VCS dependencies (pip documentation on this) - by gaborbernat (#503)
instead of assuming the Python version from the base python name ask the interpreter to reveal the version for the ignore_basepython_conflict flag - by gaborbernat (#908)
PEP-517 packaging fails with sdist already exists, fixed via ensuring the dist folder is empty before invoking the backend and pypa/setuptools 1481 - by gaborbernat (#1003)
clarify that python and pip refer to the virtual environments executable - by gaborbernat (#305)
add Sphinx and mkdocs example of generating documentation via tox - by gaborbernat (#374)
specify that setup.cfg tox configuration needs to be inside the tox:tox namespace - by gaborbernat (#545)
PEP-517 source distribution support (create a .package virtual environment to perform build operations inside) by @gaborbernat
<a name="release-3-3-0-added"></a>
.package virtual environment to perform build operations inside) by @gaborbernat (#573)PEP-517 by @gaborbernat (#820)tox_package(session, venv) by @gaborbernat (#951)<a name="release-3-3-0-changes"></a>
<a name="release-3-3-0-fixed"></a>
PEP-517 source distribution support (create a .package virtual environment to perform build operations inside) by gaborbernat (#573)
packaging now is exposed as a hook via tox_package(session, venv) - by gaborbernat (#951)
Updated the VSTS build YAML to use the latest jobs and pools syntax - by davidstaheli (#955)
fix TOX_LIMITED_SHEBANG when running under python3 - by asottile (#931)
--parallel--safe-build no longer cleans up its folders (distdir, distshare, log). by @gaborbernat
<a name="release-3-2-1-fixed"></a>
--parallel--safe-build no longer cleans up its folders (distdir, distshare, log). by @gaborbernat (#849)--parallel--safe-build no longer cleans up its folders (distdir, distshare, log). - by gaborbernat (#849)
Switch pip invocations to use the module -m pip instead of direct invocation. This could help avoid some of the shebang limitations. by @gaborbernat
<a name="release-3-2-0-added"></a>
-m pip instead of direct invocation. This could help avoid some of the shebang limitations. by @gaborbernat (#935)tox.ini (tox section under key requires - PEP-508 style): can be used to specify both plugin requirements or build dependencies. by @gaborbernat (#783)--parallel--safe-build flag. by @gaborbernat (#849)Switch pip invocations to use the module -m pip instead of direct invocation. This could help avoid some of the shebang limitations. - by gaborbernat (#935)
Ability to specify package requirements for the tox run via the tox.ini (tox section under key requires - PEP-508 style): can be used to specify both plugin requirements or build dependencies. - by gaborbernat (#783)
Allow one to run multiple tox instances in parallel by providing the --parallel--safe-build flag. - by gaborbernat (#849)
to work without requiring an upgrade to tox. As such, the following public constants are now deprecated (and scheduled for removal in tox 4.0: CPYTHON…
<a name="release-3-1-3-added"></a>
py38 and eventually py39 / py40 / etc. to work without requiring an upgrade to tox. As such, the following public constants are now deprecated (and scheduled for removal in tox 4.0: CPYTHON_VERSION_TUPLES, PYPY_VERSION_TUPLES, OTHER_PYTHON_INTERPRETERS, and DEFAULT_FACTORS by @asottile (#914)<a name="release-3-1-3-fixed"></a>
develop-inst-nodeps action, which reinstalls the package under test, to always run has been resolved. The develop-inst-noop action, which, as the name suggests, is a no-op, will now run unless there are changes to setup.py or setup.cfg files that have not been reflected by @stephenfin (#909)<a name="release-3-1-3-documentation"></a>
Python version testenvs are now automatically detected instead of comparing against a hard-coded list of supported versions. This enables py38 and eventually py39 / py40 / etc. to work without requiring an upgrade to tox. As such, the following public constants are now deprecated (and scheduled for removal in tox 4.0: CPYTHON_VERSION_TUPLES, PYPY_VERSION_TUPLES, OTHER_PYTHON_INTERPRETERS, and DEFAULT_FACTORS - by asottile (#914)
A caching issue that caused the develop-inst-nodeps action, which reinstalls the package under test, to always run has been resolved. The develop-inst-noop action, which, as the name suggests, is a no-op, will now run unless there are changes to setup.py or setup.cfg files that have not been reflected - by stephenfin (#909)
Add a system overview section on the index page that explains briefly how tox works - by gaborbernat. (#867)
Revert "Fix bug with incorrectly defactorized dependencies (#772)" due to a regression ((#799)) by @obestwalter
<a name="release-3-1-2-fixed"></a>
Revert "Fix bug with incorrectly defactorized dependencies (#772)" due to a regression ((#799)) - by obestwalter
PyPI documentation for 3.1.0 is broken. Added test to check for this, and fix it by @gaborbernat.
<a name="release-3-1-1-fixed"></a>
3.1.0 is broken. Added test to check for this, and fix it by @gaborbernat. (#879)PyPI documentation for 3.1.0 is broken. Added test to check for this, and fix it by gaborbernat. (#879)
Add support for multiple PyPy versions using default factors. This allows you to use, for example, pypy27 knowing that the correct interpreter will be
<a name="release-3-1-0-added"></a>
pypy27 knowing that the correct interpreter will be used by default by @stephenfin (#19)tox cannot invoke scripts with a system-limited shebang (e.x. a Linux host running a Jenkins Pipeline), a user can set the environment variable TOX_LIMITED_SHEBANG to workaround the system's limitation (e.x. export TOX_LIMITED_SHEBANG=1) by @jdknight (#794)py2 and py3 aliases also resolve via py on windows by @asottile. This enables the following things: tox -e py2 and tox -e py3 work on windows (they already work on posix); and setting basepython=python2 or basepython=python3 now works on windows. (#856)<a name="release-3-1-0-changes"></a>
<a name="release-3-1-0-fixed"></a>
ignore_basepython_conflict, which determines whether conflicting basepython settings for environments containing default factors, such as py27 or django18-py35, should be ignored or result in warnings. This was a common source of misconfiguration and is rarely, if ever, desirable from a user perspective by @stephenfin (#477)<a name="release-3-1-0-documentation"></a>
<a name="release-3-1-0-packaging"></a>
Add support for multiple PyPy versions using default factors. This allows you to use, for example, pypy27 knowing that the correct interpreter will be used by default - by stephenfin (#19)
Add support to explicitly invoke interpreter directives for environments with long path lengths. In the event that tox cannot invoke scripts with a system-limited shebang (e.x. a Linux host running a Jenkins Pipeline), a user can set the environment variable TOX_LIMITED_SHEBANG to workaround the system's limitation (e.x. export TOX_LIMITED_SHEBANG=1) - by jdknight (#794)
introduce a constants module to be used internally and as experimental API - by obestwalter (#798)
Make py2 and py3 aliases also resolve via py on windows by asottile. This enables the following things: tox -e py2 and tox -e py3 work on windows (they already work on posix); and setting basepython=python2 or basepython=python3 now works on windows. (#856)
Replace the internal version parsing logic from the not well tested PEP-386 parser for the more general PEP-440. packaging >= 17.1 is now an install dependency by gaborbernat. (#860)
make the already existing implicit API explicit - by obestwalter (#800)
tweak codecov settings via .codecov.yml - by obestwalter (#802)
Add ignore_basepython_conflict, which determines whether conflicting basepython settings for environments containing default factors, such as py27 or django18-py35, should be ignored or result in warnings. This was a common source of misconfiguration and is rarely, if ever, desirable from a user perspective - by stephenfin (#477)
Fix bug with incorrectly defactorized dependencies (deps passed to pip were not de-factorized) - by bartsanchez (#706)
extend the plugin documentation and make lot of small fixes and improvements - by obestwalter (#797)
tidy up tests - remove unused fixtures, update old cinstructs, etc. - by obestwalter (#799)
Various improvements to documentation: open browser once documentation generation is done, show Github/Travis info on documentation page, remove duplicate header for changelog, generate unreleased news as DRAFT on top of changelog, make the changelog page more compact and readable (width up to 1280px) by gaborbernat (#859)
improve tox quickstart and corresponding tests - by obestwalter (#801)
filter out unwanted files in package - by obestwalter (#754)
(only affected rc releases) Revert breaking change of tox.cmdline not callable with no args by @gaborbernat.
<a name="release-3-0-0-added"></a>
tox displays exit code together with InvocationError by @blueyed and @ederag. (#290)InvocationError, on posix systems by @ederag and @asottile. (#766)-q option to progressively silence tox's output. For each time you specify -q to tox, the output provided by tox reduces. This option allows you to see only your command output without the default verbosity of what tox is doing. This also counter-acts usage of -v. For example, running tox -v -q ... will provide you with the default verbosity. tox -vv -q is equivalent to tox -v. By @sigmavirus24 (#256)!dev: production_log by @jurko-gospodnetic (#292)installed: <packages> will not be printed if there is no output to display after the :, unless verbosity is set. By @cryvate (#601)deps=-rreq.txt and deps=--requirement=req.txt worked, now also deps=-r req.txt and deps=--requirement req.txt work by @cryvate (#668)2.6 and 3.3 support: setuptools dropped supporting these, and as we depend on it we'll follow up with doing the same (use tox <= 2.9.1 if you still need this support) by @gaborbernat (#679)PROCESSOR_ARCHITECTURE by default on Windows to fix platform.machine(). (#740)<a name="release-3-0-0-changes"></a>
interpreters.py code and added some missing tests for it by @jurko-gospodnetic (#708)PYTHONDONTWRITEBYTECODE environment variable is no longer unset by @stephenfin. (#744)<a name="release-3-0-0-fixed"></a>
Requested Python version (X.Y) not installed stderr output when a Python environment is looked up using the py Python launcher on Windows and the environment is not found installed on the system by @jurko-gospodnetic (#692)IOError: [Errno 0] Error on Windows, this was fixed by using a simpler method to update the read buffers. by @fschulze (#727)cmdline import to the old location and changing the entry point instead by @fschulze (#755)tox without a setup.py now has a more friendly error message and gives troubleshooting suggestions by @Volcyy. (#331)<a name="release-3-0-0-documentation"></a>
tox displays exit code together with InvocationError - by @blueyed and @ederag . ( #290 )
Hint for possible signal upon InvocationError , on posix systems - by @ederag and @asottile . ( #766 )
Add a -q option to progressively silence tox’s output. For each time you specify -q to tox, the output provided by tox reduces. This option allows you to see only your command output without the default verbosity of what tox is doing. This also counter-acts usage of -v . For example, running tox -v -q ... will provide you with the default verbosity. tox -vv -q is equivalent to tox -v . By @sigmavirus24 ( #256 )
add support for negated factor conditions, e.g. !dev: production_log - by @jurko-gospodnetic ( #292 )
Headings like installed: <packages> will not be printed if there is no output to display after the :, unless verbosity is set. By @cryvate ( #601 )
Allow spaces in command line options to pip in deps. Where previously only deps=-rreq.txt and deps=--requirement=req.txt worked, now also deps=-r req.txt and deps=--requirement req.txt work - by @cryvate ( #668 )
drop Python 2.6 and 3.3 support: setuptools dropped supporting these, and as we depend on it we’ll follow up with doing the same (use tox <= 2.9.1 if you still need this support) - by @gaborbernat ( #679 )
Add tox_runenvreport as a possible plugin, allowing the overriding of the default behavior to execute a command to get the installed packages within a virtual environment - by @tonybaloney ( #725 )
Forward PROCESSOR_ARCHITECTURE by default on Windows to fix platform.machine() . ( #740 )
touched up interpreters.py code and added some missing tests for it - by @jurko-gospodnetic ( #708 )
The PYTHONDONTWRITEBYTECODE environment variable is no longer unset - by @stephenfin . ( #744 )
Write directly to stdout buffer if possible to prevent str vs bytes issues - by @asottile ( #426 )
fix #672 reporting to json file when skip-missing-interpreters option is used - by @r2dan ( #672 )
avoid Requested Python version (X.Y) not installed stderr output when a Python environment is looked up using the py Python launcher on Windows and the environment is not found installed on the system - by @jurko-gospodnetic ( #692 )
Fixed an issue where invocation of tox from the Python package, where invocation errors (failed actions) occur results in a change in the sys.stdout stream encoding in Python 3.x. New behavior is that sys.stdout is reset back to its original encoding after invocation errors - by @tonybaloney ( #723 )
The reading of command output sometimes failed with IOError: [Errno 0] Error on Windows, this was fixed by using a simpler method to update the read buffers. - by @fschulze ( #727 )
(only affected rc releases) fix up tox.cmdline to be callable without args - by @gaborbernat . ( #773 )
(only affected rc releases) Revert breaking change of tox.cmdline not callable with no args - by @gaborbernat . ( #773 )
(only affected rc releases) fix #755 by reverting the cmdline import to the old location and changing the entry point instead - by @fschulze ( #755 )
Running tox without a setup.py now has a more friendly error message and gives troubleshooting suggestions - by @Volcyy . ( #331 )
Fix pycodestyle (formerly pep8) errors E741 (ambiguous variable names, in this case, ‘l’s) and remove ignore of this error in tox.ini - by @cryvate ( #663 )
Change favicon to the vector beach ball - by @hazalozturk ( #748 )
Change sphinx theme to alabaster and add logo/favicon - by @hazalozturk ( #639 )
tox displays exit code together with InvocationError - by blueyed and ederag. (#290)
Hint for possible signal upon InvocationError, on posix systems - by ederag and asottile. (#766)
Add a -q option to progressively silence tox's output. For each time you specify -q to tox, the output provided by tox reduces. This option allows you to see only your command output without the default verbosity of what tox is doing. This also counter-acts usage of -v. For example, running tox -v -q ... will provide you with the default verbosity. tox -vv -q is equivalent to tox -v. By sigmavirus24 (#256)
add support for negated factor conditions, e.g. !dev: production_log - by jurko-gospodnetic (#292)
Headings like installed: <packages> will not be printed if there is no output to display after the :, unless verbosity is set. By cryvate (#601)
Allow spaces in command line options to pip in deps. Where previously only deps=-rreq.txt and deps=--requirement=req.txt worked, now also deps=-r req.txt and deps=--requirement req.txt work - by cryvate (#668)
drop Python 2.6 and 3.3 support: setuptools dropped supporting these, and as we depend on it we'll follow up with doing the same (use tox <= 2.9.1 if you still need this support) - by gaborbernat (#679)
Add tox_runenvreport as a possible plugin, allowing the overriding of the default behavior to execute a command to get the installed packages within a virtual environment - by tonybaloney (#725)
Forward PROCESSOR_ARCHITECTURE by default on Windows to fix platform.machine(). (#740)
touched up interpreters.py code and added some missing tests for it - by jurko-gospodnetic (#708)
The PYTHONDONTWRITEBYTECODE environment variable is no longer unset - by stephenfin. (#744)
Write directly to stdout buffer if possible to prevent str vs bytes issues - by asottile (#426)
fix #672 reporting to json file when skip-missing-interpreters option is used - by r2dan (#672)
avoid Requested Python version (X.Y) not installed stderr output when a Python environment is looked up using the py Python launcher on Windows and the environment is not found installed on the system - by jurko-gospodnetic (#692)
Fixed an issue where invocation of tox from the Python package, where invocation errors (failed actions) occur results in a change in the sys.stdout stream encoding in Python 3.x. New behavior is that sys.stdout is reset back to its original encoding after invocation errors - by tonybaloney (#723)
The reading of command output sometimes failed with IOError: [Errno 0] Error on Windows, this was fixed by using a simpler method to update the read buffers. - by fschulze (#727)
(only affected rc releases) fix up tox.cmdline to be callable without args - by gaborbernat. (#773)
(only affected rc releases) Revert breaking change of tox.cmdline not callable with no args - by gaborbernat. (#773)
(only affected rc releases) fix #755 by reverting the cmdline import to the old location and changing the entry point instead - by fschulze (#755)
Running tox without a setup.py now has a more friendly error message and gives troubleshooting suggestions - by Volcyy. (#331)
Fix pycodestyle (formerly pep8) errors E741 (ambiguous variable names, in this case, 'l's) and remove ignore of this error in tox.ini - by cryvate (#663)
Change favicon to the vector beach ball - by hazalozturk (#748)
Change sphinx theme to alabaster and add logo/favicon - by hazalozturk (#639)
🐍 PyPI release 📜 Full Changelog
Revert breaking change of tox.cmdline not callable with no args by @gaborbernat.
<a name="release-3-0-0rc3-fixed"></a>
tox displays exit code together with InvocationError by @blueyed and @ederag.
<a name="release-3-0-0rc2-added"></a>
tox displays exit code together with InvocationError by @blueyed and @ederag. (#290)InvocationError, on posix systems by @ederag and @asottile. (#766)<a name="release-3-0-0rc2-fixed"></a>
cmdline import to the old location and changing the entry point instead by @fschulze (#755)<a name="release-3-0-0rc2-documentation"></a>
tox displays exit code together with InvocationError - by blueyed and ederag. (#290)
Hint for possible signal upon InvocationError, on posix systems - by ederag and asottile. (#766)
fix #755 by reverting the cmdline import to the old location and changing the entry point instead - by fschulze (#755)
Change favicon to the vector beach ball - by hazalozturk (#748)
Add a -q option to progressively silence tox's output. For each time you specify -q to tox, the output provided by tox reduces. This option allows you
<a name="release-3-0-0rc1-added"></a>
-q option to progressively silence tox's output. For each time you specify -q to tox, the output provided by tox reduces. This option allows you to see only your command output without the default verbosity of what tox is doing. This also counter-acts usage of -v. For example, running tox -v -q ... will provide you with the default verbosity. tox -vv -q is equivalent to tox -v. By @sigmavirus24 (#256)!dev: production_log by @jurko-gospodnetic (#292)installed: <packages> will not be printed if there is no output to display after the :, unless verbosity is set. By @cryvate (#601)deps=-rreq.txt and deps=--requirement=req.txt worked, now also deps=-r req.txt and deps=--requirement req.txt work by @cryvate (#668)2.6 and 3.3 support: setuptools dropped supporting these, and as we depend on it we'll follow up with doing the same (use tox <= 2.9.1 if you still need this support) by @gaborbernat (#679)PROCESSOR_ARCHITECTURE by default on Windows to fix platform.machine(). (#740)<a name="release-3-0-0rc1-changes"></a>
PYTHONDONTWRITEBYTECODE environment variable is no longer unset by @stephenfin. (#744)<a name="release-3-0-0rc1-fixed"></a>
Requested Python version (X.Y) not installed stderr output when a Python environment is looked up using the py Python launcher on Windows and the environment is not found installed on the system by @jurko-gospodnetic (#692)IOError: [Errno 0] Error on Windows, this was fixed by using a simpler method to update the read buffers. by @fschulze (#727)tox without a setup.py now has a more friendly error message and gives troubleshooting suggestions by @Volcyy. (#331)<a name="release-3-0-0rc1-documentation"></a>
Add a -q option to progressively silence tox’s output. For each time you specify -q to tox, the output provided by tox reduces. This option allows you to see only your command output without the default verbosity of what tox is doing. This also counter-acts usage of -v . For example, running tox -v -q ... will provide you with the default verbosity. tox -vv -q is equivalent to tox -v . By @sigmavirus24 ( #256 )
add support for negated factor conditions, e.g. !dev: production_log - by @jurko-gospodnetic ( #292 )
Headings like installed: <packages> will not be printed if there is no output to display after the :, unless verbosity is set. By @cryvate ( #601 )
Allow spaces in command line options to pip in deps. Where previously only deps=-rreq.txt and deps=--requirement=req.txt worked, now also deps=-r req.txt and deps=--requirement req.txt work - by @cryvate ( #668 )
drop Python 2.6 and 3.3 support: setuptools dropped supporting these, and as we depend on it we’ll follow up with doing the same (use tox <= 2.9.1 if you still need this support) - by @gaborbernat ( #679 )
Add tox_runenvreport as a possible plugin, allowing the overriding of the default behavior to execute a command to get the installed packages within a virtual environment - by @tonybaloney ( #725 )
Forward PROCESSOR_ARCHITECTURE by default on Windows to fix platform.machine() . ( #740 )
The PYTHONDONTWRITEBYTECODE environment variable is no longer unset - by @stephenfin . ( #744 )
Write directly to stdout buffer if possible to prevent str vs bytes issues - by @asottile ( #426 )
fix #672 reporting to json file when skip-missing-interpreters option is used by @r2dan ( #672 )
avoid Requested Python version (X.Y) not installed stderr output when a Python environment is looked up using the py Python launcher on Windows and the environment is not found installed on the system - by @jurko-gospodnetic ( #692 )
Fixed an issue where invocation of Tox from the Python package, where invocation errors (failed actions) occur results in a change in the sys.stdout stream encoding in Python 3.x. New behavior is that sys.stdout is reset back to its original encoding after invocation errors - by @tonybaloney ( #723 )
The reading of command output sometimes failed with IOError: [Errno 0] Error on Windows, this was fixed by using a simpler method to update the read buffers. - by @fschulze ( #727 )
Running tox without a setup.py now has a more friendly error message and gives troubleshooting suggestions - by @Volcyy . ( #331 )
Change sphinx theme to alabaster and add logo/favicon - by @hazalozturk ( #639 )
Add a -q option to progressively silence tox's output. For each time you specify -q to tox, the output provided by tox reduces. This option allows you to see only your command output without the default verbosity of what tox is doing. This also counter-acts usage of -v. For example, running tox -v -q ... will provide you with the default verbosity. tox -vv -q is equivalent to tox -v. By sigmavirus24 (#256)
add support for negated factor conditions, e.g. !dev: production_log - by jurko-gospodnetic (#292)
Headings like installed: <packages> will not be printed if there is no output to display after the :, unless verbosity is set. By cryvate (#601)
Allow spaces in command line options to pip in deps. Where previously only deps=-rreq.txt and deps=--requirement=req.txt worked, now also deps=-r req.txt and deps=--requirement req.txt work - by cryvate (#668)
drop Python 2.6 and 3.3 support: setuptools dropped supporting these, and as we depend on it we'll follow up with doing the same (use tox <= 2.9.1 if you still need this support) - by gaborbernat (#679)
Add tox_runenvreport as a possible plugin, allowing the overriding of the default behavior to execute a command to get the installed packages within a virtual environment - by tonybaloney (#725)
Forward PROCESSOR_ARCHITECTURE by default on Windows to fix platform.machine(). (#740)
The PYTHONDONTWRITEBYTECODE environment variable is no longer unset - by stephenfin. (#744)
Write directly to stdout buffer if possible to prevent str vs bytes issues - by asottile (#426)
fix #672 reporting to json file when skip-missing-interpreters option is used by r2dan (#672)
avoid Requested Python version (X.Y) not installed stderr output when a Python environment is looked up using the py Python launcher on Windows and the environment is not found installed on the system - by jurko-gospodnetic (#692)
Fixed an issue where invocation of Tox from the Python package, where invocation errors (failed actions) occur results in a change in the sys.stdout stream encoding in Python 3.x. New behavior is that sys.stdout is reset back to its original encoding after invocation errors - by tonybaloney (#723)
The reading of command output sometimes failed with IOError: [Errno 0] Error on Windows, this was fixed by using a simpler method to update the read buffers. - by fschulze (#727)
Running tox without a setup.py now has a more friendly error message and gives troubleshooting suggestions - by Volcyy. (#331)
Change sphinx theme to alabaster and add logo/favicon - by hazalozturk (#639)
integrated new release process and fixed changelog rendering for pypi.org by @obestwalter.
<a name="release-2-9-1-changes"></a>
integrated new release process and fixed changelog rendering for pypi.org - by obestwalter.
…Features, Bugfixes, Improved Documentation and Deprecations and Removals.
<a name="release-2-9-0-added"></a>
tox --version now shows information about all registered plugins by @obestwalter (#544)<a name="release-2-9-0-changes"></a>
<a name="release-2-9-0-fixed"></a>
skip_install overrides usedevelop (usedevelop is an option to choose the installation type if the package is installed and skip_install determines if it should be installed at all) by @ferdonline (#571)<a name="release-2-9-0-documentation"></a>
Features, Bugfixes, Improved Documentation and Deprecations and Removals. (#614)tox --version now shows information about all registered plugins - by obestwalter (#544)
#635 inherit from correct exception - by obestwalter (#635).
spelling and escape sequence fixes - by scoop (#637 and #638).
skip_install overrides usedevelop (usedevelop is an option to choose the installation type if the package is installed and skip_install determines if it should be installed at all) - by ferdonline (#571)
add a badge to show build status of documentation on readthedocs.io - by obestwalter.
add towncrier to allow adding changelog entries with the pull requests without generating merge conflicts; with this release notes are now grouped into four distinct collections: Features, Bugfixes, Improved Documentation and Deprecations and Removals. (#614)
…Features, Bugfixes, Improved Documentation and Deprecations and Removals.
<a name="release-2-9-0rc1-added"></a>
tox --version now shows information about all registered plugins by obestwalter (#544)<a name="release-2-9-0rc1-fixed"></a>
skip_install overrides usedevelop (usedevelop is an option to choose the installation type if the package is installed and skip_install determines if it should be installed at all) by ferdonline (#571)<a name="release-2-9-0rc1-documentation"></a>
Features, Bugfixes, Improved Documentation and Deprecations and Removals. (#614)tox --version now shows information about all registered plugins - by obestwalter (#544)
skip_install overrides usedevelop (usedevelop is an option to choose the installation type if the package is installed and skip_install determines if it should be installed at all) - by ferdonline (#571)
add towncrier to allow adding changelog entries with the pull requests without generating merge conflicts; with this release notes are now grouped into four distinct collections: Features, Bugfixes, Improved Documentation and Deprecations and Removals. (#614)
### Changes - #466: stop env var leakage if popen failed with resultjson or redirect 🐍 PyPI release 📜 Full Changelog
<a name="release-2-8-2-changes"></a>
One column per quarter.