Configure a Poetry environment

Install Poetry

1. Open Terminal (on macOS and Linux) or PowerShell (on Windows) and execute the following command:

   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. On macOS and Windows, the installation script will suggest adding the folder with the poetry executable to the PATH variable. Do that by running the following command:

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

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

   Don't forget to replace jetbrains with your username!

3. To verify the installation, run the following command:

   poetry --version

   You should see something like Poetry (version 1.2.0).

Refer to the Poetry Installation Instructions for more details.

Create a Poetry environment

1. Press Ctrl+Alt+S and go to Project <workspace> | Python Interpreter. Click and select Add.

   

2. In the left-hand pane of the Add Python Interpreter dialog, select Poetry Environment. The following actions depend on whether the virtual environment existed before.

   

   If Poetry Environment is selected:

   • Select the base Python interpreter from the list, or click and find its location in your file system.

   • If DataSpell doesn't detect the poetry executable, specify the following path in the Poetry executable field, replacing jetbrains with your username:

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

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

     /home/jetbrains/.local/bin/poetry

   If Existing environment is selected:

   • Expand the Interpreter list and select any of the existing Poetry environments. Alternatively, click and specify a path to it.

3. Click OK to complete the task.