●Change8

Migrating to uv 0.9.10

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

Released: 11/17/2025

2
Breaking Changes
2
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

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

SSL_CERT_DIRuv buildproject.license-filespip install --targetuv python --python-downloads-json-urluv python install --upgradeuv python install --defaultuv workspace list

Breaking Changes

●Issue #1

uv build now enforces UTF-8 encoding for license files; ensure license files are UTF-8 encoded to avoid build failures.

●Issue #2

uv build now errors if a project.license-files glob matches no files; ensure glob patterns are correct or files exist.

Migration Steps

  1. 1
    Verify that all license files referenced in project.license-files are UTF-8 encoded.
  2. 2
    Check project.license-files glob patterns to ensure they match at least one file.

Release Summary

This release introduces workspace listing and Python upgrade capabilities, improves SSL and license file handling, and enables automatic Python installation for targeted pip installs.

Need More Details?

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

View Full Changelog