Poetry 環境を構成する
Poetry(英語) は、プロジェクトの依存関係に基づいて Python 仮想環境を簡単に作成できるツールです。 プロジェクトが依存するライブラリを宣言でき、Poetry がインストールして更新します。
プロジェクトの依存関係は、必要なパッケージ、スクリプト、プラグイン、URL を指定する pyproject.toml ファイルに記録されます。 ファイルの構造と形式の詳細については、 pyproject(英語) リファレンスを参照してください。
PyCharm で Poetry を使用するには、 マシンにインストールして 、特定の Python 環境を作成する必要があります。
Poetry をインストールする
ターミナル (macOS および Linux の場合) または PowerShell (Windows の場合) を開き、次のコマンドを実行します。
curl -sSL https://install.python-poetry.org | python3 -(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -curl -sSL https://install.python-poetry.org | python3 -macOS と Windows では、インストールスクリプトは、詩の実行可能ファイルを含むフォルダーを PATH 変数に追加することを提案します。 これを行うには、次のコマンドを実行します。
export PATH="/Users/jetbrains/.local/bin:$PATH"$Env:Path += ";C:\Users\jetbrains\AppData\Roaming\Python\Scripts"; setx PATH "$Env:Path"jetbrainsをご自分のユーザー名に置き換えてください！インストールを確認するには、次のコマンドを実行します。
poetry --versionPoetry (version 1.2.0)のようなものが表示されるはずです。
詳細については、 Poetry のインストール手順(英語)を参照してください。
Poetry 環境を作成する
次のいずれかを実行します：
Python インタープリターセレクターをクリックして 新しいインタープリターを追加 を選択します。
Ctrl+Alt+S を押して 設定 を開き、 に移動します。
Python インタープリターセレクターをクリックして インタープリターの設定 を選択します。 利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックします。
利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックし、 ローカルインタープリターを追加する を選択します。
次のアクションは、新しい Poetry 環境を作成するか既存のものを使用するかによって異なります。
- 新しい Poetry 環境
環境タイプのリストから Poetry を選択します。
リストから基本インタープリターを選択するか、
をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。PyCharm は Poetry のインストールを検出します。
PyCharm が Poetry のインストールを検出しない場合は、 pip 経由で Poetry をインストール をクリックして、PyCharm が Poetry を自動的にインストールできるようにします。
または、Poetry 実行可能ファイルの場所を指定するか、
をクリックして参照します。
- 既存の Poetry 環境
環境タイプのリストから Poetry を選択します。
PyCharm は Poetry のインストールを検出します。
PyCharm がインストールを自動的に検出しなかった場合は、実行可能ファイルの場所を指定するか、
をクリックして参照します。リストから環境を選択します。
選択した Poetry 環境は、現在のプロジェクトで再利用されます。
タスクを完了するには、 OK をクリックしてください。
新しい Python プロジェクトを作成するときに Poetry 環境を選択すると、PyCharm はプロジェクト要件を備えた pyproject.toml を作成します。
pyproject.toml ファイルを変更すると、PyCharm は通知し、 poetry.lock ファイルに変更を記録する（詩のロック ）、または変更を記録して満たされていない要件をインストールする（詩の更新 ）というアクションを提案します。
pyproject.toml を使用して Poetry 環境を作成する
pyproject.toml を含むプロジェクトを開いたが、プロジェクトインタープリターが構成されていない場合、PyCharm は Poetry 環境を設定することを提案します。
PyCharm は Poetry 実行可能ファイルへのパスを表示します。 OK をクリックしてパスを確認します。
PyCharm が Poetry 実行可能ファイルを自動検出できない場合は、そのパスを手動で指定します。
新しい Poetry 環境がプロジェクト用に構成され、 pyproject.toml にリストされているパッケージがインストールされます。
Poetry monorepo support
PyCharm supports Poetry monorepo setups with path dependencies. When the Workspace mode is enabled, PyCharm detects subprojects by looking for pyproject.toml files in subdirectories.
Once a .py or pyproject.toml file is opened in a subproject, PyCharm checks whether an environment for this project already exists on the system. If it does, the environment is automatically configured as the SDK. If not, a file-level notification suggests creating a new Poetry environment and installing dependencies for this subproject.
詳細については、 Workspaces and monorepos を参照してください。