要件指定子

pipは、要件指定子を使用してパッケージインデックスからインストールすることをサポートしています。一般的に、要件指定子は、プロジェクト名に続いて、オプションのバージョン指定子で構成されます。

PEP 508には、要件の形式の完全な仕様が含まれています。

バージョン 6.0 で追加: 環境マーカーのサポート。

バージョン 19.1 で追加: ダイレクトURL参照形式のサポート。

概要

要件指定子には、次の2つの形式があります。

• 名前ベース：以下で構成されます。

  • パッケージ名（例：requests）

  • オプションで、オプションの依存関係をインストールするための「extras」（例：security）

  • オプションで、パッケージのバージョンに適用する制約

  • オプションで、環境マーカー

• URLベース：以下で構成されます。

  • パッケージ名（例：requests）

  • オプションで、オプションの依存関係をインストールするための「extras」（例：security）

  • パッケージのURL

  • オプションで、環境マーカー

例

名前ベースの要件指定子のいくつかの例

SomeProject
SomeProject == 1.3
SomeProject >= 1.2, < 2.0
SomeProject[foo, bar]
SomeProject ~= 1.4.2
SomeProject == 5.4 ; python_version < '3.8'
SomeProject ; sys_platform == 'win32'
requests [security] >= 2.8.1, == 2.8.* ; python_version < "2.7"

注

>、<を使用する場合、または環境マーカーを使用する場合は、シェルで指定子を引用符で囲んでください。

要件ファイルでは引用符を使用しないでください。例外が1つあります。pip v7.0およびv7.0.1（2015年5月）では、要件ファイルで環境マーカーを含む指定子を引用符で囲む必要がありました。

URLベースの要件指定子のいくつかの例

pip @ https://github.com/pypa/pip/archive/22.0.2.zip
requests [security] @ https://github.com/psf/requests/archive/refs/heads/main.zip ; python_version >= "3.11"