Uv 0.12.0 リリース
要約
Rust製の高速なPythonパッケージインストーラーであるuvのバージョン0.12.0がリリースされました。このバージョンでは、プロジェクト初期化時のビルドシステム定義のデフォルト化、サポートされないアーカイブ形式の拒否、インタープリターを上書きする可能性のあるホイールファイルの拒否、依存関係解決における安定版リリース優先などの変更が含まれています。また、requirements.txt内の--require-hashesディレクティブの尊重や、MD5のみのハッシュの拒否なども行われています。
全文翻訳
0.12.0
タグを選択して比較
エラーが発生しました。
フィルタ
読み込み中
エラーが発生しました。
おっと!
読み込み中にエラーが発生しました。このページを再読み込みしてください。
結果が見つかりませんでした
[画像: @astral-automations-bot] astral-automations-bot が 7月28日 18:58 にリリースしました。
変更不可能なリリースです。リリースタイトルとノートのみ変更可能です。
このコミットは GitHub.com 上で作成され、GitHub の検証済み署名で署名されています。
GPG キー ID: B5690EEEBB952194
検証済み
リリースノート
2026年7月28日にリリースされました。
uv 0.11.0 を3月にリリースして以来、多くの変更が蓄積され、正確性、安全性、仕様との互換性が向上しましたが、一部のワークフローを破壊する可能性があります。このリリースにはそれらの変更が含まれており、多くの変更が念のため破壊的であるとマークされています。
ほとんどのユーザーは変更なしでアップグレードできると予想しています。
uvビルドバックエンドの設定に破壊的な変更はありません。[build-system] テーブルに uv_build の上限が含まれている場合は、uv_build>=0.11.32,<0.13 のように、uv_build 0.12 を許可するように更新してください。
破壊的変更
-
uv initでビルドシステムをデフォルトで定義 (#19197)uv initで作成されたプロジェクトは、デフォルトでビルドシステムを宣言し、パッケージ化されるようになりました。これは、v0.3 の頃のデフォルトのプロジェクトレイアウトでしたが、hatchlingビルドシステムの利用が新規ユーザーにとって混乱を招くことが判明したため、v0.4 ではデフォルトでビルドシステムの使用を中止しました。それ以来、uv と緊密に統合された独自のビルドシステム (uv_build) を作成し、デフォルトをベストプラクティスのプロジェクトレイアウトに戻すことを嬉しく思います。以前は、
uv init exampleはmain.pyとビルドシステムのないpyproject.tomlを含む、パッケージ化されていないレイアウトを作成していました。プロジェクトは依存関係を宣言できましたが、それ自体は仮想環境にインストールされませんでした。現在、
uv init exampleはuv_buildを使用する[build-system]を定義し、アプリケーションソースコードをsrc/exampleに配置し、exampleという名前の[project.scripts]エントリを含みます。ビルドシステムを定義することで、プロジェクトをテストや他のコードからインポートしたり、依存関係としてインストールしたり、コマンドとして実行したりできます。$ uv init example $ cd example $ uv run example Hello from example!既存のプロジェクトには影響しません。ビルドシステムのない以前のパッケージ化されていないレイアウトを作成するには、
uv init --no-package exampleを使用してください。詳細については、プロジェクト作成ドキュメントを参照してください。
これにより、
packaged-initプレビュー機能が安定化されました。 -
サポートされていないソース配布および wheel アーカイブ形式の拒否 (#18927)
PEP 625 は、ソース配布に
.tar.gzアーカイブを使用することを要求しています。以前は、uv は.tar.bz2や.tar.xzのようなレガシー形式も受け入れていました。これらの形式は、既存のロックファイルで参照されている場合でも、現在拒否されます。レガシーな.zipソース配布は、後方互換性のために引き続きサポートされています。Wheel およびその他の ZIP アーカイブには、bzip2、LZMA、または XZ で圧縮されたエントリを含めることはできなくなりました。エントリは、stored、DEFLATE、または zstd の圧縮方法を使用する必要があります。
一般的でない圧縮方法のサポートを削除することで、uv の圧縮依存関係と、信頼されていないパッケージを処理する際に公開される攻撃対象領域が削減されます。
この動作をオプトアウトすることはできません。サポートされていない形式を使用するレガシーソース配布に依存している場合は、それを
.tar.gzアーカイブとして再ビルドし、レガシーアーカイブへの参照を含むロックファイルを再生成することをお勧めします。 -
Python インタープリターを上書きする可能性のある wheel ファイルの拒否 (#20748, #20749)
uv は既に
pythonという名前のエントリポイントを拒否していましたが、Pythonのような大文字・小文字のバリアントはまだ受け入れられていました。大文字・小文字を区別しないファイルシステム(一般的な macOS や Windows のセットアップを含む)では、これらのエントリポイントが仮想環境のインタープリターを上書きする可能性がありました。また、Wheel は
.data/scriptsディレクトリや、.data/data/bin/pythonのようなパスにインタープリターファイルを配置することで、エントリポイントチェックをバイパスし、インストール中にインタープリターを置き換えることができました。uv は現在、予約済みのインタープリター名の大文字・小文字を区別しないバリアントや、インタープリターを上書きする wheel データファイルを拒否します。これには、
Python、python.py、Python.exeのような名前や、その他の予約済みインタープリター名とそのバージョン付きバリアントが含まれます。このチェックをオプトアウトすることはできません。競合するエントリポイントまたは wheel データファイルをリネームし、影響を受ける wheel を再ビルドしてください。
-
プレリリース版にフォールバックする前に安定版リリースを優先 (#19993)
依存関係は、解決が開始された後にプレリリース要件を導入する可能性があります。uv は以前、各パッケージのプレリリース適格性を解決開始前に知る必要がありました。デフォルトの
if-necessary-or-explicitモードは、プレリリースを明示的に要求した直接の要件、またはプレリリースのみを公開したパッケージを許可していました。これは、依存関係のメタデータで検出されたプレリリース要件、例えば
example>=2.0.0b1が、互換性のあるプレリリースが存在する場合でも解決に失敗することを意味していました。それを解決するには、その依存関係を直接の要件として追加するか、依存関係グラフ全体でプレリリースを許可する必要がありました。デフォルトモードは
if-necessaryになりました。uv は、アクティブな制約を満たす安定版候補がない場合に、プレリリースにフォールバックする前に安定版候補を最初に試みます。pip と同様に、uv は推移的に検出されたプレリリース要件をサポートするようになりましたが、安定版候補とプレリリース候補の両方が利用可能な場合、以前の uv リリースとは異なるバージョンを選択できます。--prerelease disallowで自動的なプレリリース選択をオプトアウトできます。あるいは、--prerelease allowは安定版を優先せずにプレリリースを考慮し、--prerelease explicitはプレリリースに言及した直接の要件のみを許可します。古い
if-necessary-or-explicitモードは、明示的に要求されたプレリリースと、安定版がないパッケージを区別していました。if-necessaryが両方のケース(推移的な要件を含む)を処理するようになったため、その区別は不要になりました。古い名前はエイリアスとして引き続き利用可能ですが、非推奨であり、将来のリリースで削除される予定です。 -
requirements.txt内の--require-hashesディレクティブを尊重 (#19336)以前は、
uv pip installおよびuv pip syncはrequirements.txtファイル内の--require-hashesについて警告していましたが、ハッシュをチェックせずに依存関係をインストールしていました。現在、このディレクティブは、コマンドラインで--require-hashesが渡された場合と同様に、ハッシュチェックモードを有効にします。たとえば、次の要件ファイルは、要件がピン留めされておらず、ハッシュも提供されていないため、もはや受け入れられません。
--require-hashes anyioディレクティブが存在する間は、この動作をオプトアウトすることはできません。すべての要件を
==でピン留めし、そのハッシュを提供するか、ハッシュチェックが意図されていない場合は--require-hashesを削除してください。 -
ハッシュチェックモードでの MD5 のみによるハッシュの拒否 (#20758)
以前は、
uv pip install --require-hashesおよびuv pip sync --require-hashesは、利用可能なダイジェストが MD5 のみである要件を受け入れていました。MD5 は衝突耐性がないため、それに依存することは、ハッシュ検証を必要とするインストールを損ない、pip の動作とは異なっていました。ハッシュチェックモードは現在、すべての要件に対して少なくとも1つのセキュアなダイジェストを要求します。たとえば、次の要件は、SHA-256 のようなセキュアなハッシュも供給されない限り拒否されます。
anyio==4.0.0 --hash=md5:420d85e19168705cdf0223621b18831aセキュアなハッシュは、要件に直接、または一致する制約ファイルで供給できます。
--require-hashesなしの通常のハッシュ検証は、引き続き MD5 をサポートします。ハッシュチェックが必要な間は、この動作をオプトアウトすることはできません。SHA-256 またはその他のサポートされているセキュアハッシュで影響を受けるハッシュを再生成してください。
-
不正な
pylock.tomlファイルおよびアーティファクトの拒否 (#20402, #20440, #20443)uv は現在、
pylock.toml仕様 の追加要件を検証しています。packages配列が存在する必要があります。以前は、uv は欠落した配列を空のロックファイルとして解釈していたため、uv pip syncは不正な入力を拒否する代わりに環境をアンインストールする可能性がありました。明示的に空のpackages = []配列は引き続き有効です。- ロックファイル名は
pylock.tomlまたはpylock.dev.tomlのような単一の名前のバリアントでなければなりません。pylock..tomlやpylock.foo.bar.tomlのような名前は拒否されます。 - wheel、ソース配布、またはその他のアーティファクトが
sizeを宣言している場合、ダウンロードまたはキャッシュされたアーティファクトは一致する必要があります。以前は、ハッシュが正しい場合、不正なサイズが受け入れられていました。パッケージインデックスによって報告されるサイズは、引き続き助言的なものです。
このチェックをオプトアウトすることはできません。不正なロックファイルを再生成し、不正なファイル名をリネームし、不正なオプションの
size値を修正または削除してください。 -
証明書をロードできない場合でも、明示的な証明書オーバーライドを尊重 (#20741, #20767)
以前は、uv は
SSL_CERT_FILEまたはSSL_CERT_DIRの値が、存在しないかアクセスできないパス、空のファイルまたはディレクトリ、または有効な証明書を持たないソースを指している場合、それらの値を無視していました。代わりに、デフォルトの信頼ルートにフォールバックし、設定されたオーバーライドが拒否することを意図していた HTTPS 接続を許可する可能性がありました。現在、非空の
SSL_CERT_FILEまたはSSL_CERT_DIR値は、有効な証明書をロードできない場合でも、uv のデフォルト証明書ルートを置き換えます。その場合、証明書が信頼されないため、HTTPS リクエストは失敗します。これは、パッケージダウンロードや GitHub Gist を含むリモートスクリプトに適用されます。証明書のオーバーライドを修正するか、 unset してください。unset するとデフォルトの信頼ストアが復元されます。空の環境変数値は引き続き無視されます。
-
uv pipで pip 互換の--cert処理をサポート (#20418)uv pipインターフェースは現在、--cert <パス>を受け入れます。例:$ uv pip install --cert ./company-ca.pem examplepip と同様に、指定された PEM バンドルは、システム証明書や
SSL_CERT_FILEまたはSSL_CERT_DIRを含む、その呼び出しの他のすべての証明書ソースを置き換えます。この変更は、--certを渡さない限り影響しません。必要な証明書機関をバンドルに含めてください。--certはuv pipコマンドでのみサポートされており、他の uv コマンドは既存の証明書構成を引き続き使用します。 -
uv runに渡されたスクリプトに対するプロジェクトの相対的な検出 (#20225)以前は、
uv run project/script.pyは、スクリプトが別のプロジェクトに属している場合でも、カレントディレクトリからプロジェクトを検出していました。uv は現在、スクリプトのディレクトリからプロジェクトおよびワークスペースの検出を開始します。たとえば、
uv run other-project/script.pyを実行すると、現在other-projectとその依存関係が使用されます。これにより、依存関係がインストールされていなかったために以前失敗していたスクリプトが修正されますが、以前とは異なる環境が選択される可能性があります。プロジェクトを明示的に選択することで、スクリプト相対検出をオプトアウトできます。例:
uv run --project . other-project/script.py。これにより、
target-workspace-discoveryプレビュー機能が安定化されました。 -
仮想環境ではないディレクトリをクリアする前に
--forceを要求 (#20225)uv venv --clearは以前、仮想環境でなくても既存のターゲットディレクトリを削除していました。uv は警告を発しましたが、ディレクトリとその内容を削除していました。現在、uv は仮想環境を含まないディレクトリのクリアを拒否します。--forceを明示的に渡すことで、この安全チェックをオプトアウトできます。例:uv venv --clear --force ./not-a-virtualenv。これにより、
venv-safe-clearプレビュー機能が安定化されました。 -
プロジェクト初期化時に
--projectを拒否 (#20225)--projectは既存のプロジェクトを選択するため、新しいプロジェクトを初期化する際には意味がありません。以前は、uv init --project exampleは警告を発してexampleを初期化していましたが、位置引数パスも提供されていた場合、--projectは無視されていました。この使用法は現在エラーとなります。
uv init exampleを使用して要求されたパスにプロジェクトを初期化するか、まずuv init --directory exampleを使用して作業ディレクトリを変更してください。これにより、
init-project-flagプレビュー機能が安定化されました。 -
不正な
--projectパスの拒否 (#20225)uv は以前、
--projectが存在しないディレクトリやpyproject.toml以外のファイルを指している場合に警告を発していましたが、その後も続行しようとしていました。これは後で混乱を招くエラーを引き起こしたり、意図しないプロジェクトに対して実行されたりする可能性がありました。現在、
uv run --project missing pythonは続行せずにすぐに失敗します。この動作をオプトアウトすることはできません。先にディレクトリを作成するか、既存のプロジェクトを選択してください。--project path/to/pyproject.tomlを渡すことは引き続きサポートされており、そのファイルの親ディレクトリを選択します。これにより、
project-directory-must-existプレビュー機能が安定化されました。 -
公開時に正規化されていないファイル名の配布をスキップ (#20225)
配布ファイル名には、正規化されたパッケージ名とバージョンを使用する必要があります。たとえば、バージョン
1.01.0の wheel は、example-1.01.0-py3-none-any.whlではなく、example-1.1.0-py3-none-any.whlと命名される必要があります。以前は、
uv publishは正規化されていないファイル名について警告していましたが、それでもアップロードを試みていました。現在、影響を受ける wheel とソース配布はスキップされます。この動作をオプトアウトすることはできません。公開前に正規化されたファイル名で配布を再ビルドしてください。
これにより、
publish-require-normalizedプレビュー機能が安定化されました。 -
baseおよびrootという名前の Conda 環境をパスで分類 (#20225)baseまたはrootという名前の Conda 環境は、それらが通常のチャイルド環境であっても、以前はベース Conda 環境であると想定されていました。uv は現在、他の名前に対して既に実行しているように、パスに基づいてチャイルド Conda 環境を認識します。--python /path/to/pythonを使用してインタープリターを明示的に要求することで、自動インタープリター選択をオプトアウトできます。これにより、
special-conda-env-namesプレビュー機能が安定化されました。 -
環境検出中に破損した
.venvシンボリックリンクの拒否 (#20433)以前は、uv は破損した
.venvシンボリックリンクを無視し、別の仮想環境を検索するために親ディレクトリを検索し続けることがありました。その結果、uv pip installのようなコマンドが、予期せず無関係な祖先環境を変更する可能性がありました。uv は現在、破損した
.venvシンボリックリンクで停止し、その正確なパスを報告します。仮想環境メタデータの読み取り中に発生したエラー(権限エラーを含む)も、無視されるのではなく、即座に報告されます。この動作をオプトアウトすることはできません。破損した
.venvシンボリックリンクを修復または削除し、uv が環境を検査するのを妨げる権限を修正してください。 -
インストール済みの Python パッチバージョンと一致する場合、暗黙的にアップグレードするのではなく再インストール (#20659)
Python アップグレードがサポートされる前は、
uv python install 3.12 --reinstallは最新の Python 3.12 パッチリリースをインストールする手段としても機能していました。--upgradeが利用可能になった現在、--reinstallは既に存在する一致するパッチリリースを再インストールします。たとえば、Python 3.12.6 と 3.12.7 がインストールされている場合、
uv python install 3.12 --reinstallは、利用可能な最新の 3.12 リリースをインストールするのではなく、両方のバージョンを再インストールします。uv python install 3.12 --upgradeを使用して、以前のアップグレード動作を回復できます。--upgrade --reinstallを組み合わせると、最新のパッチのみを再インストールできます。 -
--upgrade-groupが既存の依存関係グループを指すことを要求 (#18957)以前は、
uv lock --upgrade-group docsは、docs依存関係グループが存在しない場合でも、サイレントに成功していました。uv は現在、要求されたグループをプロジェクト、そのワークスペースメンバー、およびワークスペースレベルの依存関係グループに対して検証します。この動作をオプトアウトすることはできません。グループ名を修正するか、
[dependency-groups]に追加してください。レガシーなtool.uv.dev-dependenciesは、引き続き--upgrade-group devを満たします。 -
--directoryに対して相対インデックスと find-links を解決 (#20740)--directoryオプションは、uv が操作するディレクトリを変更します。以前は、コマンドラインで指定された相対インデックスおよび find-links パスは、元の作業ディレクトリに対して解決されていました。uv は現在、
--index、--default-index、--index-url、--extra-index-url、および--find-linksを--directoryで選択されたディレクトリに対して相対的に解決します。例:$ uv add --directory project --index ./packages exampleこれは現在、元の作業ディレクトリの
./packagesではなく、project/packagesを使用します。絶対パスおよび設定ファイルからロードされたインデックスは影響を受けません。以前のターゲットを維持するには、絶対パスを渡すか、相対パスを調整してください。例:
--index ../packages。 -
uv addに渡された絶対パスを保持 (#18402)uv addは以前、元の要求が絶対パスまたはリテラルのfile://URL を使用していた場合でも、すべてのローカル依存関係をプロジェクト相対パスに変換していました。現在、pyproject.tomlおよびuv.lockで要求の形式を保持します。$ uv add ../library # 相対のまま $ uv add /projects/library # 絶対のまま絶対パスはプロジェクトの移植性を低下させます。絶対パスの記録を避けるために相対パスを使用してください。展開された変数を含む URL は、既存の相対パスの動作を保持します。
-
bzip2 アーカイブとしてのみ利用可能な古い PyPy 配布の削除 (#20423)
.tar.bz2アーカイブとしてのみ配布されている古い PyPy パッチリリースは、uv python installを介して利用できなくなりました。これらのリリースはサポートされていない bzip2 アーカイブを必要とします。サポートされている各 Python マイナーバージョンに対する最新の PyPy リリースは、gzip 圧縮アーカイブとして利用可能であり、引き続きサポートされています。たとえば、
uv python list 3.10 --all-versionsには最新の PyPy 3.10 リリースが含まれますが、古い bzip2 のみによるパッチリリースは除外されます。この動作をオプトアウトすることはできません。代わりに、より新しい PyPy パッチリリースを要求してください。
-
アノテーションが無効な場合に除外パッケージコメントを省略 (#20085)
uv pip compile --no-annotateは、生成された要件ファイルを説明するコメントを抑制します。以前は、--unsafe-packageで除外されたパッケージをリストするフッターが、アノテーションが無効になっていても含まれていました。そのフッターは現在省略されます。--no-annotateを削除することで、フッターを回復できます。
安定化
-
TOML 1.0 互換のソース配布 (#20225)
uv_buildは現在、ソース配布をビルドする際に TOML 1.0 互換のpyproject.tomlを書き込むため、古い Python ビルドフロントエンドが新しい TOML 構文を使用するプロジェクトを消費できるようになります。元のプロジェクトファイルは、アーカイブ内のpyproject.toml.origとして引き続き利用可能です。これにより、
toml-backwards-compatibilityプレビュー機能が安定化されました。 -
Unix での自動オープンファイル制限調整 (#20225)
Linux および macOS では、uv は起動時にソフトオープンファイル制限をハード制限に向かって引き上げようとします。上限は 1,048,576 デスクリプタです。新しい制限はサブプロセスにも適用され、ファイルディスクリプタ不足による失敗を減らします。制限を引き上げられない場合、uv は既存の制限で実行を続行します。
これにより、
adjust-ulimitプレビュー機能が安定化されました。
プレビュー機能
uv upgradeが複数のパッケージを対象とし、すべてのプロダクション依存関係をアップグレードし、選択した依存関係を除外できるようにする (#20338)
バグ修正
- 依存関係グループによってアクティブ化された extras を、競合の評価に含める (#20237)
uv 0.12.0 をインストールする
シェルスクリプト経由で事前ビルド済みバイナリをインストールする
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/uv/releases/download/0.12.0/uv-installer.sh | sh
PowerShell スクリプト経由で事前ビルド済みバイナリをインストールする
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/uv/releases/download/0.12.0/uv-installer.ps1 | iex"
uv 0.12.0 をダウンロードする
GitHub アーティファクトの証明書の検証
このリリースのアートファクトには、GitHub アーティファクト証明書で生成された証明書が含まれています。これらは GitHub CLI を使用して検証できます。
gh attestation verify <ダウンロードしたアーティファクトのファイルパス> --repo astral-sh/uv
GitHub から証明書をダウンロードして、直接検証することもできます。
gh attestation verify <ダウンロードしたアーティファクトのファイルパス> --bundle <ダウンロードした証明書のファイルパス>
アセット 45
読み込み中
おっと!
読み込み中にエラーが発生しました。このページを再読み込みしてください。
bidu2352, servusdei2018, nereu-ls, ashleyconnor, subdavis, henderson-01, mjtf3, clemstoquart, iAGorynT, acarapetis, および 32 名がいいね絵文字で反応しました。
Chroma01, Denisskas, binbjz, および wuyu1222602 が笑い絵文字で反応しました。
astrojuanlu, my1e5, leodevian, r1quant, hallvardnmbu, servusdei2018, ashleyconnor, subdavis, kaangiray26, sassdavid, および 29 名が拍手絵文字で反応しました。
orishamir, ashleyconnor, kr0leg, dfgshdsfh, joshsleeper, NikTerentev, mochlast, Perer876, woile, ArisTem, および 11 名がハート絵文字で反応しました。
leodevian, sebadevo, r1quant, hallvardnmbu, orpheezt, servusdei2018, orishamir, caiopiccirillo, ashleyconnor, subdavis, および 27 名がロケット絵文字で反応しました。
xplosionmind, Denisskas, および binbjz が目絵文字で反応しました。
すべての反応
- 👍 42 件の反応
- 😄 4 件の反応
- 🎉 39 件の反応
- ❤️ 21 件の反応
- 🚀 37 件の反応
- 👀 3 件の反応
90 名が反応しました