Skip to content

Commit e53e30b

Browse files
release 21.14.9
1 parent 2519941 commit e53e30b

40 files changed

Lines changed: 163 additions & 133 deletions

‎docs/changelog.rst‎

Lines changed: 163 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,169 @@
66

77
.. towncrier release notes start
88
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+
9172
***********************
10173
v21.14.8 (2026-10-16)
11174
***********************

‎docs/changelog/3398.bugfix.rst‎

Lines changed: 0 additions & 2 deletions
This file was deleted.

‎docs/changelog/3399.bugfix.rst‎

Lines changed: 0 additions & 2 deletions
This file was deleted.

‎docs/changelog/3400.bugfix.rst‎

Lines changed: 0 additions & 4 deletions
This file was deleted.

‎docs/changelog/3401.bugfix.rst‎

Lines changed: 0 additions & 2 deletions
This file was deleted.

‎docs/changelog/3402.bugfix.rst‎

Lines changed: 0 additions & 2 deletions
This file was deleted.

‎docs/changelog/3403.bugfix.rst‎

Lines changed: 0 additions & 2 deletions
This file was deleted.

‎docs/changelog/3404.bugfix.rst‎

Lines changed: 0 additions & 4 deletions
This file was deleted.

‎docs/changelog/3405.bugfix.rst‎

Lines changed: 0 additions & 2 deletions
This file was deleted.

‎docs/changelog/3406.bugfix.rst‎

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)