Conversation
6d7843b to
9405a80
Compare
2130cd5 to
61ac440
Compare
61ac440 to
3bbb063
Compare
Contributor
Author
|
3bbb063 to
754d40c
Compare
8b72401 to
ce8d565
Compare
ce8d565 to
c1b7286
Compare
988ca88 to
7627f01
Compare
7627f01 to
12a2468
Compare
12a2468 to
f3ad960
Compare
f3ad960 to
4ed22b2
Compare
4ed22b2 to
c209f6c
Compare
c209f6c to
81408ab
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
0.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.00.9.5→0.10.0Release Notes
astral-sh/uv (uv-auth)
v0.10.0Compare Source
Since we released uv 0.9.0 in October of 2025, we've accumulated various changes that improve correctness and user experience, but could break some workflows. This release contains those changes; many have been marked as breaking out of an abundance of caution. We expect most users to be able to upgrade without making changes.
This release also includes the stabilization of preview features. Python upgrades are now stable, including the
uv python upgradecommand,uv python install --upgrade, and automatically upgrading Python patch versions in virtual environments when a new version is installed. Theadd-boundsandextra-build-dependenciessettings are now stable. Finally, theuv workspace diranduv workspace listutilities for writing scripts against workspace members are now stable.Breaking changes
Require
--clearto remove existing virtual environments inuv venv(#17757)Previously,
uv venvwould prompt for confirmation before removing an existing virtual environment in interactive contexts, and remove it without confirmation in non-interactive contexts. Now,uv venvrequires the--clearflag to remove an existing virtual environment. A warning for this change was added in uv 0.8.You can opt out of this behavior by passing the
--clearflag or settingUV_VENV_CLEAR=1.Error if multiple indexes include
default = true(#17011)Previously, uv would silently accept multiple indexes with
default = trueand use the first one. Now, uv will error if multiple indexes are marked as the default.You cannot opt out of this behavior. Remove
default = truefrom all but one index.Error when an
explicitindex is unnamed (#17777)Explicit indexes can only be used via the
[tool.uv.sources]table, which requires referencing the index by name. Previously, uv would silently accept unnamed explicit indexes, which could never be referenced. Now, uv will error if an explicit index does not have a name.You cannot opt out of this behavior. Add a
nameto the explicit index or remove the entry.Install alternative Python executables using their implementation name (#17756, #17760)
Previously,
uv python installwould install PyPy, GraalPy, and Pyodide executables with names likepython3.10into the bin directory. Now, these executables will be named using their implementation name, e.g.,pypy3.10,graalpy3.10, andpyodide3.12, to avoid conflicting with CPython installations.You cannot opt out of this behavior.
Respect global Python version pins in
uv tool runanduv tool install(#14112)Previously,
uv tool runanduv tool installdid not respect the global Python version pin (set viauv python pin --global). Now, these commands will use the global Python version when no explicit version is requested.For
uv tool install, if the tool is already installed, the Python version will not change unless--reinstallor--pythonis provided. If the tool was previously installed with an explicit--pythonflag, the global pin will not override it.You can opt out of this behavior by providing an explicit
--pythonflag.Remove Debian Bookworm, Alpine 3.21, and Python 3.8 Docker images (#17755)
The Debian Bookworm and Alpine 3.21 images were replaced by Debian Trixie and Alpine 3.22 as defaults in uv 0.9. These older images are now removed. Python 3.8 images are also removed, as Python 3.8 is no longer supported in the Trixie or Alpine base images.
The following image tags are no longer published:
uv:bookworm,uv:bookworm-slimuv:alpine3.21uv:python3.8-*Use
uv:debianoruv:trixieinstead ofuv:bookworm,uv:alpineoruv:alpine3.22instead ofuv:alpine3.21, and a newer Python version instead ofuv:python3.8-*.Drop PPC64 (big endian) builds (#17626)
uv no longer provides pre-built binaries for PPC64 (big endian). This platform appears to be largely unused and is only supported on a single manylinux version. PPC64LE (little endian) builds are unaffected.
Building uv from source is still supported for this platform.
Skip generating
activate.cshfor relocatable virtual environments (#17759)Previously,
uv venv --relocatablewould generate anactivate.cshscript that contained hardcoded paths, making it incompatible with relocation. Now, theactivate.cshscript is not generated for relocatable virtual environments.You cannot opt out of this behavior.
Require username when multiple credentials match a URL (#16983)
When using
uv auth loginto store credentials, you can register multiple username and password combinations for the same host. Previously, when uv needed to authenticate and multiple credentials matched the URL (e.g., when retrieving a token withuv auth token), uv would pick the first match. Now, uv will error instead.You cannot opt out of this behavior. Include the username in the request, e.g.,
uv auth token --username foo example.com.Avoid invalidating the lockfile versions after an
exclude-newerchange (#17721)Previously, changing the
exclude-newersetting would cause package versions to be upgraded, ignoring the lockfile entirely. Now, uv will only change package versions if they are no longer within theexclude-newerrange.You can restore the previous behavior by using
--upgradeor--upgrade-packageto opt-in to package version changes.Upgrade
uv formatto Ruff 0.15.0 (#17838)uv formatnow uses Ruff 0.15.0, which uses the 2026 style guide. See the blog post for details.The formatting of code is likely to change. You can opt out of this behavior by requesting an older Ruff version, e.g.,
uv format --version 0.14.14.Update uv crate test features to use
test-as a prefix (#17860)This change only affects redistributors of uv. The Cargo features used to gate test dependencies, e.g.,
pypi, have been renamed with atest-prefix for clarity, e.g.,test-pypi.Stabilizations
uv python upgradeanduv python install --upgrade(#17766)When installing Python versions, an intermediary directory without the patch version attached will be created, and virtual environments will be transparently upgraded to new patch versions.
See the Python version documentation for more details.
uv add --boundsand theadd-boundsconfiguration option (#17660)This does not come with any behavior changes. You will no longer see an experimental warning when using
uv add --boundsoradd-boundsin configuration.uv workspace listanduv workspace dir(#17768)This does not come with any behavior changes. You will no longer see an experimental warning when using these commands.
extra-build-dependencies(#17767)This does not come with any behavior changes. You will no longer see an experimental warning when using
extra-build-dependenciesin configuration.Enhancements
pyx.devas a target inuv authcommands despitePYX_API_URLdiffering (#17856)Bug fixes
v0.9.30Compare Source
Released on 2026-02-04.
Python
Enhancements
--extraoption (#17525)UV_HTTP_TIMEOUTerror message (#17493)Preview features
Bug fixes
uv publishwhen using pyx (#17832)v0.9.29Compare Source
Released on 2026-02-03.
Python
Enhancements
uv version --bump devsimilar to pre-release bumps (#17796)uv publishserver errors (#17787)uv publishtrace logs (#17784)Preview features
baseanddefaultconda environment names (#17758)Bug fixes
PYTHONHOMEinheritance when spawning different Python versions (#17821)EqualStarandNotEqualStaroperators (#17751)system-configurationin sandboxes (#17829)Documentation
Security
--help(#17745)v0.9.28Compare Source
Released on 2026-01-29.
Python
Enhancements
default = true(#17713)Configuration
Bug fixes
uv.exeexits whenuvw.exeoruvx.exeis killed (#17500)v0.9.27Compare Source
Released on 2026-01-26.
Python
Enhancements
-tshortform for--targettouv pipsubcommands (#17501)uv pip freeze --excludeflag (#17045)--systemand--no-systeminuv venv(#17647)uv pip compileattempt to download a specified--python-versionif it can. (#17249)exclude-newer-package(#17665)Preview features
uv python upgrade(#17653)Bug fixes
SSL_CERT_FILEis a directory (#17503)Documentation
--lockedto installcargo-xwinin guide (#17530)Other changes
v0.9.26Compare Source
Released on 2026-01-15.
Python
Enhancements
--no-sources-package(#14910)Preview features
METADATA.jsonandWHEEL.jsonin uv build backend (#15510)Bug fixes
Documentation
pyproject.tomlexamples for more system-level settings (#17462)v0.9.25Compare Source
Released on 2026-01-13.
Python
Enhancements
--compile-bytecodetouv python installanduv python upgradeto compile the standard library (#17088)exclude-newerper package (#16854)WM_SETTINGCHANGEonuv tool update-shell(#17404)Preview features
uv runtarget (#17423)Bug fixes
tool@latestversion (#17448)v0.9.24Compare Source
Released on 2026-01-09.
Bug fixes
UV_NO_SYNC=1 uv run ...(#17391)--no-cache(#17387)Documentation
v0.9.23Compare Source
Released on 2026-01-09.
Enhancements
RECORDfiles (#17339)UV_PYTHON_BIN_DIRandUV_TOOL_BIN_DIR(#17367)Preview features
Configuration
Bug fixes
armv8las an alias forarmv7lin platform tag parsing (#17384)Documentation
index.mdsuggestion tollms.txt(#17362)uv runuses inexact syncing by default (#17366)v0.9.22Compare Source
Released on 2026-01-06.
Enhancements
Bug fixes
Documentation
v0.9.21Compare Source
Released on 2025-12-30.
Bug fixes
Documentation
python install --defaultdocumentation (#9826)v0.9.20Compare Source
Released on 2025-12-29.
This is a re-release of 0.9.19, with internal crate versions incremented to enable publishing to crates.io.
v0.9.18Compare Source
Released on 2025-12-16.
Enhancements
uv publish(#17096)uv publish(#17130)python3.x-alpine3.23(#17100)Configuration
--torch-backendin[tool.uv](#17116)Performance
uv cache size(#17015)Bug fixes
@latestrequests (#17114)EntryTypefor file entries in tar (#17043)pyproject.tomlindex username in lockfile comparison (#16995)uv addwithUV_GIT_LFSset (#17127)exclude-newerinto optional string (#17121)Documentation
exclude-newer*(#17079)v0.9.17Compare Source
Released on 2025-12-09.
Enhancements
torch-tensorrtandtorchaoto the PyTorch list (#17053)--verboseinuv tool run(#17020)exclude-newer(a.k.a., dependency cooldowns) (#16814)Bug fixes
Documentation
source-excludereference docs (#16832)UV_NO_DEVin Docker installs (#17030)UV_VERSIONin docs for GitLab CI/CD (#17040)v0.9.16Compare Source
Released on 2025-12-06.
Python
Enhancements
debugsubcommand touv pipannouncing its intentional absence (#16966)uv add --script(#16954)uv self update(#16838)--no-binaryet al inuv pip compile(#16956)--targetand--prefixinuv pip list,uv pip freeze, anduv pip show(#16955)Preview features
uv workspace metadata(#16988)uv auth helper --protocol bazelcommand (#16886)Bug fixes
tool.uv.build-backend.module-namebut emit warnings (#16928)Documentation
--projectflag help text to indicate project discovery (#16965)COPYoverADDfor simple cases (#16883)v0.9.15Compare Source
Released on 2025-12-02.
Python
Enhancements
--torch-backend=auto(#16919)Configuration
UV_HIDE_BUILD_OUTPUTto omit build logs (#16885)Bug fixes
uv-trampoline-builderbuilds from crates.io by moving bundled executables (#16922)NO_COLORand always show the command as a header when paginguv helpoutput (#16908)0o666permissions for flock files instead of0o777(#16845)astral-tlto v0.7.10 (#16887)" to narrow down a regression causing hangs in metadata retrieval (#16938)Documentation
v0.9.14Compare Source
Released on 2025-12-01.
Performance
astral-tlto v0.7.10 to enable SIMD for HTML parsing (#16887)Bug fixes
.zshenvover creating a new one intool update-shell(#16866)-eflags inuv add(#16882)Enhancements
UV_WORKING_DIRoverUV_WORKING_DIRECTORYfor consistency (#16884)v0.9.13Compare Source
Released on 2025-11-26.
Bug fixes
--with-requirementsto load extensionless inline-metadata scripts" to fix reading of requirements files from streams (#16861)Requires-Pythonand required environments (#16824)Documentation
v0.9.12Compare Source
Released on 2025-11-24.
Enhancements
--with-requirementsto load extensionless inline-metadata scripts (#16744)uv publish(#16731)uv exportfrom overwritingpyproject.toml(#16745)Documentation
v0.9.11Compare Source
Released on 2025-11-20.
Python
See the
python-build-standalonerelease notes for details.Enhancements
uv export(#16523)crates.io(#16770)Preview features
uv workspace list --paths(#16776)uv workspace dir(#16775)Bug fixes
uv initauthor serialization viatoml_editinline tables (#16778)pyproject.toml(#16734)always-authenticatewhen running under Dependabot (#16773)Documentation
v0.9.10Compare Source
Released on 2025-11-17.
Enhancements
SSL_CERT_DIR(#16473)uv build(#16699)project.license-filesglob matches nothing (#16697)pip install --target(andsync) install Python if necessary (#16694)python_downloads_json_urlin pre-release Python version warnings (#16737)uv python --python-downloads-json-url(#16542)Preview features
--upgradeinuv python install(#16676)python install --defaultfor pre-release Python versions (#16706)uv workspace listto list workspace members (#16691)Bug fixes
Documentation
v0.9.9Compare Source
Released on 2025-11-12.
Deprecations
--projectinuv init(#16674)Enhancements
uv version --bump(#16555).rcdatato store metadata (#15068)--only-emit-workspaceand similar variants touv export(#16681)Preview features
uv workspace dircommand (#16678)uv workspace metadatacommand (#16516)Configuration
UV_NO_DEFAULT_GROUPSenvironment variable (#16645)Bug fixes
torch-model-archiverandtorch-tb-profilerfrom PyTorch backend (#16655)Documentation
CMDpath in FastAPI Dockerfile (#16701)v0.9.8Compare Source
Released on 2025-11-07.
Enhancements
uv export(#16603)uv sync(#16543)uv cache sizecommand (#16032)+gilto require a GIL-enabled interpreter (#16537)uv initerror for invalid directory names (#16554)uv build -h(#16632)Configuration
UV_NO_GROUPas an environment variable (#16529)UV_NO_SOURCESas an environment variable (#15883)Bug fixes
--checkand--lockedto be used together inuv lock(#16538)default-groupsin schema (#16575)nvidia-smi(#15460)Documentation
uv pip listname normalization in docs (#13210)Other changes
v0.9.7Compare Source
Released on 2025-10-30.
Enhancements
Bug fixes
uv auth tokenoutput (#16504)--checkflag (#16521)v0.9.6Compare Source
Released on 2025-10-29.
This release contains an upgrade to Astral's fork of
async_zip, which addresses potential sources of ZIP parsing differentials between uv and other Python packaging tooling. See GHSA-pqhf-p39g-3x64 for additional details.Security
Python
Enhancements
--cleartouv buildto remove old build artifacts (#16371)--no-create-gitignoretouv build(#16369)pip install --systemwhen externally managed (#16392)uv lock --checkwith outdated lockfile will print that--checkwas passed, instead of--locked(#16322)uv inittemplate for Maturin (#16449)Bug fixes
uv python upgrade(#16420)--find-linksdistributions (#16446)uv export --frozenwhen the lockfile is outdated (#16407)uv treewhen--packageis used with circular dependencies (#15908)pip freeze --quiet(#16491)uv auth login pyx.devretries to 60s (#16498)uv add --group ... -r ...(#16490)Documentation
Configuration
📅 Schedule: Branch creation - "on tuesday" (UTC), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about these updates again.
This PR was generated by Mend Renovate. View the repository job log.