|
6 | 6 |
|
7 | 7 | .. towncrier release notes start |
8 | 8 |
|
| 9 | +*********************** |
| 10 | + v21.14.9 (2026-10-17) |
| 11 | +*********************** |
| 12 | + |
| 13 | +Bugfixes - 21.14.9 |
| 14 | +================== |
| 15 | + |
| 16 | +- Parse ``VIRTUALENV_PERIODIC_UPDATE_INSECURE`` as a boolean, so ``0``, ``false``, ``no`` and ``off`` keep certificate |
| 17 | + verification enabled. (:issue:`3398`) |
| 18 | +- Reject destinations whose resolved path contains the platform's PATH separator, including separators inherited from |
| 19 | + the working directory or a directory symlink. (:issue:`3399`) |
| 20 | +- Preserve an existing ``pyvenv.cfg`` when a prompt or configuration value cannot be encoded as UTF-8, instead of |
| 21 | + leaving the file empty after a failed environment creation. The file now ends its lines with LF on every platform. |
| 22 | + |
| 23 | + Debug logs show each configuration line as a Python string literal, so control characters are visible. (:issue:`3400`) |
| 24 | + |
| 25 | +- Skip writing a ``.venv`` redirect when the environment name contains a line boundary. The environment is still |
| 26 | + created, and any existing redirect remains unchanged. (:issue:`3401`) |
| 27 | +- Preserve non-ASCII values in ``activate_this.py`` when applications read the script with a legacy text encoding before |
| 28 | + executing it. (:issue:`3402`) |
| 29 | +- Reject malformed seed versions and requirements ending in archive suffixes before starting pip, with an error |
| 30 | + identifying the invalid value instead of a misleading download or local-file error. (:issue:`3403`) |
| 31 | +- Allow a literal percent sign as a csh prompt and preserve carets in tcsh prompt display instead of interpreting them |
| 32 | + as control-character notation. |
| 33 | + |
| 34 | + Separate csh history and prompt escapes from preceding non-ASCII text in legacy locales. (:issue:`3404`) |
| 35 | + |
| 36 | +- Report an error when an existing ``pyvenv.cfg`` is not a regular file, instead of trying to read or write directories, |
| 37 | + pipes, or devices as configuration files. (:issue:`3405`) |
| 38 | +- Preserve percent-containing paths during batch reactivation and show dollar signs literally in command prompts. Skip |
| 39 | + batch scripts for paths containing line boundaries, and remove stale batch scripts for unsupported paths even when |
| 40 | + only other activators are selected. (:issue:`3406`) |
| 41 | +- Compile shared seed-cache bytecode without loading site customizations from the destination environment or importing |
| 42 | + modules from the current working directory. (:issue:`3407`) |
| 43 | +- Keep the bundled seed version when a cached periodic update is older, and stop recording downloads below the bundled |
| 44 | + version during update checks. (:issue:`3408`) |
| 45 | +- Stop activating a moved environment, leaving ``PATH`` unchanged, when the shell is not bash, the script is evaluated |
| 46 | + or read from standard input, a path tool fails, the sourced file is not the environment's own activation script, or |
| 47 | + the new location has no ``pyvenv.cfg``, instead of continuing with an incorrect environment path. (:issue:`3409`) |
| 48 | +- Reject built-in options with missing values before creating the application-data directory or starting interpreter |
| 49 | + discovery, instead of reporting the argument error after those operations. (:issue:`3410`) |
| 50 | +- Keep unset-variable bookkeeping out of exported xonsh variables, so child shells do not restore an internal sentinel |
| 51 | + as ``PYTHONHOME``. Skip xonsh activation for destination names that its PATH handling would expand to a different |
| 52 | + path. |
| 53 | + |
| 54 | + Restore unset Tcl/Tk library variables when switching between environments in one xonsh session. |
| 55 | + |
| 56 | + Preserve non-ASCII paths and prompts when xonsh reads activation scripts with a legacy encoding. (:issue:`3411`) |
| 57 | + |
| 58 | +- Skip default shell activators with a warning when a POSIX path encoding is incompatible with their UTF-8 scripts. |
| 59 | + Explicitly requested incompatible shell activators still report an error. Environments created with ``--activators=`` |
| 60 | + or ``--activators=python`` remain supported in legacy locales. Undecodable parent paths are now caught before any |
| 61 | + shell activation script is written. (:issue:`3412`) |
| 62 | +- Keep apostrophes and backslashes in fish activation values separate from preceding non-ASCII characters, so fish 3 |
| 63 | + legacy locale decoders cannot consume their escapes as part of a multibyte character. (:issue:`3413`) |
| 64 | +- Preserve backslashes and apostrophes in csh activation values when tcsh's ``backslash_quote`` option is enabled. |
| 65 | + Assign prompt text before conditional branches so skipped prompt branches do not reinterpret its quoting. |
| 66 | + |
| 67 | + Display literal backslashes once in bsd-csh prompts. Keep disabled prompts unchanged when generated values contain |
| 68 | + quotes. (:issue:`3414`) |
| 69 | + |
| 70 | +- Preserve backslashes in POSIX environment directory names during PowerShell activation, including configuration lookup |
| 71 | + and the default prompt. Resolve relative, home-relative, PSDrive-qualified and filesystem provider-qualified |
| 72 | + ``-VenvDir`` arguments to absolute paths, and stop activation when that resolution fails. (:issue:`3415`) |
| 73 | +- Keep helper processes for pip, symlink-seed compilation, stdlib venv creation, and periodic wheel updates from |
| 74 | + importing modules through Python's implicit current-directory entry. Pip helpers retain the selected bootstrap wheel |
| 75 | + on their import path. |
| 76 | + |
| 77 | + Preserve Python environment-variable overrides for delegated stdlib venv creation while removing the implicit |
| 78 | + working-directory import entry. |
| 79 | + |
| 80 | + Retain explicit Python configuration when compiling symlink seed images, and report compilation failures. |
| 81 | + (:issue:`3416`) |
| 82 | + |
| 83 | +- Preserve spaces, quotes, and backslashes in interpreter paths when pip console scripts need a POSIX shell launcher. |
| 84 | + Paths containing tabs also use the shell launcher so the kernel does not split the interpreter name. |
| 85 | + |
| 86 | + Apply the same launcher quoting after pip seeding and refresh the installed file records. Later independent pip |
| 87 | + installs or upgrades can overwrite these launchers; recreate affected environments after upgrading virtualenv. |
| 88 | + (:issue:`3417`) |
| 89 | + |
| 90 | +- Leave ``PS1`` unchanged when sourcing the POSIX activation script in a shell other than bash or zsh, whose prompt |
| 91 | + escaping rules virtualenv handles; ``VIRTUAL_ENV_PROMPT`` stays available to custom prompts in other shells. |
| 92 | + |
| 93 | + In bash, keep the prompt literal under older compatibility levels, with ``promptvars`` disabled and in posix mode, and |
| 94 | + avoid ``nounset`` errors after ``VIRTUAL_ENV_PROMPT`` is unset. (:issue:`3418`) |
| 95 | + |
| 96 | +- Remove Python's implicit working-directory import entry before handling ``python -m virtualenv`` commands, reducing |
| 97 | + accidental module shadowing during environment creation. Explicit import paths keep their existing order. |
| 98 | + |
| 99 | + Keep the working-directory entry when virtualenv itself is installed there, and preserve explicit paths under Python |
| 100 | + safe-path mode. (:issue:`3419`) |
| 101 | + |
| 102 | +- Start periodic wheel updates with the same virtualenv installation or zipapp that scheduled them, even when the host |
| 103 | + interpreter has another virtualenv version installed or no installed copy. |
| 104 | + |
| 105 | + Keep standard-library precedence and explicit Python configuration in update processes, and drop only the implicit |
| 106 | + working-directory import entry before importing anything. (:issue:`3420`) |
| 107 | + |
| 108 | +- Create new default app-data directories with owner-only access where supported. For existing POSIX defaults owned by |
| 109 | + the current user, remove group and other write access, preserving group write on setgid shared caches. Keep |
| 110 | + permissions on directories owned by another user and on explicit app-data paths. Warn and use temporary app-data if |
| 111 | + changing an owned default cache's permissions fails. (:issue:`3421`) |
| 112 | +- Reject ``--clear`` when the normalized destination is a symlink or Windows reparse point, including paths containing |
| 113 | + ``..``. Pass the target directory explicitly to clear it. Creating an environment through a symlink without |
| 114 | + ``--clear`` remains supported. (:issue:`3422`) |
| 115 | +- Detach seed-package and launcher symlinks before running the pip seeder. Reseeding an environment created with |
| 116 | + ``--symlink-app-data`` no longer rewrites its shared wheel image. Unrelated launcher symlinks remain in place. |
| 117 | + |
| 118 | + Preserve case in console entry-point names and use the last value for duplicate entries when regenerating launchers. |
| 119 | + |
| 120 | + Remove linked metadata from previous seed versions when reseeding with pip so package listings report the installed |
| 121 | + version. (:issue:`3423`) |
| 122 | + |
| 123 | +- Replace line-boundary characters in csh prompt text with spaces so activation remains valid. |
| 124 | + |
| 125 | + When a filesystem path contains a newline, skip csh activation and remove any stale csh activation scripts. Keep |
| 126 | + filesystem paths unchanged, including other control characters, and omit skipped activators from the creation summary. |
| 127 | + (:issue:`3424`) |
| 128 | + |
| 129 | +- Apply the current umask when copying interpreter and seed-package files instead of inheriting cached permission bits. |
| 130 | + Executable sources remain executable within the permissions allowed by that umask. Copied files no longer grant group |
| 131 | + or world write access, even with a permissive umask. Source modes are not preserved: data files start from 0644 and |
| 132 | + executable files from 0755 before applying the umask. (:issue:`3425`) |
| 133 | +- Reject destinations containing line boundaries when using the stdlib ``venv`` creator, before it writes |
| 134 | + ``pyvenv.cfg``. Other creators retain their existing destination support. Write the final configuration from the |
| 135 | + selected interpreter and virtualenv options instead of merging stdlib's intermediate configuration. GraalPy launcher |
| 136 | + settings are derived from the selected interpreter. (:issue:`3426`) |
| 137 | +- Preserve file permissions when deletion fails on POSIX. On Windows, clear read-only attributes through a handle that |
| 138 | + opens the entry itself and prevents replacement, preserving other attributes and rejecting reparse points. |
| 139 | + (:issue:`3427`) |
| 140 | +- Limit seed-package cleanup to entries inside the environment. Ignore metadata entries that name the environment |
| 141 | + itself, a directory holding the metadata (a blank ``top_level.txt`` line names ``site-packages``), or resolve outside |
| 142 | + the environment, with a warning. Launcher entries inside the environment remain supported. (:issue:`3428`) |
| 143 | +- Replace pre-existing directory symlinks and Windows junctions in the environment's executable and library paths before |
| 144 | + creating files. Links within those paths are replaced even when they point inside the environment. Log replaced links |
| 145 | + and junctions, and reject a non-directory encountered while creating their replacements. (:issue:`3429`) |
| 146 | +- Verify downloads in a private staging directory before adding them to the reusable wheel cache. Select the downloaded |
| 147 | + archive from that directory instead of pip's output. The pip seeder now uses the same download verification path and |
| 148 | + installs pinned versions from a temporary directory containing only the selected wheels, without another index lookup. |
| 149 | + Seeded packages retain version pins in pip freeze output. (:issue:`3430`) |
| 150 | +- Replace existing symbolic and hard links when writing environment configuration, activation scripts, import hooks, and |
| 151 | + seed launchers. Create generated text files exclusively so a replacement link cannot redirect the final file open. |
| 152 | + Before recreating an environment with the stdlib venv creator, replace executable-directory symlinks and Windows |
| 153 | + junctions with real directories. Remove symbolic and hard links inside that directory before creating interpreter |
| 154 | + files, including when switching from symlinks to copies. (:issue:`3431`) |
| 155 | +- Write xonsh prompt and path literals as ASCII escapes in every generated activation script. This preserves their |
| 156 | + values when xonsh reads the script with a legacy encoding such as GBK or Big5. Regenerate existing scripts to apply |
| 157 | + the fix. (:issue:`3432`) |
| 158 | +- Keep existing redirects whose target has a non-regular configuration file, and allow ``--clear`` to recreate |
| 159 | + environments with such configuration paths. (:issue:`3433`) |
| 160 | +- Reject invalid and archive-like seed versions while parsing options for both seeders, before creating an environment |
| 161 | + or looking up wheels, with an error naming the invalid value. Apply the same validation to versions obtained from |
| 162 | + wheel filenames. (:issue:`3434`) |
| 163 | +- Skip writing ``.venv`` redirects for environment names with leading or trailing whitespace, which redirect readers may |
| 164 | + strip. (:issue:`3435`) |
| 165 | + |
| 166 | +Improved Documentation - 21.14.9 |
| 167 | +================================ |
| 168 | + |
| 169 | +- Document the accepted boolean values and environment-only scope of ``VIRTUALENV_PERIODIC_UPDATE_INSECURE``. |
| 170 | + (:issue:`3436`) |
| 171 | + |
9 | 172 | *********************** |
10 | 173 | v21.14.8 (2026-10-16) |
11 | 174 | *********************** |
|
0 commit comments