Poetry 環境を構成する

Poetry をインストールする

1. ターミナル (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 -

2. macOS と Windows では、インストールスクリプトは、詩の実行可能ファイルを含むフォルダーを PATH 変数に追加することを提案します。これを行うには、次のコマンドを実行します。

   export PATH="/Users/jetbrains/.local/bin:$PATH"

   $Env:Path += ";C:\Users\jetbrains\AppData\Roaming\Python\Scripts"; setx PATH "$Env:Path"

   jetbrains をユーザー名に置き換えることを忘れないでください !

3. インストールを確認するには、次のコマンドを実行します。

   poetry --version

   Poetry (version 1.2.0) のようなものが表示されるはずです。

詳細については、Poetry のインストール手順(英語)を参照してください。

Poetry 環境を作成する

1. 以下のいずれか 1 つを実行します:

   • Python インタープリターセレクターをクリックして、新しいインタープリターを追加を選択します。

   • Ctrl+Alt+S を押して設定を開き、プロジェクト: <プロジェクト名> | Python インタープリターに移動します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。

   • Python インタープリターセレクターをクリックしてインタープリターの設定を選択します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。

2. ローカルインタープリターを追加するを選択します。

3. Python インタープリターの追加ダイアログの左側のペインで Poetry 環境を選択します。

   

4. 次のアクションは、新しい Poetry 環境を作成するか、既存の環境を使用するかによって異なります。

   新しい Poetry 環境

   • Poetry 環境を選択します。

   • リストから基本インタープリターを選択するか、 をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

   • プロジェクトに pyproject.toml が含まれている場合は、pyproject.toml からパッケージをインストールするチェックボックスを有効または無効にすることで、プロジェクトにリストされているパッケージをインストールするかどうかを選択できます。デフォルトでは、チェックボックスは有効になっています。

   • PyCharm が詩の実行可能ファイルを検出しない場合は、ダイアログで次のパスを指定し、jetbrains をユーザー名に置き換えます。

     /Users/jetbrains/Library/Application Support/pypoetry/venv/bin/poetry

     C:\Users\jetbrains\AppData\Roaming\pypoetry\venv\Scripts\poetry.exe

     /home/jetbrains/.local/bin/poetry

   既存の Poetry 環境

   • プロジェクトディレクトリに pyproject.toml ファイルが含まれていることを確認します。

   • 既存の環境を選択します。次に、インタープリターリストを展開し、目的のインタープリターを選択します。

   • 目的のインタープリターがリストにない場合は、 をクリックし、以前に構成した Poetry 環境内で Python 実行可能ファイルを参照します。

   選択した Poetry 環境は、現在のプロジェクトで再利用されます。

5. タスクを完了するには、OK をクリックします。

pyproject.toml を使用して Poetry 環境を作成する

1. pyproject.toml を含むプロジェクトを開いたものの、プロジェクトインタープリターが構成されていない場合、PyCharm は Poetry 環境を作成することを提案します。

   

2. PyCharm に Poetry を自動的に構成させたい場合は、pyproject.toml を使用して詩環境をセットアップするをクリックします。または、「Python インタープリターを構成する」をクリックして標準ワークフローに従うこともできます。

3. PyCharm が Poetry 実行可能ファイルを自動検出できない場合は、その実行可能ファイルへのパスを指定して、OK をクリックします。

新しい Poetry 環境がプロジェクト用に構成され、pyproject.toml にリストされているパッケージがインストールされます。