配置 Poetry 环境
Poetry 是一个工具,可帮助基于项目依赖项创建 Python 虚拟环境。 您可以声明项目所依赖的库,Poetry 将为您安装和更新它们。
项目依赖项记录在 pyproject.toml 文件中,该文件指定所需的包、脚本、插件和 URL。 有关其结构和格式的更多信息,请参阅 pyproject 参考。
要在 DataSpell 中使用 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 上,安装脚本会建议将包含 poetry 可执行文件的文件夹添加到 PATH 变量中。 通过运行以下命令来完成此操作:
export PATH="/Users/jetbrains/.local/bin:$PATH"$Env:Path += ";C:\Users\jetbrains\AppData\Roaming\Python\Scripts"; setx PATH "$Env:Path"别忘了将
jetbrains替换为您的用户名!要验证安装,请运行以下命令:
poetry --version您应该会看到类似
Poetry (version 1.2.0)的内容。
有关更多信息,请参阅 Poetry 安装说明。
创建一个 Poetry 环境
请执行以下操作之一:
按下 Ctrl+Alt+S 以打开 设置 并导航到 。
单击 Python Interpreter 选择器 并选择 解释器设置。 单击可用解释器列表旁边的 添加解释器 链接。
在附加目录的上下文菜单中,选择 解释器。
单击 添加解释器 链接,该链接位于可用解释器列表旁边,然后选择 添加本地解释器。
以下操作取决于您是想创建一个新的 Poetry 环境还是使用一个现有的环境。
- 新的 Poetry 环境
从环境类型列表中选择 Poetry。
从列表中选择基础解释器,或者单击
并在您的文件系统中找到 Python 可执行文件。
- 现有 Poetry 环境
确保项目目录包含一个 pyproject.toml 文件。
从列表中选择解释器。
如果列表中没有所需的解释器,请单击
,然后在先前配置的 Poetry 环境中浏览所需的 Python 可执行文件。
所选的 Poetry 环境将用于当前项目。
点击 确定 完成任务。
当您配置一个新的 Poetry 环境时,DataSpell 会根据项目需求创建 pyproject.toml 。
每次您修改 pyproject.toml 文件时,DataSpell 会通知您并提供两个操作选项:将更改记录到 poetry.lock 文件中(poetry lock ),或记录更改并安装未满足的需求(poetry update)。