Release History

v[UNRELEASED DRAFT] (2026-05-09)

No significant changes.

v4.53.1 (2026-05-02)

Bug fixes - 4.53.1

  • Hardening pass on user-facing logging and config parsing:

    • Mask secret-looking --key=value flag values in command logs (terminal warnings, .tox/<env>/log/*.log, and Outcome __repr__) using the same keyword regex previously applied to environment variable values.

    • Resolve PEP 723 script paths and reject any that escape tox_root; cap the script read at 5 MiB so a symlink to /dev/zero cannot exhaust memory.

    • Replace eval() of a constructed Literal[...] string in the CLI parser with a direct Literal[tuple(action.choices)] subscript.

    • Pass timeout=30 to urlopen when fetching a remote requirements file so a slow or unresponsive mirror cannot hang tox indefinitely. (#3924)

  • Allow the generated TOML schema to validate array values for deps. (#3929)

  • Correct type annotations for ArgumentParser.parse_args and parse_known_args overrides following typeshed PR #15613, which widened the args parameter from Sequence[str] to Iterable[str]. The narrower type in tox’s overrides violated the Liskov substitution principle and caused invalid-method-override errors with ty 0.0.33. Also correct the option_spec annotation in docs/tox_conf.py to ClassVar[dict[str, Callable[[str], Any]]] matching the docutils stubs type. (#3932)

v4.53.0 (2026-04-14)

Features - 4.53.0

  • TOML env_list now accepts bare range dicts ({ prefix = "3.", start = 12, stop = 14 }) and bare labeled dicts ({ ecosystem = ["oci", "python"] }) as top-level items, removing the { product = [...] } wrapper when there is only a single factor group - by @gaborbernat. (#3923)

Bug fixes - 4.53.0

  • Nesting a range or labeled dict inside a product factor-group list now raises a clear error pointing at the un-nesting fix, instead of silently producing a malformed environment name - by @gaborbernat. (#3923)

v4.52.1 (2026-04-09)

Bug fixes - 4.52.1

  • Changing a resolution-affecting environment variable via set_env (e.g. PIP_INDEX_URL) now invalidates the install cache and triggers a reinstall, rather than incorrectly reusing the cached environment - by @gaborbernat. (#3917)

  • Use normalize_isa from python-discovery for architecture factor matching, supporting aliases like i686 → x86 and aarch64 → arm64 - by @rahuldevikar. (#3919)

v4.52.0 (2026-03-30)

Features - 4.52.0

  • Add virtualenv-pep-723 runner that reads dependencies and Python version from PEP 723 inline script metadata — no need to duplicate them in tox config - by @gaborbernat. (#3897)

  • Support escaped dots (\.) in -x/--override keys, allowing overrides to target environments with dots in their names such as py3.14 - by @gaborbernat. (#3910)

Bug fixes - 4.52.0

  • Auto-generate the manpage from the CLI argparse parser at wheel build time, fixing broken section headers and documenting all commands and options - by @gaborbernat. (#3878)

Miscellaneous internal changes - 4.52.0

  • Remove unsupported --remote flag from gh repo fork in the update-schemastore workflow, as recent versions of gh no longer accept it - by @rahuldevikar. (#3908)

v4.51.0 (2026-03-27)

Features - 4.51.0

  • Add base_python_file configuration option to read the base Python version from a file (e.g. .python-version), similar to GitHub Actions’ python-version-file - by @rahuldevikar (#3894)

Bug fixes - 4.51.0

  • Prevent implicit machine ISA (e.g. arm64, x86_64) from overriding explicit architecture factors in environment names, fixing cross-architecture conflicts in multiline factor conditionals - by @rahuldevikar. (#3903)

  • Nested environment list configuration values are now properly parsed, validated and expanded by the TOML parser. This allows you to use generative environment lists in tox-gh via the TOML format. Previously this was only possible with the INI format. - by @Daverball (#3905)

Miscellaneous internal changes - 4.51.0

  • Enable persist-credentials: true in the actions/checkout step of the prepare-release workflow so that git push operations succeed during automated releases - by @rahuldevikar. (#3907)

v4.50.3 (2026-03-20)

Bug fixes - 4.50.3

  • Use separate .pkg environments for free-threaded Python targets by including the t suffix in the wheel build environment name (e.g., .pkg-cpython314t), preventing wheel tag mismatches when building for py314t - by @gaborbernat. (#3314)

v4.50.2 (2026-03-19)

Bug fixes - 4.50.2

  • Fix the sdist to include the missing docs/man/tox.1.rst file for building the manpage (#3889)

v4.50.1 (2026-03-19)

Bug fixes - 4.50.1

  • Detect and suggest normalized environment names when users specify dotted Python versions (e.g., py3.10-lint) that match existing environments with compact notation (e.g., py310-lint), preventing silent fallback to base [testenv] configuration - by @gaborbernat. (#3877)

v4.50.0 (2026-03-17)

Features - 4.50.0

  • Add interrupt_post_commands option to run cleanup commands even after SIGINT - by @gaborbernat. (#3858)

  • Add factor['NAME'] and env['VAR'] subscript syntax for conditional expressions, enabling checks of factors with non-identifier names like factor['3.14']. Add env_name variable to check the full environment name in conditions. (#3880)

Bug fixes - 4.50.0

  • Fix multiple manpage issues: remove duplicate header/author/copyright sections, set project in Sphinx config, and compile the manpage to troff format at wheel-build time instead of shipping raw RST source - by @gaborbernat. (#3878)

Improved documentation - 4.50.0

  • Document how to reference the built package path in commands via TOX_PACKAGE - by @rahuldevikar (#3862)

  • Fix broken TOML examples missing extend = true on conditional replacements inside lists, fix incorrect ref of path in raw reference docs, and add a test that validates all doc config examples - by @gaborbernat (#3875)

v4.49.1 (2026-03-09)

Bug fixes - 4.49.1

  • Break deadlock in execution interrupt chain that caused ~18 flaky timeout failures across 9 tests on Windows/macOS CI - by @gaborbernat. (#3869)

v4.49.0 (2026-03-06)

Features - 4.49.0

  • Add {factor:label} substitution for TOML configs – factor groups in product matrices and env_base factors can now be labeled with single-key dicts (e.g., {ecosystem = ["oci", "python"]}), enabling {factor:ecosystem} in any string value (descriptions, commands, etc.) to resolve to the active factor. Plain lists automatically get positional labels ({factor:0}, {factor:1}, …) - by @gaborbernat. (#3860) (#3860)

Bug fixes - 4.49.0

  • Fix --showconfig and --help-ini legacy flags raising AttributeError after config format options were added - by @rares985 (#3866)

v4.48.1 (2026-03-06)

Bug fixes - 4.48.1

  • Command-type configuration values like list_dependencies_command can now be referenced in TOML using the structured {replace = "ref"} syntax. The reference automatically extracts the command’s argument list for compatibility with TOML’s list[list[str]] structure - by @gaborbernat. (#3830)

Improved documentation - 4.48.1

  • Replace archived 31z4/tox Docker image recommendation with instructions for building your own image using the official Python base image and uv - by @rahuldevikar. (#3855)

v4.48.0 (2026-03-05)

Features - 4.48.0

  • Add --format flag (ini, json, toml) and -o/--output-file to the config command for machine-readable output with native types. JSON and TOML use the same key structure as tox.toml (env.<name> for environments, tox for core) and get syntax-highlighted on stdout - by @gaborbernat. (#3854)

Improved documentation - 4.48.0

  • Add fail_fast to the configuration reference documentation - by @rahuldevikar. (#578)

v4.47.3 (2026-03-04)

Bug fixes - 4.47.3

  • ignore_base_python_conflict now also suppresses errors when an environment name contains multiple conflicting version-like factors (e.g., unit-py3.10-2.16 where both py3.10 and 2.16 are detected as Python versions). Previously this flag only handled conflicts between explicit base_python settings and the environment name - by @gaborbernat. (#3850)

v4.47.2 (2026-03-03)

Bug fixes - 4.47.2

  • Handle OSError when checking if positional arguments are existing paths in pos_args() — long arguments (e.g., pytest -k expressions exceeding the 255-character filesystem name limit) no longer crash with OSError: [Errno 36] File name too long - by @yarikoptic. (#3847)

v4.47.1 (2026-03-03)

Bug fixes - 4.47.1

  • New-style version factors (e.g., 3.10-tests) now correctly set base_python - by @gaborbernat. (#3845)

v4.47.0 (2026-03-01)

Features - 4.47.0

  • Show clean error messages instead of stack traces when TOML configuration contains type mismatches (e.g., deps = [1]), wrapping failures in HandledError with environment and key context - by @gaborbernat. (#3831)

  • Add comprehensive tests asserting full error messages for every configurable field type when TOML config contains type mismatches - by @gaborbernat. (#3840)

Bug fixes - 4.47.0

  • Fix type errors flagged by ty for virtualenv API changes (system_executable nullability and cached_py_info.PythonInfo removal), and correct the CI workflow matrix exclude for windows-2025 - by @gaborbernat. (#3837)

  • base_python and default_base_python now accept a string value in TOML configuration (e.g., base_python = "python" is coerced to ["python"]) instead of raising TypeError - by @gaborbernat. (#3839)

  • Pass stdin through to commands executed via tox exec so that piped input (e.g., echo "foo" | tox exec -- python -c 'import sys; print(sys.stdin.read())') reaches the subprocess instead of being discarded - by @gaborbernat. (#3841)

v4.46.3 (2026-02-25)

Bug fixes - 4.46.3

  • Fix SchemaStore update workflow creating PRs with merge conflicts by branching from upstream master - by @gaborbernat. (#3828)

  • Fixed the minimum version of virtualenv, to avoid incompatibility. (#3829)

v4.46.2 (2026-02-25)

Bug fixes - 4.46.2

  • Fix SchemaStore update workflow authentication and PR creation for fork repositories - by @gaborbernat. (#3826)

v4.46.1 (2026-02-25)

Bug fixes - 4.46.1

  • Allow glob patterns (*, ?) in depends configuration for ini files - by @gaborbernat. (#3822)

  • Fix false positive schema validation errors with tombi by adding additionalProperties: true to partial-tox.json on SchemaStore - by @gaborbernat. (#3823)

v4.46.0 (2026-02-24)

Features - 4.46.0

  • Add architecture (ISA) awareness to Python discovery. tox now propagates the machine field (e.g. arm64, x86_64) from virtualenv’s interpreter info — derived from python:sysconfig.get_platform() — through the Python specification, validation, and journal. This allows selecting a Python interpreter by CPU architecture via base_python (e.g. cpython3.12-64-arm64) and ensures tox validates the running interpreter’s architecture matches the requested one. Requires virtualenv >= 20.39 - by @rahuldevikar. (#3069)

  • Add env_base TOML sections for named environment templates that generate multiple environments from factor combinations via Cartesian product – by @gaborbernat. (#3817)

Bug fixes - 4.46.0

  • Drop chardet dependency and use BOM detection with locale fallback for requirements file decoding, matching pip’s own approach - by @gaborbernat. (#3818)

  • Allow --help to render even when the configuration file is malformed or missing - by @gaborbernat. (#3819)

v4.45.0 (2026-02-23)

Features - 4.45.0

  • Enhance tox schema command: add x-taplo metadata for IDE integration, product dict support for env_list, handle int and PythonConstraints types, fix $schema draft-07 URI, and add schema freshness test. Add tox.toml to SchemaStore catalog for automatic IDE validation - by @gaborbernat. (#1388)

Bug fixes - 4.45.0

  • Add redirects for old documentation URLs that broke after the Diataxis restructure (e.g. /config.html -> /reference/config.html, /example/general.html -> /index.html) using sphinx-reredirects - by @gaborbernat. (#3806)

  • Fix cross-section substitution {[section]key} resolving to a literal unresolved reference instead of empty string when the referenced value contains only factor-conditional lines and no factors match the requesting environment - by @Fridayai700. (#3809)

  • Fix circular dependency in environment_variables when set_env references {env_site_packages_dir} or similar lazy constants, causing RecursionError silently caught as “could not find python interpreter” - by @gaborbernat. (#3816)

v4.44.0 (2026-02-20)

Features - 4.44.0

  • Support PEP 751 pylock.toml lock files as dependency input via the pylock configuration option (mutually exclusive with deps). Packages are filtered by extras, dependency groups, and platform markers evaluated against the target Python interpreter, then installed via pip with --no-deps - by @gaborbernat. (#3665)

Bug fixes - 4.44.0

  • Fix unfactored continuation lines (e.g. pytest \, --remote-data \) being incorrectly skipped when they follow a filtered factor-conditional line ending with \ – the pending_skip flag now only drops terminal continuation pieces, preserving shared arguments that are themselves continuations - by @gaborbernat. (#3802)

v4.43.0 (2026-02-20)

Features - 4.43.0

  • Add TOML-native generative env_list via product dict syntax – Cartesian product of factor groups with optional range dicts and exclusions - by @gaborbernat. (#3797)

Bug fixes - 4.43.0

  • Pass config_settings_build_wheel to pip as --config-settings when installing sdist packages, ensuring the build backend receives config settings during pip’s internal wheel build - by @gaborbernat. (#3125)

  • Fix factor-conditional continuation lines (e.g. cov: coverage run \ / !cov: python \ / somefile.py) where different factor prefixes on consecutive continuation lines caused prefixes to be passed as literal command arguments instead of being filtered - by @gaborbernat. (#3796)

Improved documentation - 4.43.0

  • Integrate sphinxcontrib-towncrier to render draft changelog entries directly in Sphinx, replacing the manual towncrier draft script - by @gaborbernat. (#3201)

v4.42.0 (2026-02-20)

Features - 4.42.0

  • Platform-dependent commands can now be specified using factor syntax without requiring the platform name in the environment name. The current platform (sys.platform value like linux, darwin, win32) is automatically available as an implicit factor, allowing configurations like linux: pytest in INI or factor.linux in TOML conditional expressions to work in any environment. Additionally, TOML configurations can now use factor.NAME in conditional expressions to filter settings based on environment name factors, achieving feature parity with INI’s factor system - by @gaborbernat. (#2092)

  • Add {env_site_packages_dir_plat} / {envsitepackagesdir_plat} substitution that returns the platform-specific (platlib) site-packages directory. On some Linux distributions (Fedora, RHEL) this resolves to lib64 instead of lib, which is no longer symlinked since virtualenv 20.x - by @gaborbernat. (#2302)

  • External packaging environments (package = external) now only run their build commands once per session, reusing the built package for all test environments that depend on them - by @gaborbernat. (#2729)

  • Add default_base_python configuration key to specify a fallback Python interpreter when no Python factor or explicit base_python is defined. This allows projects to pin a default Python version for reproducibility across different machines without conflicting with pyXY factor-named environments - by @gaborbernat. (#2846)

  • CLI options added by plugins listed in requires are now accepted during provisioning instead of failing with “unrecognized arguments” - by @gaborbernat. (#2935)

  • Warn about unused configuration keys during tox run -v - by @gaborbernat. (#3188)

  • Improve towncrier changelog structure with more granular categories: breaking, deprecation, feature, bugfix, doc, packaging, contrib, and misc - by @gaborbernat. (#3200)

  • Add --skip-env-install CLI flag to skip dependency and package installation, allowing reuse of existing environments when offline or when installation is unnecessary - by @gaborbernat. (#3310)

  • Add recreate_commands configuration option to run cleanup commands (e.g. clearing external caches like pre-commit) before the environment directory is removed during recreation (-r) - by @gaborbernat. (#3423)

  • Environments with unavailable runners (missing plugins) are now gracefully skipped instead of causing a fatal error, shown with status “NOT AVAILABLE”. If such an environment is explicitly requested with -e, a clear error message is shown indicating which runner is missing and that the plugin may not be installed. Unavailable environments in the configuration don’t cause the overall run to fail - by @gaborbernat. (#3504)

  • Add open-ended range expansion in generative env lists — py3{9-} expands up to the latest supported CPython minor version and py3{-13} expands down to the oldest supported one, both hardcoded at release time per the Python release cycle - by @gaborbernat. (#3583)

  • Add --no-capture (-i) CLI flag to disable output capture, allowing interactive programs like Python REPL to access the terminal directly. When enabled, subprocess inherits parent console handles instead of pipes, fixing issues where terminal APIs (e.g., querying console dimensions) fail on pipe handles. Mutually exclusive with --result-json and parallel mode - by @gaborjbernat. Fixes #3635. (#3635)

  • Add virtualenv_spec configuration key that allows pinning a specific virtualenv version per environment (e.g. virtualenv_spec = "virtualenv<20.22.0"). When set, tox bootstraps the specified version in an isolated environment and drives it via subprocess, enabling environments targeting Python versions incompatible with the installed virtualenv - by @gaborbernat. (#3656)

Bug fixes - 4.42.0

  • Suppress BrokenPipeError during backend teardown when interrupted, preventing traceback spam during KeyboardInterrupt - by @gaborjbernat. Fixes #2660. (#2660)

  • Factor-specific multiline commands using backslash continuation (\) no longer leak continuation lines into environments that don’t match the factor - by @gaborbernat. (#2912)

  • --list-dependencies output is now printed to stdout during parallel runs. Previously, the dependency list was captured in suspended output buffers and only shown on failure - by @gaborbernat. (#3322)

  • Compound factor conditionals (e.g., np-cov: coverage) now correctly allow their individual factors to be used when specifying environments with -e. Previously, running tox -e py310-np-cov with a factor conditional np-cov: coverage in the config would fail with “provided environments not found” because the individual factor cov was not recognized as combinable - by @gaborbernat. (#3780)

Improved documentation - 4.42.0

  • Document Debian/Ubuntu python3-venv limitation in known limitations - by @gaborbernat. (#3195)

v4.41.0 (2026-02-19)

Features - 4.41.0

  • Add package = "deps-only" mode that installs the package’s dependencies (including extras) without building or installing the package itself. For projects with static PEP 621 metadata, dependencies are read directly from pyproject.toml without creating a packaging environment - by @gaborbernat. (#2301)

  • Prefer TOML-native configuration ([tool.tox]) over legacy_tox_ini when both are present in pyproject.toml, allowing users to include a legacy_tox_ini section with min_version for older tox versions while using native TOML config for newer ones - by @rahuldevikar. (#3402)

Bugfixes - 4.41.0

  • Fix PEP 517 backend crash detection to handle both ENOENT (missing interpreter) and runtime crashes without hanging, and fix flaky test_provision_install_pkg_pep517 integration test by using a pre-built wheel instead of an sdist to avoid devpi mirror dependency on setuptools - by @gaborjbernat. (#3774)

v4.40.0 (2026-02-19)

Features - 4.40.0

  • Add {glob:PATTERN} substitution to expand file system glob/wildcard patterns in configuration values. Supports default values, recursive ** matching, and both INI string syntax and TOML dict syntax ({ replace = "glob", pattern = "..." }) - by @gaborbernat. (#1571)

  • Add commands_retry configuration option to automatically retry failed commands - by @gaborbernat. (#1578)

  • Automatically create a .gitignore file containing * in the tox work directory (typically .tox/) and in environment info directories, so that tox-managed files are not tracked by git - by @rahuldevikar. (#2530)

  • Add conditional value selection via replace = "if" in TOML configuration. Supports a condition expression with env.VAR lookups, ==/!= comparisons, and and/or/not boolean logic to select between then and else values - by @gaborbernat. (#3650)

  • Add sdist-wheel package type that builds a wheel from a source distribution, ensuring the sdist is complete and the package can be correctly built from it — by @rahuldevikar. (#3687)

Bugfixes - 4.40.0

  • Use positive exit code (1) instead of -1 when reporting failures across multiple environments. On Windows, cmd.exe’s IF ERRORLEVEL 1 only matches exit codes >= 1, so the previous negative exit code was silently treated as success - by @radevika. Fixes #2945. (#2945)

  • When set_env both inherits via cross-section substitution (e.g., {[testenv]set_env}) and explicitly overrides the same variable, the explicit value was incorrectly replaced by the inherited one because load() moved the key from the raw dict to the materialized dict before the deferred substitution ran, making the protection check ineffective - by @gaborjbernat. Fixes #3773. (#3773)

v4.39.0 (2026-02-18)

Features - 4.39.0

  • Create a CACHEDIR.TAG file in the tox work directory (.tox) so that backup and archiving tools (e.g., tar --exclude-caches, Borg, restic) can automatically skip it - by @radevika. (#3334)

Bugfixes - 4.39.0

  • On Windows, ANSI color codes from child processes (like pytest, mypy) are now rendered correctly in terminals by enabling VT100 processing mode for subprocess output streams - by @gaborbernat. (#2337)

  • Concurrent tox processes no longer corrupt the provision environment (.tox) – a file lock now serializes provisioning across processes - by @gaborbernat. (#2515)

  • Config files (tox.ini, setup.cfg) with unicode characters are now read correctly on Windows when running tox with python -m -I (isolation mode) - by @gaborbernat. (#2692)

  • set_env values explicitly defined in a section now take precedence over values inherited via cross-section substitution (e.g., {[testenv]set_env}) - by @gaborbernat. (#2831)

  • The -e flag now supports brace expansion (e.g. tox -e 'py{38,39}-pytest{6.x,7.x}') instead of incorrectly splitting on commas inside braces - by @gaborbernat. (#2850)

  • Posargs containing colons no longer crash tox when an inactive environment uses {posargs} in path-like configuration values such as env_dir - by @gaborbernat. (#2860)

  • set_env values from cross-section substitution (e.g., {[testenv]set_env}) now correctly override default environment variables like PYTHONHASHSEED - by @gaborbernat. (#2872)

  • --force-dep now applies to package dependencies from project metadata (e.g. setup.cfg install_requires, pyproject.toml dependencies), not just tox config deps - by @gaborbernat. (#2943)

  • Using {posargs} in change_dir no longer causes a RecursionError - by @gaborbernat. (#3062)

  • Cross-section substitution (e.g. {[testenv:a]commands}) now resolves environment-specific variables like {envpython}, {envbindir}, {envtmpdir}, and {envsitepackagesdir} in the calling environment’s context rather than the referenced environment’s context - by @gaborbernat. (#3075)

  • Fix ValueError crash when using posargs on Windows with subst drive mappings – os.path.relpath fails across drive letters, so fall back to absolute paths when the relative path cannot be computed - by @gaborbernat. (#3086)

  • TOX_OVERRIDE with += (append) now works correctly when the override key name differs from the config file key name (e.g., overriding pass_env when config uses passenv, or vice versa) - by @gaborbernat. (#3127)

  • Fix spurious environment discovery from non-tox sections in setup.cfg – packages = find: in [options] was incorrectly interpreted as a tox factor marker, creating a phantom find environment - by @gaborbernat. (#3134)

  • Requirements in requires with environment markers that evaluate to false (e.g. virtualenv<20.22.0; python_version < "3.8") are now correctly skipped during provisioning instead of causing an infinite provisioning loop - by @gaborbernat. (#3136)

  • Running environments with recreate = true no longer destroys shared package environments (e.g. .pkg), which previously caused FileNotFoundError when a subsequent environment tried to use the already-built wheel - by @gaborbernat. (#3146)

  • Factor-conditional config values (e.g. base_python = py312: python3.12) now correctly fall back to the default when no factors match the current environment, instead of producing an empty value - by @gaborbernat. (#3189)

  • TOX_PARALLEL_NO_SPINNER / --parallel-no-spinner no longer forces parallel mode in the legacy command, fixing output suppression for sequential runs in CI - by @gaborbernat. (#3193)

  • Multiple -e flags are now additive (tox r -e a -e b runs both a and b), matching tox 3 behavior - by @gaborbernat. (#3199)

  • Environments like functional-py312 no longer incorrectly match when only functional{-py310} is defined as a testenv section – factors from section headers are no longer treated as freely combinable with CLI -e selections - by @gaborbernat. (#3219)

  • On Windows, a trailing path separator (e.g. from {/}) no longer causes the next command argument to be merged into the path - backslash before whitespace is now treated as a literal path separator rather than a space escape - by @gaborbernat. (#3222)

  • Fix {envtmpdir} and other env variable substitutions not expanding in external package environment commands - by @gaborbernat. (#3238) (#3238)

  • On Windows, colored output is now preserved when running provisioned tox by explicitly passing the --colored yes flag to the provisioned subprocess when the parent has colors enabled - by @gaborbernat. (#3331)

  • set_env values defined after a file| reference now correctly take precedence over values loaded from the env file - by @gaborbernat. (#3335)

  • The base configuration key now works correctly in TOML format (tox.toml and pyproject.toml), allowing environments to inherit from arbitrary sections defined under [env.*] - by @gaborbernat. (#3497)

  • Skip toxfile.py inline plugin when it uses hooks not available in the current tox version instead of crashing - this allows provisioning to upgrade tox to a version that supports those hooks - by @gaborbernat. (#3593)

  • set_env substitution referencing {envsitepackagesdir}, {envbindir}, or {envpython} for environments with missing interpreters now raises Skip instead of RuntimeError, allowing skip_missing_interpreters to work correctly - by @gaborbernat. (#3597)

  • A setup.cfg without a [tox:tox] section no longer blocks discovery of pyproject.toml or tox.toml configuration files in the same directory - by @gaborbernat. (#3602)

  • Fix pytest INTERNALERROR on Python 3.15 caused by Pygments using deprecated os.path.commonprefix() - by @gaborbernat. (#3733)

  • Fix RecursionError when TOML set_env contains substitutions like {env_site_packages_dir} that trigger config loading cycles – the TOML loader now defers string substitution in set_env values, matching the INI loader’s lazy resolution behavior - by @gaborbernat. (#3758)

Documentation - 4.39.0

  • Document that interactive terminal programs (e.g., IPython) may not work correctly under tox due to the PTY-based output capture architecture - by @gaborbernat. (#2999)

v4.38.0 (2026-02-17)

Features - 4.38.0

  • Scope dependency rejection in PEP-517 package environments to only pure PEP-517 build types (sdist, wheel, editable), allowing non-standard package types like editable-legacy to specify dependencies - by @rahuldevikar. (#3731)

v4.37.0 (2026-02-17)

Features - 4.37.0

  • Add extra_setup_commands configuration option to run commands after dependency and package installation but before test commands, useful with --notest for separating setup from execution - by @gaborbernat. (#1504)

Bugfixes - 4.37.0

  • Set PIP_USER=0 environment variable when running pip commands in virtualenvs to prevent pip from attempting --user installs when users have pip config --user configured globally — by @gaborbernat. (#3010)

  • Fix TOML env_run_base and env_pkg_base deps being clobbered when referenced with additional deps in testenv configuration (#3393)

  • Normalize extra names when resolving dependencies so that underscores and hyphens are treated equivalently (e.g. extras = snake_case now matches Provides-Extra: snake-case in wheel metadata) - by @Fridayai700. (#3433)

  • Fix setenv modifications to PATH being overwritten when tox environment paths are set up - by @Fridayai700 (#3445)

  • Fix deps entries with ~= version specifier being incorrectly treated as local paths instead of being passed through to pip - by @Fridayai700. (#3447)

  • Fix factor selection via TOX_FACTORS environment variable producing wrong results because append + nargs="+" actions need nested list types for proper env var conversion - by @Fridayai700. (#3557)

  • Fix custom install_command being ignored when specified in TOML configuration (tox.toml/pyproject.toml) - by @Fridayai700. (#3574)

  • Fix env names containing dots (e.g. py3.11) losing their description in TOML configuration - by @Fridayai700. (#3590)

  • Run pre-commit on changelog.rst after towncrier build to ensure proper formatting before committing the release (#3717)

  • Fix type checker CI failure by adding completion extras to type and type-min environments so ty can resolve the argcomplete import - by @gaborbernat. (#3728)

Documentation - 4.37.0

  • Restructured documentation using the Diátaxis framework to separate Tutorial, How-to guides, Reference, and Explanation content for better discoverability and user experience. (#3718)

v4.36.1 (2026-02-17)

Bugfixes - 4.36.1

  • Report TOML parse errors during config discovery instead of silently ignoring them - by @rahuldevikar. (#3030)

  • Adopt CPython’s subprocess stream handling to fix deadlocks and improve performance when reading subprocess output (#3715)

Documentation - 4.36.1

  • Add Unix man page generation and installation support using sphinx-argparse-cli - by @gaborbernat. (#1409)

  • Document use of Python logging for plugin authors in the how-to guides, covering verbosity levels, coloring, and best practices — by @rahuldevikar. (#3449)

  • Add architecture documentation for new contributors under the development section - by @rahuldevikar (#3707)

v4.36.0 (2026-02-15)

Features - 4.36.0

  • Allow skip_missing_interpreters to be set per environment, overriding the global setting. This enables marking specific environments as optional while keeping others required. (#435)

  • Add --fail-fast CLI flag and fail_fast per-environment config option to stop executing remaining environments when the first failure occurs - by @gaborbernat. (#578)

  • Add shell completion support for bash, zsh, and fish via argcomplete - by @gaborbernat (#918)

  • Validate that configured extras exist in package metadata, raising a clear error for unknown extras - by @gaborbernat (#1113)

  • Add glob pattern support in depends (e.g. depends = py3*) to match environments by wildcard instead of listing them explicitly - by @gaborbernat (#1152)

  • Add disallow_pass_env configuration option to exclude specific environment variables after pass_env glob expansion - by @gaborbernat (#1387)

  • Support file: URIs in --installpkg (e.g. --installpkg file:///path/to/pkg.whl), including proper handling of percent-encoded characters - by @rahuldevikar. (#3498)

Bugfixes - 4.36.0

  • Raise an error when deps is configured on a PEP-517 packaging environment (e.g. .pkg), since build dependencies should be specified via the [build-system] table in pyproject.toml - by @rahuldevikar (#3412)

  • Follow FORCE_COLOR recommendations: any non-empty value now enables color (previously only yes, true, or 1 were accepted, and other values caused a crash). Also add support for TTY_COMPATIBLE (1 forces color, 0 disables it) — by @rahuldevikar. (#3579)

  • Return non-zero exit code from tox config when configuration exceptions occur. (#3649)

  • Fix flaky spinner test assertion caused by timing variations on slower systems. (#3692)

Documentation - 4.36.0

  • Document how to provide environments via toxfile.py inline plugins using tox_extend_envs and MemoryLoader - by @gaborbernat. (#828)

  • Document shell completion setup for bash, zsh, and fish in the CLI reference - by @gaborbernat (#918)

  • Document negative factor conditions and multi-factor combinations with negation in the INI configuration reference - by @gaborbernat (#3276)

  • Add a substitution quick reference table covering all available {...} replacement variables - by @gaborbernat (#3326)

  • Add TOML configuration reference with complete examples for tox.toml and pyproject.toml formats, and emphasize TOML as the recommended format throughout - by @gaborbernat (#3393)

  • Document the tox exec subcommand with usage examples in the how-to guides - by @gaborbernat (#3403)

  • Comprehensive documentation improvements: added how-to guides for tox exec, CI/CD, coverage, build backends, labels, migration, debugging, and extras; expanded plugin documentation with all hook examples and packaging guide; added env var handling guide, factor conditions reference, and substitution quick reference; integrated docstrfmt for consistent RST formatting; fixed docstring issues in source code - by @gaborbernat (#3475)

  • Update development.rst to reflect current standards: replace references to flake8/black/isort/pyupgrade with ruff, remove outdated Python 2.7 compatibility note, and fix CI config filename - by @rahuldevikar (#3483)

  • Drop setup.py mentions from the installation page — by @rahuldevikar. (#3588)

  • Restructure documentation following the Diataxis framework: add a step-by-step tutorial (getting_started.rst), consolidate how-to recipes (howto.rst), refocus the user guide on conceptual explanation, and move plugin docs into their own plugins/ subdirectory. Remove the obsolete tox 3-to-4 migration guide (upgrading.rst) and FAQ, redistributing still-relevant content into the appropriate sections. All configuration examples now show TOML first with INI alongside - by @gaborbernat (#3702)

Miscellaneous - 4.36.0

  • Switch type checker from mypy to ty - by @gaborbernat. (#3685)

  • Add GitHub Actions workflow dispatch for release preparation as alternative to local tox r -e release command - by @gaborbernat (#3704)

v4.35.0 (2026-02-12)

Features - 4.35.0

  • Show toxfile.py inline plugins in tox --version output, including any tox_append_version_info() result - by @rahuldevikar. (#3508)

Improved Documentation - 4.35.0

  • Document injected environment variables (TOX_ENV_NAME, TOX_WORK_DIR, TOX_ENV_DIR, TOX_PACKAGE, VIRTUAL_ENV, PYTHONIOENCODING, __TOX_ENVIRONMENT_VARIABLE_ORIGINAL_CI) that tox automatically sets when running commands - by @rahuldevikar. (#3514)

v4.34.1 (2026-01-09)

Bugfixes - 4.34.1

  • Fix wheel corruption errors when the build backend updates the file in place - by @gaborbernat. (#3667)

v4.34.0 (2026-01-08)

Features - 4.34.0

  • Support installing extras from the current project in dependency groups. – by @czaki. (#3561)

v4.33.0 (2026-01-02)

Features - 4.33.0

  • Add support for conditional set_env using PEP-496 environment markers. In INI format use VAR=value; marker syntax, in TOML format use set_env.VAR = { value = "...", marker = "..." } – by @gaborbernat. (#3663)

Bugfixes - 4.33.0

  • Added ‘LocalAppData’ to the default passed environment variables on Windows. (#3639)

Improved Documentation - 4.33.0

v4.32.0 (2025-10-24)

Bugfixes - 4.32.0

  • Expand braced range syntax in all internal sections of tox.ini (e.g. deps, testenv). Syntax like py3{10-14} can be used in those sections now. - by @marcosboger (#3571)

Improved Documentation - 4.32.0

  • Add Python 3.14 and 3.14t to config examples - by @cclauss (#3626)

Misc - 4.32.0

v4.31.0 (2025-10-09)

No significant changes.

v4.30.3 (2025-10-02)

Bugfixes - 4.30.3

  • Fix incorrect type annotation in PythonPathPackageWithDeps.__init__() where deps was annotated as Sequence[Package] but should be Sequence[Requirement] to match actual runtime usage - by @PreistlyPython (#3607)

  • Fix None appearing as the config filename in error output when the user’s default config file is corrupt. - by @kurtmckee (#3611)

v4.30.2 (2025-09-04)

Bugfixes - 4.30.2

  • Previously, when tox ran in an automatically provisioned environment, it could hang waiting for a PEP 517 build backend if used in conjunction with the --installpkg option. This has been fixed by properly tearing down the automatically provisioned environment after the tests. - by @vytas7 (#3600)

v4.30.1 (2025-09-03)

Bugfixes - 4.30.1

  • Prevent tox from hanging upon exit due to orphaned build threads and subprocesses when the --installpkg option is used with sdist. - by @vytas7 (#3530)

v4.30.0 (2025-09-03)

Features - 4.30.0

  • Add __TOX_ENVIRONMENT_VARIABLE_ORIGINAL_CI, which passes through the CI variable if present. This is intended for use by other libraries to detect if tox is running under CI. (#3442)

Bugfixes - 4.30.0

  • Makes the error message more clear when pyproject.toml file cannot be loaded or is missing expected keys. (#3578)

  • The tox_extend_envs() hook recently added in #3591 turned out to not work well with tox run. It was fixed internally, not to exhaust the underlying iterator on the first use.

    – by @webknjaz (#3598)

v4.29.0 (2025-08-29)

Features - 4.29.0

  • A new tox life cycle event is now exposed for use via Plugins API – by @webknjaz.

    The corresponding hook point is tox_extend_envs. It allows plugin authors to declare ephemeral environments that they can then populate through the in-memory configuration loader interface.

    This patch was made possible thanks to pair programming with @gaborbernat at PyCon US 2025. (#3510, #3591)

v4.28.4 (2025-07-31)

Features - 4.28.4

  • Pass ssh-agent variables SSH_AGENT_PID and SSH_AUTH_SOCK in pass_env by default. - by @daniilgankov (#3572)

v4.28.3 (2025-07-25)

No significant changes.

v4.28.2 (2025-07-25)

Bugfixes - 4.28.2

  • Don’t pass in the filter argument to tar.extractall on old Python versions - by @gaborbernat. (#3568)

v4.28.1 (2025-07-22)

Bugfixes - 4.28.1

v4.28.0 (2025-07-20)

Features - 4.28.0

  • Added constraints to allow specifying constraints files for all dependencies. (#3550)

  • Allow disabling tox plugins via the TOX_DISABLED_EXTERNAL_PLUGINS environment variable - by @gaborbernat. (#3468)

Improved Documentation - 4.28.0

  • The min_version/minversion config option is deprecated in favor of the requires option. (#3553)

v4.27.0 (2025-06-17)

Features - 4.27.0

  • Add free_threaded flag to to "python" entries in json output of --result-json. (#3534)

Bugfixes - 4.27.0

  • Fix dependency-group name normalization. (#3539)

  • Improves logging of environment variables by sorting them by key and redacting the values for the ones that are likely to contain secrets. (#3542)

v4.26.0 (2025-05-13)

Features - 4.26.0

  • Add support for free-threaded python builds. Factors like py313t will only pick builds with the GIL disabled while factors without trailing t will only pick builds without no-GIL support. (#3391)

  • Drop support for EOL Python 3.8. (#3527)

Bugfixes - 4.26.0

  • Fix a regression issue related to inability to use file| substitution option in nested set_env sections of ini configurations since tox4 update. (#2435)

  • Fix TypeError for HelpFormatter with Python 3.14 (#3523)

v4.25.0 (2025-03-27)

Features - 4.25.0

  • Add support for number ranges in generative environments, more details here. - by @mimre25 (#3502)

Bugfixes - 4.25.0

v4.24.2 (2025-03-07)

Bugfixes - 4.24.2

  • multiple source_type supports for the same filename. Like pyproject.toml can be load by both TomlPyProject & LegacyToml (#3117)

  • Support set_env = { file = "conf{/}local.env"} for TOML format - by @juditnovak. (#3474)

  • fix example on the docs (#3480)

    • --parallel-no-spinner now respects max CPU set by --parallel N (#3495)

Improved Documentation - 4.24.2

  • Updates the documentation for os.environ['KEY'] when the variable does not exist - by @jugmac00. (#3456)

v4.24.1 (2025-01-21)

Misc - 4.24.1

v4.24.0 (2025-01-21)

Features - 4.24.0

  • Add a schema command to produce a JSON Schema for tox and the current plugins.

Bugfixes - 4.24.0

  • Log exception name when subprocess execution produces one.

Improved Documentation - 4.24.0

  • Fix typo in docs/config.rst from {} to {:}.

  • Pass NIX_LD and NIX_LD_LIBRARY_PATH variables by default in pass_env to make generic binaries work under Nix/NixOS.

v4.23.2 (2024-10-22)

Misc - 4.23.2

v4.23.1 (2024-10-21)

Improved Documentation - 4.23.1

v4.23.0 (2024-10-16)

Features - 4.23.0

  • Add NETRC to the list of environment variables always passed through. (#3410)

Improved Documentation - 4.23.0

  • replace [tool.pyproject] and [tool.tox.pyproject] with [tool.tox] in config.rst (#3411)

v4.22.0 (2024-10-15)

Features - 4.22.0

v4.21.2 (2024-10-03)

Bugfixes - 4.21.2

  • Include tox.toml in sdist archives to fix test failures resulting from its lack. - by @mgorny (#3389)

v4.21.1 (2024-10-02)

Bugfixes - 4.21.1

  • Fix error when using requires within a TOML configuration file - by @gaborbernat. (#3386)

  • Fix error when using deps within a TOML configuration file - by @gaborbernat. (#3387)

  • Multiple fixes for the TOML configuration by @gaborbernat.:

    • Do not fail when there is an empty command within commands.

    • Allow references for set_env by accepting list of dictionaries for it.

    • Do not try to be smart about reference unrolling, instead allow the user to control it via the extend flag, available both for posargs and ref replacements.

    • The ref replacements raw key has been renamed to of. (#3388)

v4.21.0 (2024-09-30)

Features - 4.21.0

Improved Documentation - 4.21.0

  • Update Loader docs - by :user:ziima (#3352)

v4.20.0 (2024-09-18)

Features - 4.20.0

  • Separate the list dependencies functionality to a separate abstract class allowing code reuse in plugins (such as tox-uv) - by :gaborbernat`. (#3347)

v4.19.0 (2024-09-17)

Features - 4.19.0

  • Support pypy-<major>.<minor> environment names for PyPy environments - by @gaborbernat. (#3346)

v4.18.1 (2024-09-07)

Bugfixes - 4.18.1

  • Fix and test the string spec for the sys.executable interpreter (introduced in #3325) - by @hroncok (#3327)

Improved Documentation - 4.18.1

  • Changes the tox_env_teardown docstring to explain the hook is called after a tox env was teared down. (#3305)

v4.18.0 (2024-08-13)

Features - 4.18.0

  • Suppress spinner in parallel runs in CI - by @ziima. (#3318)

Bugfixes - 4.18.0

v4.17.1 (2024-08-07)

Bugfixes - 4.17.1

  • 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)

v4.17.0 (2024-08-05)

Features - 4.17.0

  • 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)

Bugfixes - 4.17.0

  • Add table with default environment variables per OS (#2753)

v4.16.0 (2024-07-02)

Bugfixes - 4.16.0

    • Add windir to the default list of Windows pass_env environment variables. - by @kurtmckee (#3302)

Improved Documentation - 4.16.0

    • Fix typo in configuration example and fix broken link to code style guide. - by @srenfo (#3297)

v4.15.1 (2024-06-05)

Features - 4.15.1

  • Fix skip_missing_interpreters option for package = wheel (#3269)

Bugfixes - 4.15.1

  • Fix section substitution with setenv. (#3262)

  • Allow ConfigSet.add_config to receive parameterized generics for of_type. (#3288)

v4.15.0 (2024-04-26)

Features - 4.15.0

  • 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)

Bugfixes - 4.15.0

  • 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)

Improved Documentation - 4.15.0

  • Rephrase --discover flag’s description to avoid confusion between paths and executables. - by @mimre25 (#3274)

v4.14.2 (2024-03-22)

Bugfixes - 4.14.2

  • Add provision arguments to ToxParser to fix crash when provisioning new tox environment without list-dependencies by @seyidaniels (#3190)

Improved Documentation - 4.14.2

  • Removed unused line from the fresh_subprocess documentation. (#3241)

v4.14.1 (2024-03-06)

Bugfixes - 4.14.1

  • Fix crash with fresh subprocess, if the build backend is setuptools automatically enable fresh subprocesses for build backend calls - by @gaborbernat. (#3235)

v4.14.0 (2024-03-05)

Features - 4.14.0

  • 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)

v4.13.0 (2024-02-16)

Features - 4.13.0

  • Extract virtual environment packaging code to its own base class not tied to virtualenv - by @gaborbernat. (#3221)

Improved Documentation - 4.13.0

  • 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)

v4.12.1 (2024-01-16)

Bugfixes - 4.12.1

  • Fixed bug where running with –installpkg and multiple envs could not clean up between tests (#3165)

v4.12.0 (2024-01-11)

Features - 4.12.0

  • Always pass FORCE_COLOR and NO_COLOR to the environment (#3172)

Bugfixes - 4.12.0

  • --parallel-no-spinner flag now implies --parallel (#3158)

Improved Documentation - 4.12.0

  • -Fix open an issue link in development.rst (#3179)

v4.11.4 (2023-11-27)

Bugfixes - 4.11.4

  • 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)

Improved Documentation - 4.11.4

v4.11.3 (2023-09-08)

Bugfixes - 4.11.3

  • Handle FileNotFoundError when the base_python interpreter doesn’t exist (#3105)

Improved Documentation - 4.11.3

  • Explain how plugins are registered and discovered - by @hashar. (#3116)

v4.11.2 (2023-09-07)

Bugfixes - 4.11.2

  • 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)

Improved Documentation - 4.11.2

v4.11.1 (2023-09-01)

Bugfixes - 4.11.1

  • Allow passing in multiple overrides using the ; character and fix , being used as splitting values - by @gaborbernat. (#3112)

v4.11.0 (2023-08-29)

Features - 4.11.0

  • Add support for setting build backend config_settings in the configuration file - by @gaborbernat. (#3090)

v4.10.0 (2023-08-21)

Features - 4.10.0

  • 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)

Bugfixes - 4.10.0

  • --override foo+=bar appending syntax will now work correctly when foo wasn’t defined in tox.ini. (#3100)

v4.9.0 (2023-08-16)

Features - 4.9.0

  • Disallow command line environments which are not explicitly specified in the config file - by @tjsmart. (#2858)

v4.8.0 (2023-08-12)

Features - 4.8.0

  • --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)

v4.7.0 (2023-08-08)

Features - 4.7.0

  • 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)

Bugfixes - 4.7.0

  • Update a regular expression in tests to match the exception message in both Python 3.12 and older. (#3065)

Improved Documentation - 4.7.0

v4.6.4 (2023-07-06)

Bugfixes - 4.6.4

  • Fix hang and zombie process on interrupt (CTRL-C). (#3056)

v4.6.3 (2023-06-19)

Bugfixes - 4.6.3

  • 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)

Improved Documentation - 4.6.3

  • Linked environment variable substitutions docs in set_env and pass_env config docs. (#3039)

v4.6.2 (2023-06-16)

Bugfixes - 4.6.2

  • Avoid cache collision between editable wheel build and normal wheel build – by @f3flight. (#3035)

v4.6.1 (2023-06-15)

No significant changes.

v4.6.0 (2023-06-05)

Features - 4.6.0

  • Added --list-dependencies and --no-list-dependencies CLI parameters. If unspecified, defaults to listing when in CI, but not otherwise. (#3024)

Misc - 4.6.0

v4.5.1 (2023-05-25)

Bugfixes - 4.5.1

v4.5.0 (2023-04-24)

Features - 4.5.0

  • 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)

Improved Documentation - 4.5.0

  • Add FAQ entry on how to test EOL Python versions by @jugmac00. (#2989)

v4.4.12 (2023-04-13)

Bugfixes - 4.4.12

  • Avoid race conditions in tests using the demo_pkg_inline fixture. (#2985)

v4.4.11 (2023-04-05)

Bugfixes - 4.4.11

  • Fixed an issue where a tox plugin couldn’t change the value of tox_root. (#2966)

v4.4.10 (2023-04-05)

Bugfixes - 4.4.10

  • Fix issue where work_dir was not correctly including tox_root for test runs. (#2933)

v4.4.9 (2023-04-05)

Bugfixes - 4.4.9

  • 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)

Improved Documentation - 4.4.9

  • Document running tox within a Docker container. (#1035)

  • Added python version 3.11 to installation.rst. (#2964)

v4.4.8 (2023-03-26)

Bugfixes - 4.4.8

  • 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)

v4.4.6 (2023-02-21)

Bugfixes - 4.4.6

  • 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)

v4.4.5 (2023-02-07)

Bugfixes - 4.4.5

  • 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)

v4.4.4 (2023-01-31)

Bugfixes - 4.4.4

v4.4.3 (2023-01-30)

Bugfixes - 4.4.3

  • 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)

v4.4.2 (2023-01-25)

Bugfixes - 4.4.2

  • 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)

v4.4.1 (2023-01-25)

Bugfixes - 4.4.1

  • 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)

v4.4.0 (2023-01-25)

Features - 4.4.0

  • Test environments now recognize boolean config keys 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)

Bugfixes - 4.4.0

  • When parsing command lines, use 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)

Improved Documentation - 4.4.0

  • Add information when command from list_dependencies_command configuration option is used. (#2883)

v4.3.5 (2023-01-18)

Bugfixes - 4.3.5

  • 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)

v4.3.4 (2023-01-17)

Bugfixes - 4.3.4

  • 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)

Misc - 4.3.4

v4.3.3 (2023-01-16)

Bugfixes - 4.3.3

  • 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)

v4.3.2 (2023-01-16)

Bugfixes - 4.3.2

  • 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)

v4.3.1 (2023-01-15)

Bugfixes - 4.3.1

  • 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)

v4.3.0 (2023-01-15)

Features - 4.3.0

  • 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)

v4.2.8 (2023-01-11)

Bugfixes - 4.2.8

  • Allow using package names with env markers for pip’s --no-binary and --only-binary options - by @q0w. (#2814)

v4.2.7 (2023-01-11)

Bugfixes - 4.2.7

  • 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 @stephenfin. (#2838)

  • Explicitly list wheel as requirement for the tests, as some of the tests error without it. (#2843)

  • tox has reverted support for Python factors that include PATCH release info (e.g. 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)

v4.2.6 (2023-01-06)

Bugfixes - 4.2.6

  • Handle properly pip --no-binary / --only-binary options in requirements.txt format files. (#2814)

v4.2.5 (2023-01-06)

Bugfixes - 4.2.5

  • 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)

v4.2.4 (2023-01-05)

Bugfixes - 4.2.4

  • 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)

v4.2.3 (2023-01-04)

Bugfixes - 4.2.3

  • 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)

v4.2.2 (2023-01-04)

Bugfixes - 4.2.2

  • 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)

v4.2.1 (2023-01-03)

Bugfixes - 4.2.1

  • Fix extracting extras from markers with more than 2 extras in an or chain - by @dconathan. (#2791)

v4.2.0 (2023-01-03)

Features - 4.2.0

  • Packaging environments now inherit from the pkgenv section, allowing to set all your packaging options in one place, and support the deps key to set additional dependencies that will be installed after pyproject.toml static requires but before backends dynamic requires - by @gaborbernat. (#2543)

Improved Documentation - 4.2.0

  • Document breaking changes with tox 4 and packaging environments - by @gaborbernat. (#2543)

  • Document how to handle environments whose names match tox subcommands - by @sirosen. (#2728)

v4.1.3 (2023-01-02)

Bugfixes - 4.1.3

Improved Documentation - 4.1.3

  • Add breaking-change documentation for empty install_command values - by @jayaddison. (#2695)

Misc - 4.1.3

v4.1.2 (2022-12-30)

Bugfixes - 4.1.2

  • Fix --skip-missing-interpreters behavior - by @q0w. (#2649)

  • Restore tox 3 behavior of showing the output of pip freeze, however now only active when running inside a CI environment - by @gaborbernat. (#2685)

  • Fix extracting extras from markers with many extras - by @q0w. (#2791)

v4.1.1 (2022-12-29)

Bugfixes - 4.1.1

  • Fix logging error with emoji in git branch name. (#2768)

Improved Documentation - 4.1.1

v4.1.0 (2022-12-29)

Features - 4.1.0

  • -f can be used multiple times and on hyphenated factors (e.g. -f py311-django -f py39) - by @sirosen. (#2766)

Improved Documentation - 4.1.0

  • Fix a grammatical typo in docs/user_guide.rst. (#2787)

v4.0.19 (2022-12-28)

Bugfixes - 4.0.19

  • Create temp_dir if not exists - by @q0w. (#2770)

v4.0.18 (2022-12-26)

Bugfixes - 4.0.18

  • Strip leading and trailing whitespace when parsing elements in requirement files - by @gaborbernat. (#2773)

v4.0.17 (2022-12-25)

Features - 4.0.17

  • Suppress a report output when verbosity = 0. (#2697)

Bugfixes - 4.0.17

  • Fix --sdistonly behavior. (#2653)

  • Override toxworkdir with –workdir. (#2654)

v4.0.16 (2022-12-20)

Bugfixes - 4.0.16

v4.0.15 (2022-12-19)

Bugfixes - 4.0.15

  • Fix tox auto-provisioning not working and relax min_version default from 4.0 to no version constraint - by @gaborbernat. (#2634)

  • Fix assertion in test_result_json_sequential when interpreter _base_executable is a hardlink (macOS homebrew) - by @masenf. (#2720)

  • Complex negative factor filters not working - by @gaborbernat. (#2747)

v4.0.14 (2022-12-18)

Bugfixes - 4.0.14

  • Do not include non test environment sections or factor filters in INI configuration to factor discovery - by @gaborbernat. (#2746)

v4.0.13 (2022-12-17)

Bugfixes - 4.0.13

  • A plain section in INI configuration matching a tox environment name shadowed the laters configuration - by @gaborbernat. (#2636)

  • Fix space not accepted in factor filter expression - by @gaborbernat. (#2718)

v4.0.12 (2022-12-16)

Bugfixes - 4.0.12

  • If tox is running in a tty, allocate a pty (pseudo terminal) for commands and copy termios attributes to show colors and improve interactive use - by @masenf. (#1773)

  • Fix python hash seed not being set - by @gaborbernat. (#2645)

  • Fix legacy CLI flags --pre, --force-deps, --sitepackages and --alwayscopy not working, and mark them as deprecated - by @gaborbernat. (#2690)

Improved Documentation - 4.0.12

  • Document user level config. (#2633)

v4.0.11 (2022-12-14)

Features - 4.0.11

  • Modified handling of NO_COLOR environment variable, consistent with de facto conventions: any non-empty string will enable NO_COLOR (disable colorized output); no NO_COLOR variable or NO_COLOR with an empty string will disable NO_COLOR (enable colorized output) - by @ptmcg. (#2719)

Bugfixes - 4.0.11

  • TOX_SKIP_ENV environment variable now works again, and can also be set via the CLI argument --skip-env for any command where -e can be set - by @mgedmin. (#2698)

  • tox config should only show env_list arguments by default instead of ALL - by @gaborbernat. (#2726)

v4.0.10 (2022-12-14)

Features - 4.0.10

  • Add py_dot_ver and py_impl constants to environments to show the current Python implementation and dot version (e.g. 3.11) for the current environment. These can be also used as substitutions in tox.ini - by @gaborbernat. (#2640)

Bugfixes - 4.0.10

  • --help now reports the default verbosity level (which is WARNING) correctly. (#2707)

v4.0.9 (2022-12-13)

Features - 4.0.9

v4.0.8 (2022-12-11)

Bugfixes - 4.0.8

  • Fix multiple substitution on factor filtering in tox.ini when multiple factor filters match - by @gaborbernat. (#2650)

  • Fix regression in requirements.txt parsing - by @gaborbernat. (#2682)

v4.0.7 (2022-12-11)

Bugfixes - 4.0.7

v4.0.6 (2022-12-10)

Features - 4.0.6

v4.0.5 (2022-12-09)

Bugfixes - 4.0.5

  • Normalize extra names passed in (fixes extra groups not being picked up during installation) - by @gaborbernat. (#2655)

v4.0.4 (2022-12-09)

Bugfixes - 4.0.4

  • Disable logging from distlib.util and filelock as these log messages are too verbose - by @gaborbernat. (#2655)

  • Use !r and repr() to better display erroneous values in exception from StrConverter.to_bool() - by @ptmcg. (#2665)

Improved Documentation - 4.0.4

  • Document that running --showconfig or --help-ini with the -v flag will add interleaved debugging information, whereas tox v3 added extra lines at the start - by @jugmac00. (#2622)

  • Document that tox v4 errors when using -U when defining dependencies via deps - by @jugmac00. (#2631)

v4.0.3 (2022-12-08)

Bugfixes - 4.0.3

  • Always set environment variable PYTHONIOENCODING to utf-8 to ensure tox works under Windows custom encodings - by @gaborbernat. (#2422)

  • Ensure change_dir is created if does not exist before executing commands - by @gaborbernat. (#2620)

  • Pass through NUMBER_OF_PROCESSORS on Windows as is needed for multiprocessing.cpu_count - by @gaborbernat. (#2629)

  • The core tox configuration now contains host_python key showing the host python executable path - by @gaborbernat. (#2630)

Improved Documentation - 4.0.3

  • Document that space separator is no longer valid for the passenv and instead one should use comma - by @gaborbernat. (#2615)

  • Document necessity to escape # within INI configuration - by @jugmac00. (#2617)

v4.0.2 (2022-12-07)

Bugfixes - 4.0.2

  • Unescaped comma in substitution should not be replaced during INI expansion - by @gaborbernat. (#2616)

  • tox --showconfig -e py311 reports tox section, though it should not - by @gaborbernat. (#2624)

v4.0.1 (2022-12-07)

Bugfixes - 4.0.1

v4.0.0 (2022-12-07)

Bugfixes - 4.0.0

  • The temporary folder within the tox environment was named .temp instead of .tmp - by @gaborbernat. (#2608)

Improved Documentation - 4.0.0

  • Enumerate breaking changes of tox 4 in the FAQ, and also list major new improvements - by @gaborbernat. (#2587)

  • Document in the FAQ that tox 4 will raise a warning when finding conflicting environment names - by @gaborbernat. (#2602)

v4.0.0rc4 (2022-12-06)

Bugfixes - 4.0.0rc4

Deprecations and Removals - 4.0.0rc4

  • Remove deprecated configuration option whitelist_externals which was replaced by allowlist_externals - by @jugmac00. (#2599)

v4.0.0rc3 (2022-12-05)

Features - 4.0.0rc3

  • Add --exit-and-dump-after flag that allows automatically killing tox if does not finish within the passed seconds, and dump the thread stacks (useful to debug tox when it seemingly hangs) - by @gaborbernat. (#2595)

Bugfixes - 4.0.0rc3

  • Ensure that two parallel tox instance invocations on different tox environment targets will work by holding a file lock onto the packaging operations (e.g., in bash tox4 r -e py311 &; tox4 r -e py310) - by @gaborbernat. (#2594)

  • Fix leaking backend processes when the build backend does not support editable wheels and fix failure when multiple environments exist that have a build backend that does not support editable wheels - by @gaborbernat. (#2595)

v4.0.0rc2 (2022-12-04)

Features - 4.0.0rc2

  • Support for recursive extras in Python package dependencies - by @gaborbernat. (#2567)

Bugfixes - 4.0.0rc2

  • Support in INI files for ignore exit code marker the - without a subsequent space too - by @gaborbernat. (#2561)

  • Ensure paths constructed by tox are stable by resolving relative paths to fully qualified one, this insures that running tox from a different folder than project root still generates meaningful paths - by @gaborbernat. (#2562)

  • Ensure only on run environment operates at a time on a packaging environment (fixes unexpected failures when running in parallel mode) - by @gaborbernat. (#2564)

  • Fallback to editable-legacy if package target is editable but the build backend does not have build_editable hook - by @gaborbernat. (#2567)

  • Allow reference replacement in INI configuration via keys that contain the - character - by @gaborbernat. (#2569)

  • Resolve symlinks when saving Python executable path - by @ssbarnea. (#2574)

  • Do not set COLUMNS or LINES environment to the current TTY size if already set by the user - by @gaborbernat. (#2575)

  • Add missing build[virtualenv] test dependency - by @ssbarnea. (#2576)

v4.0.0rc1 (2022-11-29)

Features - 4.0.0rc1

Bugfixes - 4.0.0rc1

  • Allow installing relative paths that go outside tox root folder. - by @ssbarnea. (#2366)

v4.0.0b3 (2022-11-27)

Features - 4.0.0b3

  • Improve coloring of logged commands - by @ssbarnea. (#2356)

  • Pass PROGRAMDATA, PROGRAMFILES(x86), PROGRAMFILES environments on Windows by default as it is needed for discovering the VS C++ compiler and start testing against 3.11 - by @gaborbernat. (#2492)

  • Support PEP-621 static metadata for getting package dependencies - by @gaborbernat. (#2499)

  • Add support for editable wheels, make it the default development mode and rename dev-legacy mode to editable-legacy - by @gaborbernat. (#2502)

Bugfixes - 4.0.0b3

  • Recognize TERM=dumb or NO_COLOR environment variables. - by @ssbarnea. (#1290)

  • Allow passing config directory without filename. - by @ssbarnea. (#2340)

  • Avoid ignored explicit argument ‘re’ console message. - by @ssbarnea. (#2342)

  • Display registered plugins with tox --version - by @mxd4. (#2358)

  • Allow --hash to be specified in requirements.txt files. - by @masenf. (#2373)

  • Avoid impossible minversion version requirements. - by @ssbarnea. (#2414)

Improved Documentation - 4.0.0b3

v4.0.0b2 (2022-04-11)

Features - 4.0.0b2

Bugfixes - 4.0.0b2

  • Fix CLI raises an error for -va with ignored explicit argument 'a' - by @gaborbernat. (#2343)

  • Do not interpolate values when parsing tox.ini configuration files - by @gaborbernat. (#2350)

Improved Documentation - 4.0.0b2

v4.0.0b1 (2022-02-05)

Features - 4.0.0b1

  • Display a hint for unrecognized argument CLI parse failures to use -- separator to pass arguments to commands - by @gaborbernat. (#2183)

  • Do not allow extending the config set beyond setup to ensures that all configuration values are visible via the config sub-command. - by @gaborbernat. (#2243)

  • Print a message when ignoring outcome of commands - by @gaborbernat. (#2315)

Bugfixes - 4.0.0b1

  • Fix type annotation is broken for tox.config.sets.ConfigSet.add_config() when adding a container type - by @gaborbernat. (#2233)

  • Insert TOX_WORK_DIR, TOX_ENV_NAME, TOX_ENV_DIR and VIRTUAL_ENV into the environment variables for all tox environments to keep contract with tox version 3 - by @gaborbernat. (#2259)

  • Fix plugin initialization order - core plugins first, then 3rd party and finally inline - by @gaborbernat. (#2264)

  • Legacy parallel mode should accept -p flag without arguments - by @gaborbernat. (#2299)

  • Sequential run fails because the packaging environment is deleted twice for sequential runs with recreate flag on - by @gaborbernat. (#2300)

  • Require Python 3.10 to generate docs - by @jugmac00. (#2321)

  • Environment assignment for output breaks when using -rv (when we cannot guess upfront the verbosity level from the CLI arguments) - by @gaborbernat. (#2324)

  • devenv command does not respect specified path - by @gaborbernat. (#2325)

Improved Documentation - 4.0.0b1

v4.0.0a10 (2022-01-04)

Features - 4.0.0a10

Bugfixes - 4.0.0a10

  • Fix CTRL+C is not stopping the process on Windows - by @gaborbernat. (#2159)

  • Fix list/depends commands can create tox package environment as runtime environment and display an error message - by @gaborbernat. (#2234)

Deprecations and Removals - 4.0.0a10

  • tox_add_core_config and tox_add_env_config now take a state: State argument instead of a configuration one, and Config not longer provides the envs property (instead users should migrate to State.envs) - by @gaborbernat. (#2275)

v4.0.0a9 (2021-09-16)

Features - 4.0.0a9

  • Expose the parsed CLI arguments on the main configuration object for plugins and allow plugins to define their own configuration section – by @gaborbernat. (#2191)

  • Let tox run fail when all envs are skipped – by @jugmac00. (#2195)

  • Expose the configuration loading mechanism to plugins to define and load their own sections. Add tox_add_env_config plugin hook called after the configuration environment is created for a tox environment and removed tox_configure. Add the main configuration object as argument to tox_add_core_config. Move the environment list method from the state to the main configuration object to allow its use within plugins – by @gaborbernat. (#2200)

  • Allow running code in plugins before and after commands via tox_before_run_commands and tox_after_run_commands plugin points – by @gaborbernat. (#2201)

  • Allow plugins to update the set_env and change the pass_env configurations – by @gaborbernat. (#2215)

Bugfixes - 4.0.0a9

  • Fix env variable substitutions with defaults containing colon (e.g. URL) – by @comabrewer. (#2182)

  • Do not allow constructing ConfigSet directly and implement __contains__ for Loader – by @gaborbernat. (#2209)

  • Fix old-new value on recreate cache miss-match are swapped – by @gaborbernat. (#2211)

  • Report fails when report does not support Unicode characters – by @gaborbernat. (#2213)

Improved Documentation - 4.0.0a9

  • Adopt furo theme, update our state diagram and description in user docs (SVG + light/dark variant), split the Python API into its own page from under the plugin page, and document plugin adoption under the tox-dev organization - by @gaborbernat. (#1881)

v4.0.0a8 (2021-08-21)

Features - 4.0.0a8

  • Add support for allowlist_externals, commands not matching error - by @gaborbernat. (#1127)

  • Add outcome of environments into the result json (–result-json) under the result key containing success boolean, exit_code integer and duration float value - by @gaborbernat. (#1405)

  • Add exec subcommand that allows users to run an arbitrary command within the tox environment (without needing to modify their configuration) - by @gaborbernat. (#1790)

  • Add check to validate the base Python names and the environments name do not conflict Python spec wise, when they do raise error if ignore_base_python_conflict is not set or False - by @gaborbernat. (#1840)

  • Allow any Unix shell-style wildcards expression for pass_env - by @gaborbernat. (#2121)

  • Add support for args_are_paths flag - by @gaborbernat. (#2122)

  • Add support for env_log_dir (compared to tox 3 extend content and keep only last run entries) - by @gaborbernat. (#2123)

  • Add support for {:} substitution in ini files as placeholder for the OS path separator - by @gaborbernat. (#2125)

  • When cleaning directories (for tox environment, env_log_dir, env_tmp_dir and packaging metadata folders) do not delete the directory itself and recreate, but instead just delete its content (this allows the user to cd into it and still be in a valid folder after a new run) - by @gaborbernat. (#2139)

  • Changes to help plugin development: simpler tox env creation argument list, expose python creation directly, allow skipping list dependencies install command for pip and executable is only part of the python cache for virtualenv - by @gaborbernat. (#2172)

Bugfixes - 4.0.0a8

Improved Documentation - 4.0.0a8

v4.0.0a7 (2021-07-28)

Features - 4.0.0a7

  • Add support for configuration taken from the setup.cfg file -by @gaborbernat. (#1836)

  • Add support for configuration taken from the pyproject.toml file, tox section legacy_tox_ini key - by @gaborbernat. (#1837)

  • Add configuration documentation - by @gaborbernat. (#1914)

  • Implemented [] substitution (alias for {posargs}) - by @hexagonrecursion. (#1928)

  • Implement [testenv] ignore_outcome - “a failing result of this testenv will not make tox fail” - by @hexagonrecursion. (#1947)

  • Inline plugin support via tox_.py. This is loaded where the tox config source is discovered. It’s a Python file that can contain arbitrary Python code, such as definition of a plugin. Eventually we’ll add a plugin that allows succinct declaration/generation of new tox environments - by @gaborbernat. (#1963)

  • Introduce the installer concept, and collect pip installation into a pip package, also attach to this the requirements file parsing which got a major rework - by @gaborbernat. (#1991)

  • Support CPython 3.10 -by @gaborbernat. (#2014)

Bugfixes - 4.0.0a7

  • Environments with a platform mismatch are no longer silently skipped, but properly reported - by @jugmac00. (#1926)

  • Port pip requirements file parser to tox to achieve full equivalency (such as support for the per requirement --install-option and --global-option flags) - by @gaborbernat. (#1929)

  • Support for extras with paths for Python deps and requirement files - by @gaborbernat. (#1933)

  • Due to a bug \{posargs} {posargs} used to expand to literal {posargs} {posargs}. Now the second {posargs} is expanded. \{posargs} {posargs} expands to {posargs} positional arguments here - by @hexagonrecursion. (#1956)

  • Enable setting a different upstream repository for the coverage diff report. This has been hardcoded to upstream/rewrite until now. by @jugmac00. (#1972)

  • Enable replacements (a.k.a section substitutions) for section names containing a dash in sections without the testenv: prefix - by @jugmac00, @obestwalter, @eumiro. (#1985)

  • Fix legacy list env command for empty/missing envlist - by @jugmac00. (#1987)

  • Requirements and constraints files handling got reimplemented, which should fix all open issues related to this area - by @gaborbernat. (#1991)

  • Use importlib instead of __import__ - by @dmendek. (#1995)

  • Evaluate factor conditions for command keys - by @jugmac00. (#2002)

  • Prefer f-strings instead of the str.format method - by @eumiro. (#2012)

  • Fix regex validation for SHA 512 hashes - by @jugmac00. (#2018)

  • Actually run all environments when ALL is provided to the legacy env command - by @jugmac00. (#2112)

  • Move from appdirs to platformdirs - by @gaborbernat. (#2117)

  • Move from toml to tomli - by @gaborbernat. (#2118)

Improved Documentation - 4.0.0a7

v4.0.0a6 (2021-02-15)

Features - 4.0.0a6

  • Add basic quickstart implementation (just use pytest with the current Python version) - by @gaborbernat. (#1829)

  • Support comments via the # character within the ini configuration (to force a literal # use \#) - by @gaborbernat. (#1831)

  • Add support for the install_command settings in the virtual env test environments - by @gaborbernat. (#1832)

  • Add support for the package_root setupdir ( Python scoped) configuration that sets the root directory used for packaging (the location of the historical setup.py and modern pyproject.toml). This can be set at root level, or at tox environment level (the later takes precedence over the former) - by @gaborbernat. (#1838)

  • Implement support for the --installpkg CLI flag - by @gaborbernat. (#1839)

  • Add support for the list_dependencies_command settings in the virtual env test environments - by @gaborbernat. (#1842)

  • Add support for the ignore_errors settings in tox test environments - by @gaborbernat. (#1843)

  • Add support for the pip_pre settings for virtual environment based tox environments - by @gaborbernat. (#1844)

  • Add support for the platform settings in tox test environments - by @gaborbernat. (#1845)

  • Add support for the recreate settings in tox test environments - by @gaborbernat. (#1846)

  • Allow Python test and packaging environments with version 2.7 - by @gaborbernat. (#1900)

  • Do not construct a requirements file for deps in virtualenv, instead pass content as CLI argument to pip - by @gaborbernat. (#1906)

  • Do not display status update environment reports when interrupted or for the final environment ran (because at the final report will be soon printed and makes the status update redundant) - by @gaborbernat. (#1909)

  • The _TOX_SHOW_THREAD environment variable can be used to print alive threads when tox exists (useful to debug when tox hangs because of some non-finished thread) and also now prints the pid of the local subprocess when reporting the outcome of an execution - by @gaborbernat. (#1915)

Bugfixes - 4.0.0a6

  • Normalize description text to collapse newlines and one or more than whitespace to a single space - by @gaborbernat. (#1829)

  • Support aliases in show config key specification (will print with the primary key) - by @gaborbernat. (#1831)

  • Show config no longer marks as unused keys that are inherited (e.g. if the key is coming from testenv section and our target is testenv:fix) - by @gaborbernat. (#1833)

  • --alwayscopy and --sitepackages legacy only flags do not work - by @gaborbernat. (#1839)

  • Fix handling of commands_pre/commands/commands_post to be in line with tox 3 (returned incorrect exit codes and post was not always executed) - by @gaborbernat. (#1843)

  • Support requirement files containing --hash constraints - by @gaborbernat. (#1903)

  • Fix a bug that caused tox to never finish when pulling configuration from a tox run environment that was never executed - by @gaborbernat. (#1915)

Deprecations and Removals - 4.0.0a6

    • Drop support for sdistsrc flag because introduces a significant complexity and is barely used (5 hits on a github search).

    • --skip-missing-interpreters, --notest, --sdistonly, --installpkg, --develop and --skip-pkg-install CLI flags are no longer available for devenv (enforce the only sane value for these).

    By @gaborbernat (#1839)

  • Remove Jenkins override support: this feature goes against the spirit of tox - blurring the line between the CI and local runs. It also singles out a single CI provider, which opens the door for other CIs wanting similar functionality. Finally, only 54 code file examples came back on a Github search, showing this is a not widely used feature. People who still want Jenkins override support may create a tox plugin to achieve this functionality - by @gaborbernat. (#1841)

v4.0.0a5 (2021-01-23)

Features - 4.0.0a5

  • Support the system_site_packages/sitepackages flag for virtual environment based tox environments - by @gaborbernat. (#1847)

  • Support the always_copy/alwayscopy flag for virtual environment based tox environments - by @gaborbernat. (#1848)

  • Support the download flag for virtual environment based tox environments - by @gaborbernat. (#1849)

  • Recreate virtual environment based tox environments when the virtualenv version changes - by @gaborbernat. (#1865)

Bugfixes - 4.0.0a5

  • Not all package dependencies are installed when different tox environments in the same run use different set of extras - by @gaborbernat. (#1868)

  • Support = separator in requirement file flags, directories as requirements and correctly set the root of the requirements file when using the --root CLI flag to change the root - by @gaborbernat. (#1853)

  • Cleanup local subprocess file handlers when exiting runs (fixes ResourceWarning: unclosed file errors when running with env PYTHONTRACEMALLOC=5 PYTHONDEVMODE=y under a Python built with --with-pydebug) - by @gaborbernat. (#1857)

  • Various small bugfixes:

    • honor updating default environment variables set by internal tox via set env (PIP_DISABLE_PIP_VERSION_CHECK)

    • do not multi-wrap HandledError in the ini file loader,

    • skipped environments are logged now with their fail message at default verbosity level,

    • fix an error that made the show configuration command crash when making the string of a config value failed,

    • support empty-new lines within the set env configurations replacements,

    by @gaborbernat. (#1864)

Improved Documentation - 4.0.0a5

v4.0.0a4 (2021-01-16)

Features - 4.0.0a4

  • Use .tox/4 instead of .tox4 folder (so ignores for tox 3 works for tox 4 too), reminder we’ll rename this to just .tox before public release, however to encourage testing tox 4 in parallel with tox 3 this is helpful - by @gaborbernat. (#1812)

  • Colorize the config command: section headers are yellow, keys are green, values remained white, exceptions are light red and comments are cyan - by @gaborbernat. (#1821)

Bugfixes - 4.0.0a4

  • Support legacy format (-cconstraint.txt) of constraint files in deps, and expand constraint files too when viewing inside the deps or calculating weather our environment is up to date or not - by @gaborbernat. (#1788)

  • When specifying requirements/editable/constraint paths within deps escape space, unless already escaped to support running specifying transitive requirements files within deps - by @gaborbernat. (#1792)

  • When using a provisioned tox environment requesting --recreate failed with AttributeError - by @gaborbernat. (#1793)

  • Fix RequirementsFile from tox is rendered incorrectly in config command - by @gaborbernat. (#1820)

  • Fix a bug in the configuration system where referring to the same named key in another env/section causes circular dependency error - by @gaborbernat. (#1821)

  • Raise ValueError with descriptive message when a requirements file specified does not exist - by @gaborbernat. (#1828)

  • Support all valid requirement file specification without delimiting space in the deps of the tox.ini - by @gaborbernat. (#1834)

Improved Documentation - 4.0.0a4

v4.0.0a3 (2021-01-13)

Features - 4.0.0a3

  • Raise exception when set env enters into a circular reference - by @gaborbernat. (#1779)

    • Raise exception when variable substitution enters into a circle.

    • Add {/} as substitution for os specific path separator.

    • Add {env_bin_dir} constant substitution.

    • Implement support for --discover flag - by @gaborbernat. (#1784)

Bugfixes - 4.0.0a3

  • Entries in the set_env does not reference environments from set_env - by @gaborbernat. (#1776)

  • env substitution does not uses values from set_env - by @gaborbernat. (#1779)

  • Adopt tox 3 base pass env list, by adding:

    • on all platforms: LANG, LANGUAGE, CURL_CA_BUNDLE, SSL_CERT_FILE , LD_LIBRARY_PATH and REQUESTS_CA_BUNLDE,

    • on Windows: SYSTEMDRIVE - by @gaborbernat. (#1780)

  • Fixed a bug that crashed tox where calling tox with the recreate flag and when multiple environments were reusing the same package - by @gaborbernat. (#1782)

    • Python version markers are stripped in package dependencies (after wrongfully being detected as an extra marker).

    • In packaging APIs do not set PYTHONPATH (to empty string) if backend-path is empty.

    • Fix commands parsing on Windows (do not auto-escape \ - instead users should use the new {\}, and on parsed arguments strip both ' and " quoted outcomes).

    • Allow windows paths in substitution set/default (the : character used to separate substitution arguments may also be present in paths on Windows - do not support single capital letter values as substitution arguments) - by @gaborbernat. (#1784)

  • Rework how we handle Python packaging environments:

    • the base packaging environment changed from .package to .pkg,

    • merged the sdist, wheel and dev separate packaging implementations into one, and internally dynamically pick the one that’s needed,

    • the base packaging environment always uses the same Python environment as tox is installed into,

    • the base packaging environment is used to get the metadata of the project (via PEP-517) and to build sdist and dev packages,

    • for building wheels introduced a new per env configurable option wheel_build_env, if the target Python major/minor and implementation for the run tox environment and the base package tox environment matches set this to .pkg, otherwise this is .pkg-{implementation}{major}{minor},

    • internally now packaging environments can create further packaging environments they are responsible of managing,

    • updated depends to use the packaging logic,

    • add support skip missing interpreters for depends and show config,

    by @gaborbernat. (#1804)

v4.0.0a2 (2021-01-09)

Features - 4.0.0a2

  • Add option to disable colored output, and support NO_COLOR and FORCE_COLOR environment variables - by @gaborbernat. (#1630)

Bugfixes - 4.0.0a2

  • Fix coverage generation in CI - by @gaborbernat. (#1551)

  • Fix the CI failures:

    • drop Python 3.5 support as it’s not expected to get to a release before EOL,

    • fix test using \n instead of os.linesep,

    • Windows Python 3.6 does not contain _overlapped.ReadFileInto

    • by @gaborbernat. (#1556)

Improved Documentation - 4.0.0a2

  • Add base documentation by merging virtualenv structure with tox 3 - by @gaborbernat. (#1551)

v4.0.0a1

  • First version all is brand new.

Warning

The current tox is the second iteration of implementation. From version 0.5 all the way to 3.X we numbered the first iteration. Version 4.0.0a1 is a complete rewrite of the package, and as such this release history starts from there. The old changelog is still available in the legacy branch documentation.