Pythonでpipインストーラーをブートストラップする方法（ensurepipモジュール活用ガイド）

Pythonの標準ディストリビューションに組み込まれているモジュールやパッケージに加えて、サードパーティの開発者による多数のパッケージが「Python Package Index（PyPI）」（https://pypi.org/）と呼ばれるPythonパッケージリポジトリに公開されています。ここからパッケージをインストールするには、pipユーティリティが必要です。pipは独立したプロジェクトですが、Python 3.4以降ではPythonディストリビューションにブートストラップ（同梱・自動セットアップ）されるようになりました。

ensurepipモジュールとは

ensurepipモジュールは、既存のPython環境にpipをブートストラップするための機能を提供します。通常、ユーザーがこのモジュールを明示的に使う必要はありません。しかし、通常のインストールや仮想環境の作成時にpipのインストールがスキップされた場合には、このモジュールの出番となります。

pipなしの仮想環境を作成する

以下のコマンドを実行すると、pipがインストールされていない仮想環境を作成できます。

C:\python37>python -m venv --without-pip e:\testenv

仮想環境ディレクトリ内のscriptsフォルダには、pipユーティリティが含まれていません。そこで、ensurepipモジュールを使って、システム全体のインストールに含まれるバージョンのpipを組み込みます。最新版をインストールしたい場合は--upgradeオプションを指定します。

E:\testenv>scripts\python -m ensurepip --upgrade
Looking in links: C:\Users\acer\AppData\Local\Temp\tmpp1bb2lym
Collecting setuptools
Collecting pip
Installing collected packages: setuptools, pip
Successfully installed pip-18.1 setuptools-40.6.2

ensurepipの主なオプション

デフォルトのpipインストール動作は、以下のオプションで変更できます。

• --root <dir> − 現在アクティブな仮想環境のルート（存在する場合）や現在のPythonインストールのデフォルトのルートではなく、指定したルートディレクトリを基準にpipをインストールします。

• --user − 現在のPythonインストールに対してグローバルにインストールする代わりに、ユーザーのsite-packagesディレクトリにpipをインストールします（アクティブな仮想環境内ではこのオプションは使用できません）。

ensurepipモジュールが定義する関数

ensurepipモジュールには、次の2つの関数が定義されています。

• ensurepip.version() − 環境をブートストラップする際にインストールされる、バンドルされているpipのバージョンを文字列で返します。

• ensurepip.bootstrap() − 現在の環境または指定された環境にpipをブートストラップします。

注意点：副作用について

ブートストラップ処理は、sys.pathとos.environの両方に副作用をもたらします。また、ブートストラップの過程でpipが必要とする追加のモジュールがインストールされる場合がありますが、他のソフトウェアがそれらの依存関係が常にデフォルトで存在すると想定してはいけません。