PythonパッケージングライブラリSetuptoolsの公式ビルドシステムリポジトリ。Pythonプロジェクトのビルドと配布に使われます。
pypa/wheel
Python wheel(.whl)ファイルの検査、展開、再パッケージ化、タグ変更と、eggからwheelへの変換を行うコマンドラインツール。
- スター
- 579
- フォーク
- 199
- 未解決の Issue
- 22
- 最終コミット
- 9 日前
これは何?
wheelは、PEP 427で定義されたwheel形式のPythonバイナリ配布ファイルを扱う、PyPA公式のコマンドラインツールです。wheelはビルド済みのパッケージアーカイブで、ユーザーの環境でビルドを実行せずにpipからPythonプロジェクトをインストールできます。
このツールでは、従来の.eggアーカイブから.whlへの変換、wheelのディレクトリへの展開、編集したディレクトリからwheelへの再パッケージ化、既存wheelへのプラットフォームタグやインタープリタータグの追加・削除という4つの操作ができます。パッケージの対象プラットフォームを変更したり、変更後に再パッケージ化したりする際に便利です。
このプロジェクトでは、bdist_wheelビルドコマンドの提供を終了しています。setuptools v70.1以降は、setuptools単独でwheelをビルドできます。wheelコマンドラインツールが必要な場合にのみ、このパッケージをインストールしてください。
主な機能
- 01.eggアーカイブを.whl形式に変換
- 02wheelアーカイブをディレクトリに展開
- 03編集したディレクトリをwheelファイルに再パッケージ化
- 04既存のwheelにタグを追加・削除
ユースケース
- wheelのタグを変更して、対象プラットフォームやPythonバージョンを切り替える
- 再配布の前にwheelの内容を確認または編集する
- 古いeggベースの配布物をwheel形式に移行する
使う前に知っておきたいこと
- setuptools は wheel のビルドに wheel を必要としなくなったため、wheel コマンドラインツールが必要な場合にのみ役立ちます。
トピック
よくある質問
- wheel とは?
- Python wheel(.whl)ファイルの検査、展開、再パッケージ化、タグ変更と、eggからwheelへの変換を行うコマンドラインツール。 wheelは、PEP 427で定義されたwheel形式のPythonバイナリ配布ファイルを扱う、PyPA公式のコマンドラインツールです。wheelはビルド済みのパッケージアーカイブで、ユーザーの環境でビルドを実行せずにpipからPythonプロジェクトをインストールできます。
- wheel は無料で使えますか?ライセンスは?
- wheel は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- wheel は今もメンテナンスされていますか?
- 活発にメンテナンス中。wheel の最終コミットは 2026年10月28日 です。
- wheel は何に使えますか?
- wheelのタグを変更して、対象プラットフォームやPythonバージョンを切り替える 再配布の前にwheelの内容を確認または編集する 古いeggベースの配布物をwheel形式に移行する
- wheel はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/pypa/wheel
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
ビルドシステムに依存せず、Pythonのソース配布物やwheelをPyPIにアップロードするコマンドラインツール。
Rust製の超高速なPythonパッケージ/プロジェクト管理ツール。pip、virtualenv、pyenv、pipxなどを置き換えます。
pipとvirtualenvを組み合わせ、PipfileとPipfile.lockで再現性の高いビルドを実現する、Python向けのvirtualenv・依存関係管理ツール。
Python Package Index(PyPI)やその他のインデックスからパッケージをインストールする、Python標準のパッケージインストーラーです。
Pythonの依存関係を固定した再現可能なrequirementsファイルにまとめ、環境をその内容に同期するコマンドラインツール(pip-compile、pip-sync)のセット。