Skip to content

Declaring dependencies#

一時的なインストールで環境を変更するのではなく、静的ファイルで依存関係を宣言することをお勧めします。依存関係を定義したら、それらをロックして、一貫性のある再現可能な環境を作成できます。

Using pyproject.toml#

pyproject.tomlファイルは、プロジェクトの構成を定義するためのPython標準です。

pyproject.tomlファイルでプロジェクトの依存関係を定義するには、次の手順に従います。:

pyproject.toml
[project]
dependencies = [
  "httpx",
  "ruff>=0.3.0"
]

pyproject.tomlファイルにオプションの依存関係を定義するには、次の手順に従います。:

pyproject.toml
[project.optional-dependencies]
cli = [
  "rich",
  "click",
]

それぞれのキーは"extra"を定義しており、--extraおよび--all-extrasフラグまたはpackage[<extra>]構文を使用してインストールできます。詳細については、installing packagesのドキュメントを参照してください。

Using requirements.in#

プロジェクトの依存関係を宣言するために、軽量のrequirements.txtフォーマットを使用することも一般的です。各要件は独自の行で定義されます。一般的に、このファイルはrequirements.inと呼ばれ、ロックされた依存関係に使用されるrequirements.txtと区別されます。

requirements.inファイルで依存関係を定義するには、次の手順に従います。:

requirements.in
httpx
ruff>=0.3.0

オプションの依存関係グループは、この形式ではサポートされていません。