●Change8

Migrating to uv 0.9.16

Version 0.9.16 introduces 2 breaking changes. This guide details how to update your code.

Released: 12/6/2025

2
Breaking Changes
2
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

uv pip debuguv add --scriptuv self updateuv pip compileuv pip listuv pip freezeuv pip showuv auth helperuv workspace metadatatool.uv.build-backend.module-name

Breaking Changes

●Issue #1

Built wheels for the wrong platform now trigger an error instead of proceeding silently.

●Issue #2

File lock acquisition now has a 5-minute default timeout, which may cause failures in environments where locks were held longer.

Migration Steps

  1. 1
    If using Homebrew, follow the new specific messaging when running 'uv self update'.
  2. 2
    Review Dockerfiles to prefer 'COPY' over 'ADD' for simple cases as per updated documentation.

Release Summary

This release introduces support for new CPython versions, adds a Bazel auth helper, and implements a 5-minute timeout for file locks to prevent deadlocks. It also includes several CLI enhancements for 'uv pip' and 'uv add', alongside performance improvements in HTML parsing.

Need More Details?

View the full release notes and all changes for uv 0.9.16.

View Full Changelog