NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
PyPI, #134 most downloaded on PyPI
Virtual Python Environment builder
Latest stable
21.15.12
Last release today
21 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
19 years old
322 releases Β· first in 2007
Drag across the ruler to compare, or tap a release to open it.
Make seed images in app-data read-only, including their directories on POSIX. In a --symlink-app-data environment pip install --ignore-installed of a
--symlink-app-data environment pip install --ignore-installed of a seed package now fails with a permission error instead of changing the image shared with other environments. Bytecode cache directories and copied seed packages stay writable (#3757) by @gaborbernat. (#3620)Make seed images in app-data read-only, including their directories on POSIX. In a --symlink-app-data environment pip install --ignore-installed of a seed package now fails with a permission error instead of changing the image shared with other environments. Bytecode cache directories and copied seed packages stay writable (3757) by gaborbernat. (3620)
Isolate custom-index seed wheels in app-data. Without a custom index setting, a private wheel can fill a missing pin in a dedicated cache. Upgraders must download pins missing from the bundle again before going offline. Old cached wheels and images remain on disk (3756) by gaborbernat.
Your coding agent can read these notes before it upgrades. Set up the MCP server β
Restore the interpreter search path check for copied POSIX CPython environments created with the stdlib venv creator. An unsafe search path stops crea
--clear removes the existing environment (#3754) by @gaborbernat.Restore the interpreter search path check for copied POSIX CPython environments created with the stdlib venv creator. An unsafe search path stops creation before --clear removes the existing environment (3754) by gaborbernat.
β¦that lists only a few options, including the deprecated --wheel . The error message is now printed on its own ( #3749 ) by @gaborbernat .
venv creator leaves files named for the previous interpreter (#3753) by @gaborbernat. (#3751)venv creator. Shared directories retain their mode unless the copy needs temporary protection. Linux runtimes with default ACL lookup can restore owner execute when the umask alone removes it (#3710) by @gaborbernat.--copies. They reject unsafe library directories and unexpected standard-library zips, and warn when another account could change a search directory after creation. Use --symlinks or a private parent directory to avoid that risk (#3721) by @gaborbernat.cmd.exe (#3719) by @gaborbernat.VIRTUAL_ENV, PATH, and PKG_CONFIG_PATH retain the original path bytes. If the codec cannot represent the new environment, the current environment stays active (#3743) by @gaborbernat.TCL_LIBRARY and TK_LIBRARY from pointing at different directories when the activation script cannot reproduce the interpreter's library path bytes. Non-ASCII paths from the current UTF-8 environment still work (#3743) by @gaborbernat.virtualenv.ini in the configuration directory when migrating app data to the cache on macOS and Windows (#3742) by @gaborbernat.tcsh could misread quotes after prompt text in Big5-HKSCS or turn a destination character into a PATH separator after switching to the C locale. BSD csh now displays a single backslash in non-ASCII prompts. Generated .csh files with non-ASCII values may contain raw bytes rather than valid UTF-8 (#3687) by @gaborbernat.PYTHONPATH separator (#3716) by @gaborbernat.-vv and Creator.debug) when the interpreter uses PYTHONSAFEPATH or an isolated ._pth file (#3748) by @gaborbernat.PIP_* settings or pip configuration. The seed install ignores PIP_*; later pip commands still use them (#3728) by @gaborbernat.stat failed (#3691) by @gaborbernat.virtualenv --upgrade-embed-wheels exit with status 1 and log one could not upgrade error per distribution when an upgrade fails, instead of printing a thread traceback for each and exiting with 0 (#3747) by @gaborbernat.--reset-app-data. Skip default caches owned by another non-root user, including during migration and in read-only mode. An explicit --app-data path keeps its own ownership policy (#3742) by @gaborbernat.pydoc alias on deactivate, also after switching between environments, instead of removing it (#3750) by @gaborbernat.--symlinks (#3702) by @gaborbernat..egg-info metadata outside the virtual environment (#3696) by @gaborbernat.histchars when sourcing activate.csh. The script now reads its generated literals with the default history character, so a custom setting cannot reinterpret a prompt or path as shell syntax (#3687) by @gaborbernat.PATH, PROMPT, PYTHONHOME, the Tcl and Tk library paths, and PKG_CONFIG_PATH. Quoted path entries retain their punctuation with delayed expansion on or off (#3731) by @gaborbernat.TK_LIBRARY is unset (#3743) by @gaborbernat.pyvenv.cfg cannot record without changing their location, before modifying an existing environment (#3740) by @gaborbernat..pth files against the environment before the host paths when using activate_this.py, while keeping the standard library ahead of site-packages during those imports (#3727) by @gaborbernat.--extra-search-dir entry that is a file, such as a wheel, the same way a missing path is skipped. Seeding used to fail with NotADirectoryError, reported as a failure to download wheels (#3737) by @gaborbernat.--extra-search-dir command-line value. Empty --python and --try-first-with items from environment variables or the config file are skipped too, so they no longer select the running interpreter (#3737) by @gaborbernat.RECORD and top_level.txt files when replacing seed packages in an existing environment (#3699) by @gaborbernat.virtualenv env -p, from printing a usage line that lists only a few options, including the deprecated --wheel. The error message is now printed on its own (#3749) by @gaborbernat.--seeder pip, unreadable package directories now fail and outside hard-linked files remain unchanged (#3728) by @gaborbernat.pydoc.bat when the batch file is called by path without activation, even if another Python is first on PATH. The launcher preserves literal ! characters in its own directory name when delayed expansion is enabled (#3732) by @gaborbernat.--creator venv, install only the selected activation scripts. Remove stale standard-library activators when reusing an environment (#3744) by @gaborbernat.--symlink-app-data makes a cached image read-only (#3697) by @gaborbernat.Delete app data trees holding files past the 260 character path limit on Windows without long path support. --reset-app-data failed with WinError 145
--reset-app-data failed with WinError 145 after removing part of the seed pip image, so later environments got a pip that could not be imported, and the staging folder of a killed seed image build failed every later run (#3568) by @darrenhuai and @gaborbernat.--symlink-app-data no longer fails with FileExistsError and leaves it without pip when pip was upgraded or reinstalled by pip itself, including bytecode written after that install (#3577) by @gaborbernat.--upgrade-embed-wheels runs. The yank flags come from the index pip is configured with, so an index that needs keyring credentials or a client certificate keeps its logged releases (#3570) by @AP24110011695 and @gaborbernat.bash, csh and PowerShell activators from adding an empty entry when PATH is empty. On POSIX an empty entry searches the current directory, so activating with an empty PATH put it on the search path (#3572) by @gaborbernat.Delete app data trees holding files past the 260 character path limit on Windows without long path support. --reset-app-data failed with WinError 145 after removing part of the seed pip image, so later environments got a pip that could not be imported, and the staging folder of a killed seed image build failed every later run (3568) by darrenhuai and gaborbernat.
Reseeding an environment with --symlink-app-data no longer fails with FileExistsError and leaves it without pip when pip was upgraded or reinstalled by pip itself, including bytecode written after that install (3577) by gaborbernat.
Stop seeding a release yanked from the package index once the next periodic update or --upgrade-embed-wheels runs. The yank flags come from the index pip is configured with, so an index that needs keyring credentials or a client certificate keeps its logged releases (3570) by AP24110011695 and gaborbernat.
Stop the bash, csh and PowerShell activators from adding an empty entry when PATH is empty. On POSIX an empty entry searches the current directory, so activating with an empty PATH put it on the search path (3572) by gaborbernat.
Defer eligible imports on Python 3.15 until virtualenv uses them, reducing package and CLI startup time (3580) by gaborbernat.
Accept activators listed on separate lines in the config file or the VIRTUALENV_ACTIVATORS environment variable, as the documentation describes for mu
activators listed on separate lines in the config file or the VIRTUALENV_ACTIVATORS environment variable, as the documentation describes for multi-value options. Such a value was rejected as an unknown activator (#3566) by @arpangupta1805 and @gaborbernat.pydoc alias is defined. Since 21.14.9 the alias was expanded in the pydoc function definition, so source bin/activate stopped with a syntax error and did not activate (#3563) by @arpangupta1805.--read-only-app-data when the app data already holds the seed wheels. Making the embedded wheels available tried to create a lock file in the read-only wheel folder, so seeding failed with a PermissionError (#3565) by @arpangupta1805.pip seeder with the embedded pip that supports the Python version of the environment, not the one of the Python running virtualenv. Seeding a Python 3.9 environment with --seeder pip from Python 3.10 or later failed, as the newer pip does not run on Python 3.9 (#3564) by @arpangupta1805 and @gaborbernat.Accept activators listed on separate lines in the config file or the VIRTUALENV_ACTIVATORS environment variable, as the documentation describes for multi-value options. Such a value was rejected as an unknown activator (3566) by arpangupta1805 and gaborbernat.
Activate the environment again from bash and zsh when a pydoc alias is defined. Since 21.14.9 the alias was expanded in the pydoc function definition, so source bin/activate stopped with a syntax error and did not activate (3563) by arpangupta1805.
Create environments from the zipapp with --read-only-app-data when the app data already holds the seed wheels. Making the embedded wheels available tried to create a lock file in the read-only wheel folder, so seeding failed with a PermissionError (3565) by arpangupta1805.
Run the pip seeder with the embedded pip that supports the Python version of the environment, not the one of the Python running virtualenv. Seeding a Python 3.9 environment with --seeder pip from Python 3.10 or later failed, as the newer pip does not run on Python 3.9 (3564) by arpangupta1805 and gaborbernat.
Fix seeding from a deep --app-data folder on Windows without long path support, which failed with WinError 206 or WinError 3 . The check for whether t
--app-data folder on Windows without long path support, which failed with WinError 206 or WinError 3. The check for whether the seed wheel image needs its 8.3 short path now counts the separator and the 248 character limit on directories, and the install reads the image through its short path whether it was just built or reused from an earlier run (#3545) by @darrenhuai and @gaborbernat.VIRTUALENV_NO_DOWNLOAD=1 and no_download = true: the parser ignored both, so download = true in the configuration file overrode the environment variable. The opt-out now wins when both flags are set at the same level, as it does for --no-venv-redirect (#3533) by @darrenhuai and @gaborbernat.>=3.9,<3.10 as one value when it is given through VIRTUALENV_PYTHON or the config file on a single line. It was split at the comma, so the upper bound was dropped and a newer interpreter could be picked (#3552) by @hemtilva and @gaborbernat..venv in the parent folder alone when --venv-redirect is on, instead of hanging forever after the environment is created while waiting to read from it (#3523) by @darrenhuai and @gaborbernat.VIRTUALENV_VENV_REDIRECT=1 write the .venv redirect when no_venv_redirect = true is set in the configuration file, since environment variables rank above the configuration file (#3525) by @darrenhuai and @gaborbernat.--pip 26.3.0 or --pip v26.3 against the bundled, cached or extra search dir wheel by PEP 440 equality rather than by exact string. A spelling that differs from the wheel filename skipped the bundled wheel and downloaded the same release from PyPI, even under --no-download, so it failed offline. The embed, bundle and none keywords now accept surrounding whitespace, such as a trailing carriage return (#3526) by @darrenhuai and @gaborbernat.VIRTUALENV_CREATOR, VIRTUALENV_SEEDER or virtualenv.ini sets a creator or seeder that is not available, as VIRTUALENV_DISCOVERY already does. The error used to be No implementation for PythonInfo(...), which blamed the interpreter (#3524) by @darrenhuai and @gaborbernat.sys.exec_prefix at the environment when activate_this.py activates it, as sys.prefix already is. Before, sysconfig kept the platlib path at the base Python on POSIX, so pip in the activated process installed compiled packages into the system site-packages instead of the environment (#3547) by @HarshJamgaonkar05 and @gaborbernat.RECORD file has no final newline (#3527) by @Jinyong-Li and @gaborbernat.RECORD files as CSV, preserving filenames containing commas, quotes or newlines during seeding and removal of an existing seed package (#3559) by @Ramji-Purwar and @gaborbernat.--app-data, and a whitespace-only VIRTUALENV_APP_DATA. An empty one, and on Windows one made only of spaces, made the current directory the cache, so --reset-app-data deleted it (#3522) by @darrenhuai and @gaborbernat.pydoc function when deactivating an environment, including after repeated activation or switching environments (#3529) by @subotac and @gaborbernat.SystemExit: None as an error after a successful virtualenv --upgrade-embed-wheels. The command already exited with status 0; its output now ends with the upgrade summary instead of a line that looks like a crash (#3532) by @darrenhuai and @gaborbernat.virtualenv.seed.embed.base_embed as the module distributions patch to turn PERIODIC_UPDATE_ON_BY_DEFAULT off in the distribution maintainer guide; it pointed at virtualenv.seed.wheels.embed, which has no such name (#3534) by @darrenhuai and @gaborbernat.Fix seeding from a deep --app-data folder on Windows without long path support, which failed with WinError 206 or WinError 3. The check for whether the seed wheel image needs its 8.3 short path now counts the separator and the 248 character limit on directories, and the install reads the image through its short path whether it was just built or reused from an earlier run (3545) by darrenhuai and gaborbernat.
Honor VIRTUALENV_NO_DOWNLOAD=1 and no_download = true: the parser ignored both, so download = true in the configuration file overrode the environment variable. The opt-out now wins when both flags are set at the same level, as it does for --no-venv-redirect (3533) by darrenhuai and gaborbernat.
Keep a version specifier such as >=3.9,<3.10 as one value when it is given through VIRTUALENV_PYTHON or the config file on a single line. It was split at the comma, so the upper bound was dropped and a newer interpreter could be picked (3552) by hemtilva and gaborbernat.
Leave a FIFO named .venv in the parent folder alone when --venv-redirect is on, instead of hanging forever after the environment is created while waiting to read from it (3523) by darrenhuai and gaborbernat.
Make VIRTUALENV_VENV_REDIRECT=1 write the .venv redirect when no_venv_redirect = true is set in the configuration file, since environment variables rank above the configuration file (3525) by darrenhuai and gaborbernat.
Match a pinned seed version such as --pip 26.3.0 or --pip v26.3 against the bundled, cached or extra search dir wheel by PEP 440 equality rather than by exact string. A spelling that differs from the wheel filename skipped the bundled wheel and downloaded the same release from PyPI, even under --no-download, so it failed offline. The embed, bundle and none keywords now accept surrounding whitespace, such as a trailing carriage return (3526) by darrenhuai and gaborbernat.
Name the option, the value and the available choices when VIRTUALENV_CREATOR, VIRTUALENV_SEEDER or virtualenv.ini sets a creator or seeder that is not available, as VIRTUALENV_DISCOVERY already does. The error used to be No implementation for PythonInfo(...), which blamed the interpreter (3524) by darrenhuai and gaborbernat.
Pass the environment supplied to the Python API to the stdlib venv creator, symlink seed compilation and periodic wheel update subprocesses instead of inheriting the parent process environment (3542) by Muneer320 and gaborbernat.
Point sys.exec_prefix at the environment when activate_this.py activates it, as sys.prefix already is. Before, sysconfig kept the platlib path at the base Python on POSIX, so pip in the activated process installed compiled packages into the system site-packages instead of the environment (3547) by HarshJamgaonkar05 and gaborbernat.
Preserve separate file records when seeding from a wheel whose RECORD file has no final newline (3527) by Jinyong-Li and gaborbernat.
Read and write seed package RECORD files as CSV, preserving filenames containing commas, quotes or newlines during seeding and removal of an existing seed package (3559) by Ramji-Purwar and gaborbernat.
Reject an empty or whitespace-only --app-data, and a whitespace-only VIRTUALENV_APP_DATA. An empty one, and on Windows one made only of spaces, made the current directory the cache, so --reset-app-data deleted it (3522) by darrenhuai and gaborbernat.
Release the thread lock for each nested app-data lock acquisition, so waiting threads can acquire it after the outermost context exits (3558) by Ramji-Purwar and gaborbernat.
Restore an existing PowerShell pydoc function when deactivating an environment, including after repeated activation or switching environments (3529) by subotac and gaborbernat.
Restore module exports renamed or removed by the simplint 0.11.0 update so existing imports continue to work (3548) by gaborbernat.
Stop logging SystemExit: None as an error after a successful virtualenv --upgrade-embed-wheels. The command already exited with status 0; its output now ends with the upgrade summary instead of a line that looks like a crash (3532) by darrenhuai and gaborbernat.
Name virtualenv.seed.embed.base_embed as the module distributions patch to turn PERIODIC_UPDATE_ON_BY_DEFAULT off in the distribution maintainer guide; it pointed at virtualenv.seed.wheels.embed, which has no such name (3534) by darrenhuai and gaborbernat.
Write the wheel and zipapp SBOMs with python-sbom instead of virtualenv's own generator. Each bundled seed wheel is now identified by its path inside the wheel rather than by its PyPI purl, so the wheel's and the zipapp's SBOMs name it alike; the metadata also names the SBOM file and its repository, and the build tools include python-sbom and virtualenv's content provider (3530) by gaborbernat.
Clear inherited PYTHONHOME during PowerShell, Nushell, and programmatic activation so child interpreters use the environment's standard library. Prese
PYTHONHOME during PowerShell, Nushell, and programmatic activation so child interpreters use the environment's standard library. Preserve empty values when Bash and fish deactivate (#3517) by @gaborbernat.PATH entries during programmatic activation, including entries in an otherwise nonempty value. On POSIX, an empty entry searches the current directory (#3513) by @qodelicious and @gaborbernat.PYTHONHOME during C shell activation and restore its original value on deactivation. An inherited value could previously prevent the environment's Python interpreter from starting (#3514) by @abhishekcpp007 and @gaborbernat.Clear inherited PYTHONHOME during PowerShell, Nushell, and programmatic activation so child interpreters use the environment's standard library. Preserve empty values when Bash and fish deactivate (3517) by gaborbernat.
Remove empty PATH entries during programmatic activation, including entries in an otherwise nonempty value. On POSIX, an empty entry searches the current directory (3513) by qodelicious and gaborbernat.
Unset PYTHONHOME during C shell activation and restore its original value on deactivation. An inherited value could previously prevent the environment's Python interpreter from starting (3514) by abhishekcpp007 and gaborbernat.
π PyPI release π Full Changelog
Upgrade embedded wheels: pip to 26.3 from 26.2.2 ( #3508 ) by @gaborbernat .
26.3 from 26.2.2 (#3508) by @gaborbernat.Upgrade embedded wheels: pip to 26.3 from 26.2.2 (3508) by gaborbernat.
Add the environment's lib/pkgconfig to PKG_CONFIG_PATH when activating from xonsh, and restore the previous value or unset it again on deactivate , as
lib/pkgconfig to PKG_CONFIG_PATH when activating from xonsh, and restore the previous value or unset it again on deactivate, as the other activators already do (#3505) by @darrenhuai and @gaborbernat.virtualenv.ini values without interpolation, as environment variables and command line flags already are. A value holding a %, such as prompt = 50% done, was ignored without any message. %% and %(name)s are now kept as written, so write a single % (#3501) by @darrenhuai and @gaborbernat./dev/null, a FIFO or a socket, or that sits inside one, with a usage error instead of a NotADirectoryError once creation has started. A regular file now gets the same is not a directory message instead of is a file (#3504) by @darrenhuai and @gaborbernat.TCL_LIBRARY and TK_LIBRARY to the interpreter's Tcl/Tk paths in activate.nu, as the other activators do. Nushell activation used to leave both variables as they were (#3502) by @darrenhuai and @gaborbernat.KSH_ARRAYS is set at activation. Since 21.14.13 the prompt read an empty psvar entry under that option and showed () instead of the name (#3506) by @PDGGK and @gaborbernat.VIRTUALENV_OVERRIDE_APP_DATA and an empty VIRTUALENV_CONFIG_FILE as unset, as virtualenv already does for its option variables. An empty app-data override, or on Windows one made of spaces, made the current directory the cache, so --reset-app-data deleted it, and an empty config file path logged an error on every run (#3503) by @darrenhuai and @gaborbernat.Add the environment's lib/pkgconfig to PKG_CONFIG_PATH when activating from xonsh, and restore the previous value or unset it again on deactivate, as the other activators already do (3505) by darrenhuai and gaborbernat.
Read virtualenv.ini values without interpolation, as environment variables and command line flags already are. A value holding a %, such as prompt = 50% done, was ignored without any message. %% and %(name)s are now kept as written, so write a single % (3501) by darrenhuai and gaborbernat.
Reject a destination that already exists but is not a directory, such as /dev/null, a FIFO or a socket, or that sits inside one, with a usage error instead of a NotADirectoryError once creation has started. A regular file now gets the same is not a directory message instead of is a file (3504) by darrenhuai and gaborbernat.
Set TCL_LIBRARY and TK_LIBRARY to the interpreter's Tcl/Tk paths in activate.nu, as the other activators do. Nushell activation used to leave both variables as they were (3502) by darrenhuai and gaborbernat.
Show the environment name in the zsh prompt when KSH_ARRAYS is set at activation. Since 21.14.13 the prompt read an empty psvar entry under that option and showed () instead of the name (3506) by PDGGK and gaborbernat.
Treat an empty or blank VIRTUALENV_OVERRIDE_APP_DATA and an empty VIRTUALENV_CONFIG_FILE as unset, as virtualenv already does for its option variables. An empty app-data override, or on Windows one made of spaces, made the current directory the cache, so --reset-app-data deleted it, and an empty config file path logged an error on every run (3503) by darrenhuai and gaborbernat.
Build the default application data folder only when no folder was given through --app-data , VIRTUALENV_APP_DATA or the configuration file, so --read-
--app-data, VIRTUALENV_APP_DATA or the configuration file, so --read-only-app-data with an explicit folder works when the default folder is missing, and writable runs stop creating an unused one. Folders from VIRTUALENV_APP_DATA and the configuration file now get the same checks as --app-data (#3488) by @darrenhuai and @gaborbernat.METADATA, RECORD or INSTALLER (#3487) by @darrenhuai and @gaborbernat.-p/--python and --try-first-with replace the interpreters set by VIRTUALENV_PYTHON, VIRTUALENV_TRY_FIRST_WITH or the configuration file instead of being merged with them, so the configured interpreter no longer wins over the one asked for and a -p that finds nothing fails instead of falling back to it. Try several VIRTUALENV_PYTHON values in the order given rather than starting with the second (#3494) by @darrenhuai and @gaborbernat.python.exe, or its seeded packages are read-only, instead of failing with PermissionError (#3492) by @darrenhuai and @gaborbernat.VENV in virtualenv --clear "$VENV" deleted the working directory. Pass . to create the environment in the current directory (#3491) by @darrenhuai and @gaborbernat.deactivate.bat when PROMPT was undefined at activation, instead of leaving the environment name in front of it (#3489) by @darrenhuai.PATH again in deactivate.bat when it was undefined at activation, instead of leaving the environment's Scripts folder on it, and stop a second activate.bat from adding that folder twice (#3493) by @darrenhuai and @gaborbernat.Keep the name of a seeded console_scripts entry that contains digits but does not end in a version, such as python3-config or 2to3 , instead of trunca
console_scripts entry that contains digits but does not end in a version, such as python3-config or 2to3, instead of truncating it at the first digit; python3-config overwrote the environment's python executable (#3451) by @JingHao-Leon and @gaborbernat.-v, -q, -p and --try-first-with option once instead of once per internal parsing pass, so Session.verbosity is 3 rather than 9 for a single -v (#3457) by @darrenhuai and @gaborbernat.VIRTUALENV_SYMLINK_APP_DATA or symlink_app_data in the config file turns on symlink seeding on a host that cannot create symlinks, such as Windows without the symlink privilege (#3465) by @darrenhuai and @gaborbernat.-vv output and Creator.debug) without PYTHONPATH and with the environment passed to cli_run, so the reported sys.path no longer lists the caller's PYTHONPATH entries (#3474) by @RaphaelFakhri and @gaborbernat.Keep the name of a seeded console_scripts entry that contains digits but does not end in a version, such as python3-config or 2to3, instead of truncating it at the first digit; python3-config overwrote the environment's python executable (3451) by JingHao-Leon and gaborbernat.
Copy the content of a symlinked directory when a tree is copied into an environment, instead of dropping it (3454) by JingHao-Leon and gaborbernat.
Count each -v, -q, -p and --try-first-with option once instead of once per internal parsing pass, so Session.verbosity is 3 rather than 9 for a single -v (3457) by darrenhuai and gaborbernat.
Copy the seed packages instead of failing when VIRTUALENV_SYMLINK_APP_DATA or symlink_app_data in the config file turns on symlink seeding on a host that cannot create symlinks, such as Windows without the symlink privilege (3465) by darrenhuai and gaborbernat.
Run the interpreter that collects the target debug information (-vv output and Creator.debug) without PYTHONPATH and with the environment passed to cli_run, so the reported sys.path no longer lists the caller's PYTHONPATH entries (3474) by RaphaelFakhri and gaborbernat.
Bundle dependencies for Python 3.15 in the standalone zipapp and stop bundling Python 3.8, which is outside the package's supported range ( #3458 ) by
Bundle dependencies for Python 3.15 in the standalone zipapp and stop bundling Python 3.8, which is outside the package's supported range (3458) by gaborbernat.
Publish GitHub Releases with categorized notes from the tagged changelog, retaining the zipapp, SBOM, and PyPI links (3458) by gaborbernat.
Stop bash running commands from --prompt or an environment name containing $(...) , backticks or a backslash after shopt -s promptvars , set -o posix
--prompt or an environment name containing $(...), backticks or a backslash after shopt -s promptvars, set -o posix, or in a child shell that inherits an exported PS1 (GHSA-cx6f-vjhg-g3cc); reported by @rozzkml. zsh now draws the prompt from psvar[9], which is never parsed as shell syntax. (#3466) by @gaborbernat..venv redirect and the wheel RECORD with exclusive create, so a link planted after the existence check cannot redirect the write. On POSIX, replace a read-only .venv redirect that points at a virtualenv. (#3466) by @gaborbernat.Stop bash running commands from --prompt or an environment name containing $(...), backticks or a backslash after shopt -s promptvars, set -o posix, or in a child shell that inherits an exported PS1 (GHSA-cx6f-vjhg-g3cc); reported by rozzkml. zsh now draws the prompt from psvar[9], which is never parsed as shell syntax. (3466) - by gaborbernat.
Write the .venv redirect and the wheel RECORD with exclusive create, so a link planted after the existence check cannot redirect the write. On POSIX, replace a read-only .venv redirect that points at a virtualenv. (3466) - by gaborbernat.
Upgrade the embedded setuptools wheel from 84.0.0 to 84.2.1 and the embedded pip wheel from 26.2.1 to 26.2.2 .
84.0.0 to 84.2.1 and the embedded pip wheel from 26.2.1 to 26.2.2. (#3452)Upgrade the embedded setuptools wheel from 84.0.0 to 84.2.1 and the embedded pip wheel from 26.2.1 to 26.2.2. (3452)
Search all directories supplied by repeated --extra-search-dir options instead of keeping only the last group. ( #3440 ) by @repzakske .
--extra-search-dir options instead of keeping only the last group. (#3440) by @repzakske.Search all directories supplied by repeated --extra-search-dir options instead of keeping only the last group. (3440) - by repzakske.
On Windows, the app data is now migrated into the nested cache directory instead of the migration failing with a warning on every run. (3441) - by gaborbernat and XXXXXQ-0206.
Always copy seed packages when app-data is temporary, including when symlink seeding is enabled through an environment variable or configuration file.
Always copy seed packages when app-data is temporary, including when symlink seeding is enabled through an environment variable or configuration file. Seeded packages remain available after temporary cache cleanup. (3437) - by gaborbernat.
Parse VIRTUALENV_PERIODIC_UPDATE_INSECURE as a boolean, so 0 , false , no and off keep certificate verification enabled. ( #3398 ) by @gaborbernat .
VIRTUALENV_PERIODIC_UPDATE_INSECURE as a boolean, so 0, false, no and off keep certificate verification enabled. (#3398) by @gaborbernat.pyvenv.cfg when a prompt or configuration value cannot be encoded as UTF-8, instead of leaving the file empty after a failed environment creation. The file now ends its lines with LF on every platform. Debug logs show each configuration line as a Python string literal, so control characters are visible. (#3400) by @gaborbernat..venv redirect when the environment name contains a line boundary. The environment is still created, and any existing redirect remains unchanged. (#3401) by @gaborbernat.activate_this.py when applications read the script with a legacy text encoding before executing it. (#3402) by @gaborbernat.pyvenv.cfg is not a regular file, instead of trying to read or write directories, pipes, or devices as configuration files. (#3405) by @gaborbernat.PATH unchanged, when the shell is not bash, the script is evaluated or read from standard input, a path tool fails, the sourced file is not the environment's own activation script, or the new location has no pyvenv.cfg, instead of continuing with an incorrect environment path. (#3409) by @gaborbernat.PYTHONHOME. Skip xonsh activation for destination names that its PATH handling would expand to a different path. Restore unset Tcl/Tk library variables when switching between environments in one xonsh session. Preserve non-ASCII paths and prompts when xonsh reads activation scripts with a legacy encoding. (#3411) by @gaborbernat.--activators= or --activators=python remain supported in legacy locales. Undecodable parent paths are now caught before any shell activation script is written. (#3412) by @gaborbernat.backslash_quote option is enabled. Assign prompt text before conditional branches so skipped prompt branches do not reinterpret its quoting. Display literal backslashes once in bsd-csh prompts. Keep disabled prompts unchanged when generated values contain quotes. (#3414) by @gaborbernat.-VenvDir arguments to absolute paths, and stop activation when that resolution fails. (#3415) by @gaborbernat.PS1 unchanged when sourcing the POSIX activation script in a shell other than bash or zsh, whose prompt escaping rules virtualenv handles; VIRTUAL_ENV_PROMPT stays available to custom prompts in other shells. In bash, keep the prompt literal under older compatibility levels, with promptvars disabled and in posix mode, and avoid nounset errors after VIRTUAL_ENV_PROMPT is unset. (#3418) by @gaborbernat.python -m virtualenv commands, reducing accidental module shadowing during environment creation. Explicit import paths keep their existing order. Keep the working-directory entry when virtualenv itself is installed there, and preserve explicit paths under Python safe-path mode. (#3419) by @gaborbernat.--clear when the normalized destination is a symlink or Windows reparse point, including paths containing ... Pass the target directory explicitly to clear it. Creating an environment through a symlink without --clear remains supported. (#3422) by @gaborbernat.--symlink-app-data no longer rewrites its shared wheel image. Unrelated launcher symlinks remain in place. Preserve case in console entry-point names and use the last value for duplicate entries when regenerating launchers. Remove linked metadata from previous seed versions when reseeding with pip so package listings report the installed version. (#3423) by @gaborbernat.venv creator, before it writes pyvenv.cfg. Other creators retain their existing destination support. Write the final configuration from the selected interpreter and virtualenv options instead of merging stdlib's intermediate configuration. GraalPy launcher settings are derived from the selected interpreter. (#3426) by @gaborbernat.top_level.txt line names site-packages), or resolve outside the environment, with a warning. Launcher entries inside the environment remain supported. (#3428) by @gaborbernat.--clear to recreate environments with such configuration paths. (#3433) by @gaborbernat..venv redirects for environment names with leading or trailing whitespace, which redirect readers may strip. (#3435) by @gaborbernat.VIRTUALENV_PERIODIC_UPDATE_INSECURE. (#3436) by @gaborbernat.Activate PowerShell environments whose path contains square brackets, and read the environment's own pyvenv.cfg instead of whichever file the path mat
pyvenv.cfg instead of whichever file the path matches as a wildcard pattern by @repzakske and @gaborbernat. (#3396)Activate PowerShell environments whose path contains square brackets, and read the environment's own pyvenv.cfg instead of whichever file the path matches as a wildcard pattern - by repzakske and gaborbernat. (3396)
Escape the environment name in the bash activator for both of bash's PS1 passes, so a name or --prompt value with a backslash before $(...) or backtic
PS1 passes, so a name or --prompt value with a backslash before $(...) or backticks no longer runs as a command each time bash draws the prompt by @gaborbernat. (#3390)Escape the environment name in the bash activator for both of bash's PS1 passes, so a name or --prompt value with a backslash before $(...) or backticks no longer runs as a command each time bash draws the prompt - by gaborbernat. (3390)
Fall back to the bundled seed wheel with periodic update on (the default) when the embed update log holds JSON of the wrong shape, instead of download
Fall back to the bundled seed wheel with periodic update on (the default) when the embed update log holds JSON of the wrong shape, instead of downloading the wheel or, offline, failing to create the environment - by darrenhuai and gaborbernat. (3383)
Fall back to the bundled seed wheel and remove the embed update log when the log in the app data folder holds JSON of the wrong shape, instead of fail
Full Changelog: 21.14.4...21.14.5
Fall back to the bundled seed wheel and remove the embed update log when the log in the app data folder holds JSON of the wrong shape, instead of failing to create the environment - by pasmud and gaborbernat. (3376)
Fix activate running commands from a virtual environment name or --prompt that holds $(...) , backticks or ${...} when zsh has PROMPT_SUBST set, and s
activate running commands from a virtual environment name or --prompt that holds $(...), backticks or${...} when zsh has PROMPT_SUBST set, and show a % in the name as typed under zsh (GHSA-5vjq-rrrf-7h2q <https://github.com/pypa/virtualenv/security/advisories/GHSA-5vjq-rrrf-7h2q>_); reported by kemrec.Full Changelog: 21.14.3...21.14.4
Fix activate running commands from a virtual environment name or --prompt that holds $(...) , backticks or ${...} when zsh has PROMPT_SUBST set, and show a % in the name as typed under zsh ( GHSA-5vjq-rrrf-7h2q ); reported by @kemrec and @gaborbernat . ( PR #3373 )
Fix activate running commands from a virtual environment name or --prompt that holds $(...), backticks or ${...} when zsh has PROMPT_SUBST set, and show a % in the name as typed under zsh (GHSA-5vjq-rrrf-7h2q); reported by kemrec and gaborbernat. (3373)
Honor ~= and every clause of a seed wheel's Requires-Python when picking a wheel for the target Python, and skip a wheel whose Requires-Python is not
~= and every clause of a seed wheel's Requires-Python when picking a wheel for the target Python, andRequires-Python is not a valid specifier instead of failing - by pasmud.Full Changelog: 21.14.2...21.14.3
Honor ~= and every clause of a seed wheel's Requires-Python when picking a wheel for the target Python, and skip a wheel whose Requires-Python is not a valid specifier instead of failing - by pasmud and gaborbernat. (3369)
Fix pyvenv.cfg getting an absolute path in python-version , include-system-site-packages and the other keys that hold no path when the working directo
pyvenv.cfg getting an absolute path in python-version, include-system-site-packages and the other keys3.14 for virtualenv 3.14 or true with --system-site-packages - by darrenhuai. (#3366)__VIRTUAL_NAME__ (GHSA-8rjx-v5ww-45pp <https://github.com/pypa/virtualenv/security/advisories/GHSA-8rjx-v5ww-45pp>), and activate.fish running--prompt that holds a backslash before a single quote (GHSA-c947-3pg5-gm8q <https://github.com/pypa/virtualenv/security/advisories/GHSA-c947-3pg5-gm8q>); both reported by Kwstubbs ofFull Changelog: 21.14.1...21.14.2
Fix pyvenv.cfg getting an absolute path in python-version , include-system-site-packages and the other keys that hold no path when the working directory has an entry named like the value, such as 3.14 for virtualenv 3.14 or true with --system-site-packages - by @darrenhuai and @gaborbernat . ( PR #3366 )
Fix activation scripts running code from a virtual environment path whose parent directory carries a placeholder name such as VIRTUAL_NAME ( GHSA-8rjx-v5ww-45pp ), and activate.fish running commands from a path or --prompt that holds a backslash before a single quote ( GHSA-c947-3pg5-gm8q ); both reported by @Kwstubbs and @gaborbernat of GitHub Security Lab. ( PR #3367 )
Fix pyvenv.cfg getting an absolute path in python-version, include-system-site-packages and the other keys that hold no path when the working directory has an entry named like the value, such as 3.14 for virtualenv 3.14 or true with --system-site-packages - by darrenhuai and gaborbernat. (3366)
Fix activation scripts running code from a virtual environment path whose parent directory carries a placeholder name such as __VIRTUAL_NAME__ (GHSA-8rjx-v5ww-45pp), and activate.fish running commands from a path or --prompt that holds a backslash before a single quote (GHSA-c947-3pg5-gm8q); both reported by Kwstubbs and gaborbernat of GitHub Security Lab. (3367)
fix(ci): allow attestation bundle downloads by @gaborbernat in #3364
Full Changelog: 21.14.0...21.14.1
π§ build(docs): load Mermaid 12.0.0 by @gaborbernat in #3335
Full Changelog: 21.13.0...21.14.0
Record the SPDX license id in the wheel and zipapp SBOMs for bundled packages that declare their license by name or classifier, such as distlib and python-discovery , so license scanners can match them. ( PR #3339 ) - by @gaborbernat .
Add the Tidelift and thanks.dev funding links to the PyPI project URLs, next to GitHub Sponsors - by @gaborbernat . ( PR #3340 )
Build the release sdist, wheel and zipapp with the build backend and SBOM tools that tasks/release-requirements.txt pins by version and SHA-256, so a rebuild of the tag uses the same versions. ( PR #3337 ) - by @gaborbernat .
Use PEP 440 version ordering when selecting seed wheels, so pinned pre-releases, post-releases and local versions resolve to the requested wheel. ( PR #3361 ) - by @pasmud and @gaborbernat .
Apply the licensing policy to what the wheel and zipapp ship, checked against their SBOMs, and name ALLOWED_LICENSES in tasks/license_policy.py as the list of accepted licenses. ( PR #3339 ) - by @gaborbernat .
Document what a maintainer checks when reviewing a pull request and what the main ruleset requires before a merge
by @gaborbernat . ( PR #3341 )
Document how the project selects, obtains and tracks its dependencies, and which dependency findings block a merge or a release - by @gaborbernat . ( PR #3342 )
Document which static analysis findings block a merge or a release, and how maintainers suppress a finding - by @gaborbernat . ( PR #3343 )
Document which secrets the project stores, who can read them and when maintainers rotate them - by @gaborbernat . ( PR #3344 )
Update the roadmap: PEP 832 support shipped, and PEP 838 waits on the PEP - by @gaborbernat . ( PR #3345 )
Record the SPDX license id in the wheel and zipapp SBOMs for bundled packages that declare their license by name or classifier, such as distlib and python-discovery, so license scanners can match them. (3339) - by gaborbernat.
Add the Tidelift and thanks.dev funding links to the PyPI project URLs, next to GitHub Sponsors - by gaborbernat. (3340)
Build the release sdist, wheel and zipapp with the build backend and SBOM tools that tasks/release-requirements.txt pins by version and SHA-256, so a rebuild of the tag uses the same versions. (3337) - by gaborbernat.
Use PEP 440 version ordering when selecting seed wheels, so pinned pre-releases, post-releases and local versions resolve to the requested wheel. (3361) - by pasmud and gaborbernat.
Apply the licensing policy to what the wheel and zipapp ship, checked against their SBOMs, and name ALLOWED_LICENSES in tasks/license_policy.py as the list of accepted licenses. (3339) - by gaborbernat.
Document what a maintainer checks when reviewing a pull request and what the main ruleset requires before a merge - by gaborbernat. (3341)
Document how the project selects, obtains and tracks its dependencies, and which dependency findings block a merge or a release - by gaborbernat. (3342)
Document which static analysis findings block a merge or a release, and how maintainers suppress a finding - by gaborbernat. (3343)
Document which secrets the project stores, who can read them and when maintainers rotate them - by gaborbernat. (3344)
Update the roadmap: PEP 832 support shipped, and PEP 838 waits on the PEP - by gaborbernat. (3345)
π· ci(codeql): scan local inputs and guard activation templates by @gaborbernat in #3317
Full Changelog: 21.12.1...21.13.0
Add Changelog and Funding links to the PyPI project metadata, and replace the 2020-202x placeholder in LICENSE with 2020-present so the copyright field of the wheel SBOM reads as a real range - by @gaborbernat . ( PR #3334 )
Escape the curly single quotes U+2018 - U+201B in the PowerShell activatorβs quote so a virtual environment prompt, name or Tcl/Tk library path containing them can no longer close the string literal and run commands - by @gaborbernat . ( PR #3325 )
Stop the bash activator from re-expanding the prompt inside PS1 , so a virtual environment name or --prompt value containing $(...) , backticks or backslashes no longer runs as a command each time bash draws the prompt - by @gaborbernat . ( PR #3326 )
Correct the documented changelog fragment types and example to match the enforced towncrier categories. ( #3323 ) - by @januththedev .
List the Unlicense and the SPDX BSD variants in the runtime dependency licensing policy, matching the filelock releases virtualenv installs on Python 3.9, and describe the dependency review check that enforces the policy. ( PR #3329 ) - by @gaborbernat .
Show how to check a release with gh release verify and gh release verify-asset , and how to rebuild the zipapp byte for byte with the build tool versions its SBOMs list. Drop the claims that the zipapp build does not pin the distributions it bundles and that wheels differ between build machines - by @gaborbernat . ( PR #3330 )
Add Changelog and Funding links to the PyPI project metadata, and replace the 2020-202x placeholder in LICENSE with 2020-present so the copyright field of the wheel SBOM reads as a real range - by gaborbernat. (3334)
Escape the curly single quotes U+2018-U+201B in the PowerShell activator's quote so a virtual environment prompt, name or Tcl/Tk library path containing them can no longer close the string literal and run commands - by gaborbernat. (3325)
Stop the bash activator from re-expanding the prompt inside PS1, so a virtual environment name or --prompt value containing $(...), backticks or backslashes no longer runs as a command each time bash draws the prompt - by gaborbernat. (3326)
Correct the documented changelog fragment types and example to match the enforced towncrier categories. (3323) - by januththedev.
List the Unlicense and the SPDX BSD variants in the runtime dependency licensing policy, matching the filelock releases virtualenv installs on Python 3.9, and describe the dependency review check that enforces the policy. (3329) - by gaborbernat.
Show how to check a release with gh release verify and gh release verify-asset, and how to rebuild the zipapp byte for byte with the build tool versions its SBOMs list. Drop the claims that the zipapp build does not pin the distributions it bundles and that wheels differ between build machines - by gaborbernat. (3330)
π fix(create): limit .venv redirect to projects by @gaborbernat in #3316
Full Changelog: 21.12.0...21.12.1
Limit the PEP 832 .venv redirect to folders holding a pyproject.toml and no .venv yet, so virtualenv foo in a scratch folder, and tools such as tox or nox building environments through virtualenv, no longer claim a folderβs default environment - by @gaborbernat .
--venv-redirect writes the redirect in any folder and replaces an earlier virtualenv redirect.
A flag on the command line overrides the environment variable and the config file in either direction. ( PR #3316 )
Limit the PEP 832 .venv redirect to folders holding a pyproject.toml and no .venv yet, so virtualenv foo in a scratch folder, and tools such as tox or nox building environments through virtualenv, no longer claim a folder's default environment - by gaborbernat.
--venv-redirect writes the redirect in any folder and replaces an earlier virtualenv redirect.
A flag on the command line overrides the environment variable and the config file in either direction. (3316)
β¨ feat(create): point a .venv redirect per PEP 832 by @gaborbernat in #3204
Full Changelog: 21.11.1...21.12.0
Write the PEP 838 python-version key into pyvenv.cfg , holding the target interpreterβs feature release. The new Generated files page covers it alongside every other file a created environment holds - by @konstin . ( PR #3193 )
Point a .venv redirect file in the parent folder at the created environment, per PEP 832 , so editors and type checkers can find it - by @gaborbernat and @konstin .
virtualenv leaves a .venv folder alone, and a redirect pointing at an environment it did not create.
Pass --no-venv-redirect to opt out.
The feature is provisional while PEP 832 is a draft: a minor or patch release may change it in backward incompatible ways to follow the PEP. ( PR #3204 )
Write the PEP 838 python-version key into pyvenv.cfg, holding the target interpreter's feature release. The new reference/files page covers it alongside every other file a created environment holds - by konstin. (3193)
Point a .venv redirect file in the parent folder at the created environment, per PEP 832, so editors and type checkers can find it - by gaborbernat and konstin.
virtualenv leaves a .venv folder alone, and a redirect pointing at an environment it did not create.
Pass --no-venv-redirect to opt out.
The feature is provisional while PEP 832 is a draft: a minor or patch release may change it in backward incompatible ways to follow the PEP. (3204)
π docs(security): close threat items resolved by 21.11.0 by @gaborbernat in #3313
Full Changelog: 21.11.0...21.11.1
Include the pre-commit configuration and the zipapp lock file in the source distribution, so downstream packagers can run the test suite from it. ( #3314 ) - by @Gonghan-Princess .
Include the pre-commit configuration and the zipapp lock file in the source distribution, so downstream packagers can run the test suite from it. (3314) - by Gonghan-Princess.
ci(pre-release): disable the uv cache by @gaborbernat in #3288
Full Changelog: 21.10.0...21.11.0
Attach the CycloneDX SBOM and an SPDX 2.3 rendering of it ( virtualenv.cdx.json , virtualenv.spdx.json ) to each GitHub release, and attest the SPDX document against the sdist and wheel. ( PR #3299 ) - by @gaborbernat .
Describe the zipapp in its own CycloneDX SBOM, which lists virtualenv, the embedded pip and setuptools wheels, and each bundled dependency with the Python versions that load it, down to a SHA-256 per file. The SBOM sits at the root of virtualenv.pyz , ships as the virtualenv.pyz.cdx.json release asset, and GitHub attests it against the zipapp. ( PR #3310 ) - by @gaborbernat .
Refuse a seed wheel downloaded from the default index when virtualenv cannot get its sha256 from PyPI after three retries, instead of seeding it unverified. Seeding falls back to the bundled wheel unless a specific version was requested. ( PR #3302 ) - by @gaborbernat .
Build the zipapp from the dependency wheels that pylock.zipapp.toml pins by URL and sha256, so a release bundles only files matching the committed hashes. ( PR #3306 ) - by @gaborbernat .
Leave the build machine out of the wheel and zipapp SBOMs, so the wheel rebuilds byte for byte on any operating system and architecture given the same source, SOURCE_DATE_EPOCH , Python patch version and build backend versions. Zipapp entries now carry the SOURCE_DATE_EPOCH timestamp and fixed permissions instead of the build time. ( PR #3311 ) - by @gaborbernat .
Document the backup maintainer and the two-factor authentication and access review expectations for maintainers. ( PR #3290 ) - by @gaborbernat .
Link the Carl Meyer talk on the home page over HTTPS - by @gaborbernat . ( PR #3300 )
Add a roadmap to the development guide listing what the project plans to do, and not do, through September 2027 - by @gaborbernat . ( PR #3304 )
Document what a release publishes and how to verify each file, covering the PyPI attestations, the zipapp and its provenance, the CycloneDX and SPDX SBOMs of the wheel, the zipapp SBOM, and rebuilding the sdist from its tag. ( PR #3305 ) - by @gaborbernat .
Attach the CycloneDX SBOM and an SPDX 2.3 rendering of it (virtualenv.cdx.json, virtualenv.spdx.json) to each GitHub release, and attest the SPDX document against the sdist and wheel. (3299) - by gaborbernat.
Describe the zipapp in its own CycloneDX SBOM, which lists virtualenv, the embedded pip and setuptools wheels, and each bundled dependency with the Python versions that load it, down to a SHA-256 per file. The SBOM sits at the root of virtualenv.pyz, ships as the virtualenv.pyz.cdx.json release asset, and GitHub attests it against the zipapp. (3310) - by gaborbernat.
Refuse a seed wheel downloaded from the default index when virtualenv cannot get its sha256 from PyPI after three retries, instead of seeding it unverified. Seeding falls back to the bundled wheel unless a specific version was requested. (3302) - by gaborbernat.
Build the zipapp from the dependency wheels that pylock.zipapp.toml pins by URL and sha256, so a release bundles only files matching the committed hashes. (3306) - by gaborbernat.
Leave the build machine out of the wheel and zipapp SBOMs, so the wheel rebuilds byte for byte on any operating system and architecture given the same source, SOURCE_DATE_EPOCH, Python patch version and build backend versions. Zipapp entries now carry the SOURCE_DATE_EPOCH timestamp and fixed permissions instead of the build time. (3311) - by gaborbernat.
Document the backup maintainer and the two-factor authentication and access review expectations for maintainers. (3290) - by gaborbernat.
Link the Carl Meyer talk on the home page over HTTPS - by gaborbernat. (3300)
Add a roadmap to the development guide listing what the project plans to do, and not do, through September 2027 - by gaborbernat. (3304)
Document what a release publishes and how to verify each file, covering the PyPI attestations, the zipapp and its provenance, the CycloneDX and SPDX SBOMs of the wheel, the zipapp SBOM, and rebuilding the sdist from its tag. (3305) - by gaborbernat.
feat: allow filelock 4.x on Python 3.10+ by @r3wretrhy in #3286
Full Changelog: 21.9.1...21.10.0
Include versioned identities for packages vendored inside seed wheels in the embedded SBOM. ( PR #3281 ) - by @gaborbernat .
Allow filelock 4.x on Python 3.10+ by relaxing the upper bound from <4 to <5 - by @r3wretrhy . ( #3285 )
Skip Windows batch activation scripts when environment or Tcl/Tk paths contain ^ or ! , since quoting changes those paths. Other activation scripts remain available. ( PR #3280 ) - by @gaborbernat .
Include versioned identities for packages vendored inside seed wheels in the embedded SBOM. (3281) - by gaborbernat.
Allow filelock 4.x on Python 3.10+ by relaxing the upper bound from <4 to <5 - by r3wretrhy. (3285)
Skip Windows batch activation scripts when environment or Tcl/Tk paths contain ^ or !, since quoting changes those paths. Other activation scripts remain available. (3280) - by gaborbernat.
π fix(upgrade): format generated notices by @gaborbernat in #3272
Full Changelog: 21.9.0...21.9.1
Correct SBOM CSV parsing and unresolved dependency relationships, and omit CI run identifiers from reproducible builds. ( PR #3278 ) - by @gaborbernat .
Correct SBOM CSV parsing and unresolved dependency relationships, and omit CI run identifiers from reproducible builds. (3278) - by gaborbernat.
β¨ feat(build): add SBOM timestamp and generator metadata by @gaborbernat in #3269
Full Changelog: 21.8.1...21.9.0
The embedded SBOM now describes the root componentβs license, copyright, maintainers and project links, each bundled wheel from its own metadata, the declared runtime dependencies, and the full build environment (interpreter, OS and every distribution in the isolated build environment with the dependency graph between them), plus the GitHub Actions run when built there. ( PR #3270 ) - by @gaborbernat .
Add metadata.timestamp (derived from SOURCE_DATE_EPOCH for reproducibility) and metadata.tools naming the generator to the embedded SBOM, and validate both fields in the packaging checks that already run on every pull request. ( PR #3269 ) - by @gaborbernat .
Fix the embedded SBOM not conforming to the CycloneDX 1.6 schema (an invalid vendor key on the generator tool entry) and validate it against the schema in CI. ( PR #3270 ) - by @gaborbernat .
The embedded SBOM now describes the root component's license, copyright, maintainers and project links, each bundled wheel from its own metadata, the declared runtime dependencies, and the full build environment (interpreter, OS and every distribution in the isolated build environment with the dependency graph between them), plus the GitHub Actions run when built there. (3270) - by gaborbernat.
Add metadata.timestamp (derived from SOURCE_DATE_EPOCH for reproducibility) and metadata.tools naming the generator to the embedded SBOM, and validate both fields in the packaging checks that already run on every pull request. (3269) - by gaborbernat.
Fix the embedded SBOM not conforming to the CycloneDX 1.6 schema (an invalid vendor key on the generator tool entry) and validate it against the schema in CI. (3270) - by gaborbernat.
π fix(build): make the SBOM serial number deterministic and validate its structure in CI by @gaborbernat in #3268
Full Changelog: 21.8.0...21.8.1
Make the embedded SBOMβs serialNumber a deterministic UUID derived from the package name, version and bundled wheel hashes, so the same source tree produces a byte-identical SBOM, and validate the SBOMβs structure as part of the packaging checks that already run on every pull request. ( PR #3268 ) - by @gaborbernat .
Make the embedded SBOM's serialNumber a deterministic UUID derived from the package name, version and bundled wheel hashes, so the same source tree produces a byte-identical SBOM, and validate the SBOM's structure as part of the packaging checks that already run on every pull request. (3268) - by gaborbernat.
π docs(security): add an incident response plan by @gaborbernat in #3262
Full Changelog: 21.7.15...21.7.16
Fix activate.csh rendering the venvβs prompt text wrong when it contains ! (csh and tcsh both expand it) or % (tcsh only, since plain csh has no % prompt escape at all). ( PR #3263 ) - by @gaborbernat .
Fix activate.csh rendering the venv's prompt text wrong when it contains ! (csh and tcsh both expand it) or % (tcsh only, since plain csh has no % prompt escape at all). (3263) - by gaborbernat.
π fix(activation): restore empty saved values on deactivate by @gaborbernat in #3259
Full Changelog: 21.7.14...21.7.15
Restore an empty PATH on deactivate in the bash and fish activators, and stop bash leaving the prompt in PS1 when it was unset before activation. ( PR #3259 ) - by @gaborbernat .
Fix activate.csh failing to restore PATH and other saved variables on deactivate when PATH was already empty. ( PR #3260 ) - by @gaborbernat .
Restore an empty PATH on deactivate in the bash and fish activators, and stop bash leaving the prompt in PS1 when it was unset before activation. (3259) - by gaborbernat.
Fix activate.csh failing to restore PATH and other saved variables on deactivate when PATH was already empty. (3260) - by gaborbernat.
π fix(activation): escape ! for csh history expansion by @gaborbernat in #3256
Full Changelog: 21.7.13...21.7.14
Fix activate.csh failing with Event not found when the virtual environment path contains ! . ( PR #3256 ) - by @gaborbernat .
Fix activate.csh failing with Event not found when the virtual environment path contains !. (3256) - by gaborbernat.
π· ci: correct a stale checkout pin comment by @gaborbernat in #3254
Full Changelog: 21.7.12...21.7.13
Fix activate and activate.fish running commands embedded in the virtual environment path or in the interpreterβs Tcl/Tk library paths. ( PR #3252 ) - by @gaborbernat .
Fix activate and activate.fish running commands embedded in the virtual environment path or in the interpreter's Tcl/Tk library paths. (3252) - by gaborbernat.
π§ chore(changelog): drop dead CVE-2026-24049 fragment by @gaborbernat in #3249
Full Changelog: 21.7.11...21.7.12
Fix activate.bat running arbitrary commands from a crafted --prompt , VIRTUALENV_PROMPT , or config file value. ( PR #3250 ) - by @gaborbernat .
Verify a downloaded seed wheelβs sha256 against PyPI before seeding it into a virtual environment, skipped when a custom pip index is configured. ( PR #3251 ) - by @gaborbernat .
Fix activate.bat running arbitrary commands from a crafted --prompt, VIRTUALENV_PROMPT, or config file value. (3250) - by gaborbernat.
Verify a downloaded seed wheel's sha256 against PyPI before seeding it into a virtual environment, skipped when a custom pip index is configured. (3251) - by gaborbernat.
Add OpenSSF Scorecard workflow by @gaborbernat in #3238
Full Changelog: 21.7.10...21.7.11
Running activate.bat again before deactivate no longer makes deactivate leave the environmentβs PKG_CONFIG_PATH , TCL_LIBRARY and TK_LIBRARY behind, or lose values the user had set before the first activation - by @darrenhuai . ( PR #3245 )
Write pyvenv.cfg values on a single line, so a prompt carrying a line boundary can no longer inject configuration. --prompt , the VIRTUALENV_PROMPT environment variable and the config file all set the prompt, and pyvenv.cfg has no escape syntax, so a newline, a carriage return, or any other boundary str.splitlines recognizes, such as U+2028 , started a new configuration line. Reading the file back picked up those lines as keys, and since the last value for a key wins, they replaced anything written earlier, including home . ( PR #3247 ) - by @gaborbernat .
Document the policy for AI-assisted contributions and the licensing rules for dependencies. ( PR #3239 ) - by @gaborbernat .
Running activate.bat again before deactivate no longer makes deactivate leave the environment's PKG_CONFIG_PATH, TCL_LIBRARY and TK_LIBRARY behind, or lose values the user had set before the first activation - by darrenhuai. (3245)
Write pyvenv.cfg values on a single line, so a prompt carrying a line boundary can no longer inject configuration. --prompt, the VIRTUALENV_PROMPT environment variable and the config file all set the prompt, and pyvenv.cfg has no escape syntax, so a newline, a carriage return, or any other boundary str.splitlines recognizes, such as U+2028, started a new configuration line. Reading the file back picked up those lines as keys, and since the last value for a key wins, they replaced anything written earlier, including home. (3247) - by gaborbernat.
Document the policy for AI-assisted contributions and the licensing rules for dependencies. (3239) - by gaborbernat.
π§ chore: check spelling with typos in pre-commit by @even-even in #3235
Full Changelog: 21.7.9...21.7.10
Skip blank lines, # comments and lines without = in pyvenv.cfg instead of raising ValueError - by @r3wretrhy and @gaborbernat . ( PR #3232 )
deactivate in bash, fish and PowerShell unsets PKG_CONFIG_PATH when activation found it unset, instead of keeping the environmentβs lib/pkgconfig . csh activation no longer drops a PKG_CONFIG_PATH the user had set. Activation in batch, fish, nushell and PowerShell no longer adds a trailing separator when PKG_CONFIG_PATH is unset, and PowerShell and nushell build the value with the hostβs path separators - by @darrenhuai and @gaborbernat . ( PR #3233 )
Activation in bash, csh, fish and PowerShell keeps the userβs TCL_LIBRARY and TK_LIBRARY , and deactivate restores them. csh and PowerShell removed both variables on every activation, fish did so when the interpreter has tcl, and bash kept the environmentβs value after deactivate when the variable was unset before - by @darrenhuai and @gaborbernat . ( PR #3234 )
Skip blank lines, # comments and lines without = in pyvenv.cfg instead of raising ValueError - by r3wretrhy and gaborbernat. (3232)
deactivate in bash, fish and PowerShell unsets PKG_CONFIG_PATH when activation found it unset, instead of keeping the environment's lib/pkgconfig. csh activation no longer drops a PKG_CONFIG_PATH the user had set. Activation in batch, fish, nushell and PowerShell no longer adds a trailing separator when PKG_CONFIG_PATH is unset, and PowerShell and nushell build the value with the host's path separators - by darrenhuai and gaborbernat. (3233)
Activation in bash, csh, fish and PowerShell keeps the user's TCL_LIBRARY and TK_LIBRARY, and deactivate restores them. csh and PowerShell removed both variables on every activation, fish did so when the interpreter has tcl, and bash kept the environment's value after deactivate when the variable was unset before - by darrenhuai and gaborbernat. (3234)
fix(test): EncodingWarning: 'encoding' argument not specified by @even-even in #3228
Full Changelog: 21.7.8...21.7.9
Replace dangling symlinks, including interpreter aliases, when recreating an environment. This prevents FileExistsError with --symlinks and writes outside the environment with --copies - by @darrenhuai and @gaborbernat . ( PR #3229 )
Ignore malformed or unreadable virtualenv.ini files and report the error in the log and --help . Accept a UTF-8 byte order mark, as written by PowerShell 5 and older Notepad versions - by @darrenhuai and @gaborbernat . ( PR #3230 )
Replace dangling symlinks, including interpreter aliases, when recreating an environment. This prevents FileExistsError with --symlinks and writes outside the environment with --copies - by darrenhuai and gaborbernat. (3229)
Ignore malformed or unreadable virtualenv.ini files and report the error in the log and --help. Accept a UTF-8 byte order mark, as written by PowerShell 5 and older Notepad versions - by darrenhuai and gaborbernat. (3230)
π fix(create): report a missing source that both modes need by @darrenhuai in #3227
Full Changelog: 21.7.7...21.7.8
A missing source needed by both install modes now disables the builtin creator through meta.error . The check compared RefWhen values against RefMust members, so creation went on to fail with a FileNotFoundError or a dangling symlink - by @darrenhuai . ( PR #3227 )
A missing source needed by both install modes now disables the builtin creator through meta.error. The check compared RefWhen values against RefMust members, so creation went on to fail with a FileNotFoundError or a dangling symlink - by darrenhuai. (3227)
π docs: document the interpreter names in an environment by @gaborbernat in #3225
Full Changelog: 21.7.6...21.7.7
Bump the python-discovery minimum to >=1.6 for PythonInfo.system_exe , which reports the system interpreter without the nullable typing of system_executable - by @gaborbernat . ( PR #3224 )
Document the names the interpreter answers to inside a created environment. A new Environment layout page lists them per platform, the tutorial and the usage guide point at it, and the explanation of creators covers why an environment carries several names and why Windows copies a redirector - by @gaborbernat . ( PR #3225 )
Bump the python-discovery minimum to >=1.6 for PythonInfo.system_exe, which reports the system interpreter without the nullable typing of system_executable - by gaborbernat. (3224)
Document the names the interpreter answers to inside a created environment. A new reference/environment-layout page lists them per platform, the tutorial and the usage guide point at it, and the explanation of creators covers why an environment carries several names and why Windows copies a redirector - by gaborbernat. (3225)
π fix(create): name Windows venv exes after the interpreter by @darrenhuai in #3223
Full Changelog: 21.7.5...21.7.6
On Windows, virtualenv no longer copies the CPython 3.13+ venvlauncher.exe shim into Scripts under the shimβs own name, and a host such as python_d.exe gets its alias back. The alias set took its names from the shim that stands in for the interpreter, so every environment gained a stray launcher copy and lost the interpreterβs own file name - by @darrenhuai and @gaborbernat . ( PR #3223 )
On Windows, virtualenv no longer copies the CPython 3.13+ venvlauncher.exe shim into Scripts under the shim's own name, and a host such as python_d.exe gets its alias back. The alias set took its names from the shim that stands in for the interpreter, so every environment gained a stray launcher copy and lost the interpreter's own file name - by darrenhuai and gaborbernat. (3223)
π fix(types): adapt to python-discovery 1.5.2 annotations by @gaborbernat in #3211
Full Changelog: 21.7.4...21.7.5
Fix the type check against python-discovery 1.5.2, whose annotations allow a None prefix and integer sysconfig_vars values: config var substitution now skips a missing prefix and locating the shared libpython requires string INSTSONAME / LIBDIR values. ( PR #3211 ) - by @gaborbernat .
ExePathRef.can_run now checks the group and other execute bits instead of only the owner one, and returns False rather than None when a file carries none of the three - by @darrenhuai and @gaborbernat . ( PR #3217 )
safe_delete no longer passes ignore_errors=True to shutil.rmtree , which replaced its own chmod-and-retry handler with a no-op and swallowed every failure. Read-only files - every file in a wheel image, which set_tree marks - survived, so --reset-app-data and --clear kept trees they reported deleting. The handler now retries only the deletion itself, keeps the other mode bits, and raises the original error for anything it cannot clear - by @darrenhuai and @gaborbernat . ( PR #3222 )
Fix the type check against python-discovery 1.5.2, whose annotations allow a None prefix and integer sysconfig_vars values: config var substitution now skips a missing prefix and locating the shared libpython requires string INSTSONAME/LIBDIR values. (3211) - by gaborbernat.
ExePathRef.can_run now checks the group and other execute bits instead of only the owner one, and returns False rather than None when a file carries none of the three - by darrenhuai and gaborbernat. (3217)
safe_delete no longer passes ignore_errors=True to shutil.rmtree, which replaced its own chmod-and-retry handler with a no-op and swallowed every failure. Read-only files - every file in a wheel image, which set_tree marks - survived, so --reset-app-data and --clear kept trees they reported deleting. The handler now retries only the deletion itself, keeps the other mode bits, and raises the original error for anything it cannot clear - by darrenhuai and gaborbernat. (3222)
Upgrade embedded pip/setuptools/wheel by @github-actions[bot] in #3208
Full Changelog: 21.7.3...21.7.4
Upgrade embedded wheels:
setuptools to 84.0.0 from 83.0.0 ( PR #3208 ) - by @gaborbernat .
Upgrade embedded wheels:
setuptools to 84.0.0 from 83.0.0 (3208) - by gaborbernat.
π fix(config): return a real list from ListType.split_values by @darrenhuai in #3207
Full Changelog: 21.7.2...21.7.3
ListType.split_values now returns a list you can iterate more than once, and accepts bytes input instead of raising TypeError - by @darrenhuai and @gaborbernat . ( PR #3207 )
ListType.split_values now returns a list you can iterate more than once, and accepts bytes input instead of raising TypeError - by darrenhuai and gaborbernat. (3207)
Upgrade embedded pip/setuptools/wheel by @github-actions[bot] in #3206
Full Changelog: 21.7.1...21.7.2
Upgrade embedded wheels:
pip to 26.2.1 from 26.2 ( PR #3206 ) - by @gaborbernat .
Upgrade embedded wheels:
pip to 26.2.1 from 26.2 (3206) - by gaborbernat.
π docs(branding): clarify official logo vs favicon by @gaborbernat in #3200
Full Changelog: 21.7.0...21.7.1
Document that virtualenv.png is the official logo and virtualenv.svg is a simplified favicon-only mark - by @gaborbernat . ( #3199 )
Upgrade the embedded pip wheel from 26.1.2 to 26.2 .
Document that virtualenv.png is the official logo and virtualenv.svg is a simplified favicon-only mark - by gaborbernat. (3199)
Upgrade the embedded pip wheel from 26.1.2 to 26.2.
Replace prettier with mdformat and yamlfmt by @gaborbernat in #3190
Full Changelog: 21.6.1...21.7.0
Declare support for Python 3.15: CI now tests against the CPython 3.15 beta, including the free-threaded 3.15t build, and the Programming Language :: Python :: 3.15 classifier is advertised. ( PR #3192 ) - by @gaborbernat .
Declare support for Python 3.15: CI now tests against the CPython 3.15 beta, including the free-threaded 3.15t build, and the Programming Language :: Python :: 3.15 classifier is advertised. (3192) - by gaborbernat.
π fix(fish): harden prompt against shadowed builtins by @gaborbernat in #3185
Full Changelog: 21.6.0...21.6.1
Harden the fish activator prompt against user functions that shadow builtins. Routing functions , printf , string , echo and source / . through builtin stops a shadowing function (such as a dot-style directory navigator that redefines . ) from hijacking the prompt and dropping the previous commandβs exit status, matching the CPython fix in gh-140006 . ( PR #3185 ) - by @gaborbernat .
Harden the fish activator prompt against user functions that shadow builtins. Routing functions, printf, string, echo and source/. through builtin stops a shadowing function (such as a dot-style directory navigator that redefines .) from hijacking the prompt and dropping the previous command's exit status, matching the CPython fix in gh-140006. (3185) - by gaborbernat.
β¨ feat(create): skip distutils hook on Python 3.10+ by @gaborbernat in #3184
Full Changelog: 21.5.2...21.6.0
Stop installing the _virtualenv.{py,pth} distutils import hook for Python 3.10 and later, where pip, setuptools and CPython already ignore the install config keys it guards against; this removes the hookβs startup import cost. The hook is still installed for Python 3.9. ( #3181 ) - by @gaborbernat .
Stop installing the _virtualenv.{py,pth} distutils import hook for Python 3.10 and later, where pip, setuptools and CPython already ignore the install config keys it guards against; this removes the hook's startup import cost. The hook is still installed for Python 3.9. (3181) - by gaborbernat.
π fix(seed): sync wheel regen script with seeder guard by @gaborbernat in #3175
Full Changelog: 21.5.1...21.5.2
Upgrade embedded wheels:
setuptools to 83.0.0 ( PR #3180 ) - by @gaborbernat .
Upgrade embedded wheels:
setuptools to 83.0.0 (3180) - by gaborbernat.
π fix(seed): refuse to seed unsupported Python versions by @gaborbernat in #3173
Full Changelog: 21.5.0...21.5.1
Refuse to create environments whose Python the bundled wheels no longer cover (currently below 3.9). virtualenv used to substitute the newest bundled pip , which cannot run on such a target, leaving a broken environment; seeder selection now rejects it up front with a clear error. --no-seed and third-party seeders that ship compatible wheels still work - by @gaborbernat . ( #3171 )
Refuse to create environments whose Python the bundled wheels no longer cover (currently below 3.9). virtualenv used to substitute the newest bundled pip, which cannot run on such a target, leaving a broken environment; seeder selection now rejects it up front with a clear error. --no-seed and third-party seeders that ship compatible wheels still work - by gaborbernat. (3171)
Set git identity in upgrade changelog rename step by @gaborbernat in #3169
Full Changelog: 21.4.3...21.5.0
Drop support for Python 3.8; virtualenv now requires Python 3.9 or later to run and to create environments. Remove the embedded wheel seed package, which virtualenv bundled only for Python 3.8. The --wheel and --no-wheel options stay as no-ops, but now warn that virtualenv will remove them in a release after 2026-12 - by @gaborbernat . ( PR #3170 )
Remove the embedded wheel package at version 0.47.0 - by @gaborbernat .
Drop support for Python 3.8; virtualenv now requires Python 3.9 or later to run and to create environments. Remove the embedded wheel seed package, which virtualenv bundled only for Python 3.8. The --wheel and --no-wheel options stay as no-ops, but now warn that virtualenv will remove them in a release after 2026-12 - by gaborbernat. (3170)
Remove the embedded wheel package at version 0.47.0 - by gaborbernat.
Add wheel-0.47.0 to seed packages as mitigation of CVE-2026-24049 by @apophizzz in https://github.com/pypa/virtualenv/pull/3167
<!-- Release notes generated using configuration in .github/release.yaml at 21.4.3 -->
Full Changelog: https://github.com/pypa/virtualenv/compare/21.4.2...21.4.3
Resolve executable-only symlinks when recording home and base-executable in pyvenv.cfg , mirroring CPythonβs getpath.realpath (python/cpython#115237), so environments created from a symlink to the interpreter binary locate the base stdlib (for example python-build-standalone); a fully symlinked interpreter tree is kept as-is
by @gaborbernat . ( #3157 )
Stop exporting PS1 from the bash activator so child processes do not inherit shell prompt state. ( #3158 ) - by @karlhillx .
Handle CYGWIN/MSYS/MINGW path conversions in fish activation script - by @LuNoX . ( #3160 )
Upgrade the embedded pip wheel from 26.1.1 to 26.1.2 .
Resolve executable-only symlinks when recording home and base-executable in pyvenv.cfg, mirroring CPython's getpath.realpath (python/cpython#115237), so environments created from a symlink to the interpreter binary locate the base stdlib (for example python-build-standalone); a fully symlinked interpreter tree is kept as-is - by gaborbernat. (3157)
Stop exporting PS1 from the bash activator so child processes do not inherit shell prompt state. (3158) - by karlhillx.
Handle CYGWIN/MSYS/MINGW path conversions in fish activation script - by LuNoX. (3160)
Upgrade the embedded pip wheel from 26.1.1 to 26.1.2.
<!-- Release notes generated using configuration in .github/release.yaml at 21.4.2 -->
<!-- Release notes generated using configuration in .github/release.yaml at 21.4.2 -->
Full Changelog: https://github.com/pypa/virtualenv/compare/21.4.1...21.4.2
Stop deactivate in the bash/zsh activation script from aborting under set -e when hash -r fails (for example with shell hashing disabled) by appending || true , matching CPython venv (gh-149701) and the existing non-deactivate call - by @gaborbernat . ( PR #3152 )
Stop deactivate in the bash/zsh activation script from aborting under set -e when hash -r fails (for example with shell hashing disabled) by appending || true, matching CPython venv (gh-149701) and the existing non-deactivate call - by gaborbernat. (3152)
One column per quarter.