HN 日本語サマリー

← 一覧へ戻る
プログラミング

Uv 0.12.0 リリース

Uv 0.12.0 (github.com)

100 pointsby hallvard36 コメント

要約

Rust製の高速なPythonパッケージインストーラーであるuvのバージョン0.12.0がリリースされました。このバージョンでは、プロジェクト初期化時のビルドシステム定義のデフォルト化、サポートされないアーカイブ形式の拒否、インタープリターを上書きする可能性のあるホイールファイルの拒否、依存関係解決における安定版リリース優先などの変更が含まれています。また、requirements.txt内の--require-hashesディレクティブの尊重や、MD5のみのハッシュの拒否なども行われています。

全文翻訳

0.12.0

タグを選択して比較

エラーが発生しました。

フィルタ

読み込み中

エラーが発生しました。

おっと!

読み込み中にエラーが発生しました。このページを再読み込みしてください。

結果が見つかりませんでした

すべてのタグを表示

[画像: @astral-automations-bot] astral-automations-bot が 7月28日 18:58 にリリースしました。

変更不可能なリリースです。リリースタイトルとノートのみ変更可能です。

0.12.0

b88d7c5

このコミットは 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 example
    

    pip と同様に、指定された 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 名が反応しました