Python 诗歌 - 如何安装可选依赖项？

Question

Python 的诗歌依赖管理器允许通过命令指定可选依赖：

$ poetry add --optional redis

这导致了这种配置：

[tool.poetry.dependencies]
python = "^3.8"
redis = {version="^3.4.1", optional=true}

但是，您如何实际安装它们？文档似乎暗示：

$ poetry install -E redis

但这只是抛出错误：

Installing dependencies from lock file

[ValueError]
Extra [redis] is not specified.

Answer 1

如果您想在安装过程中使用-E 标志，您需要将tool.poetry.extras 组添加到您的pyproject.toml，如文档的this section 中所述：

[tool.poetry.extras]
caching = ["redis"]

---

键是指与poetry install -E 一起使用的词，值是添加时标记为--optional 的包的列表。目前有no support 用于在添加可选包时将其作为特定组的一部分，因此您必须在pyproject.toml 文件中手动维护此部分。

这一额外抽象层背后的原因是额外安装通常是指通过安装一个或多个依赖项启用的一些可选功能（在本例中为 caching）（在本例中为 redis） . poetry 只是在此处模仿 setuptools' definition of extra-installs，这或许可以解释为什么它的文档记录如此之少。

Answer 2

我要补充的是，不仅你必须手动添加这个 extras 部分，而且你的可选依赖项不能在 dev 部分中。

不起作用的代码示例：

[tool.poetry]
name = "yolo"
version = "1.0.0"
description = ""
authors = []

[tool.poetry.dependencies]
python = "2.7"
Django = "*"

[tool.poetry.dev-dependencies]
pytest = "*"
ipdb = {version = "*", optional = true}

[tool.poetry.extras]
dev_tools = ["ipdb"]

但这会工作：

[tool.poetry]
name = "yolo"
version = "1.0.0"
description = ""
authors = []

[tool.poetry.dependencies]
python = "2.7"
Django = "*"
ipdb = {version = "*", optional = true}

[tool.poetry.dev-dependencies]
pytest = "*"

[tool.poetry.extras]
dev_tools = ["ipdb"]