python - pypi 依赖项中的 'extra' 是什么？

Question

在 requires_dist来自 pypi 的包的 json 响应的部分，给出:

requires_dist : [
    "bcrypt; extra == 'bcrypt'",
    "argon2-cffi (>=16.1.0); extra == 'argon2'"
]

谁能说清楚每个依赖项的第二个语句， extra == 'bcrypt'和 extra == 'argon2' ?

Answer 1

Extras 是除了常规依赖项之外还可以安装的依赖项，如果您明确要求它们。将它们视为可选功能。

您可以使用 == 后面的名称来安装它们。 , 带有包的名称。例如，如果您安装 somepackage并想添加 bcrypt可选功能，使用:

pip install somepackage[bcrypt]

或者

pip install somepackage[argon2]

或者，要包含两个可选的附加项，请用逗号分隔名称:

pip install somepackage[bcrypt,argon2]

虽然使用 somepackage[...]多次也可用作 pip足够聪明，知道主包已经安装。
pip (或任何其他软件包安装工具)映射 <packagename>[<extras_name>(,...)] 中列出的名称到 requires_dict 中的那些条目使用 <dependency_spec>; extra == '<extras_name>'格式，添加 dependency_spec s 到要安装的东西的列表。

见 Installing Setuptools "Extras"在 Python Packaging User Guide 的安装包部分.

由安装的包本身来检测是否安装了可选额外功能的所有依赖项。一个常见的模式是使用 try...except ImportError:守卫来测试这些额外的依赖项是否可用。