Pythonでは、多くの便利なパッケージが提供されています。これらのパッケージは通常、ネットワークを経由してAnacondaやpipなどのリポジトリからインストールします。しかし、ネットワークに接続できない環境でPython環境を構築する必要がある場合、リポジトリからパッケージをインストールすることはできません。
そんなときに役立つのが、wheelファイル(拡張子が.whlのファイル)を使ったパッケージのインストール方法です。この記事では、その方法を紹介します。
wheelファイルとは
wheelファイルは、ZIPフォーマットのアーカイブファイルです。Pythonでパッケージを配布する形式は大きく2種類あり、wheelはBuild Distributionと呼ばれる配布形式です。その名の通りビルド済みの配布物で、ユーザは所定の場所に解凍して配置するだけで使用することができます(ビルドの必要なし)。
wheelファイルの準備
まずはインストールするパッケージのwheelファイルを用意する必要があります。PyPIのサイトからダウンロードすることができます。
wheelファイルのインストール
ファイルを用意したら、Pythonの環境にインストールします。ファイルを配置したディレクトリに移動し、以下のコマンドを実行します。
pip install --no-deps numpy-1.23.4-pp38-pypy38_pp73-win_amd64.whl
なお、現状 condaコマンドはwheelとの互換性はありません。Anacondaを利用している場合でも、condaコマンドではなくpipを使う必要があるので注意してください。
エラーが出る場合
.whlをインストールしようとした際、場合によっては以下のようなエラーが出ることがあります。
pip install numpy-1.23.4-pp38-pypy38_pp73-win_amd64.whl
>> ERROR: numpy-1.23.4-pp38-pypy38_pp73-win_amd64.whl is not a supported wheel on this platform.
これは、インストールしようとしているwheelファイルがインストールしようとしている環境に適していないために出るエラーです。wheelファイルはそのファイルが作成された環境に依存しており、パッケージをインストールする際に導入対象の環境に適したwhlを指定する必要があります。
まとめ
wheelを使ってオフライン環境にPythonパッケージをインストールする方法を紹介しました。wheel形式のインストールは当然オンライン環境でも可能です。パッケージインストール方法のオプションとして知っておきたいところです。