平台/基础设施提供者

平台提供者（云环境、应用托管等）和基础设施服务提供者需要支持包安装程序，以便其用户可以安装 Python 依赖项。大多数只支持 pip，但用户对其他 Python 安装程序有需求。大多数提供者不想维护对一个以上安装程序的支持，因为它增加了其软件或服务的复杂性并消耗了大量资源。

通过此规范，我们可以使提供者支持的通用安装程序能够调用用户期望的安装程序后端，而无需提供者的平台具有对该后端的特定知识。这意味着如果 Poetry 实现此 PEP 提出的安装程序后端 API（或某个包装 Poetry 以提供 API 的其他包），那么平台提供者将隐含地支持 Poetry。

IDE提供者

集成开发环境可能会与 Python 包的安装和管理进行交互。大多数只支持 pip 作为 Python 包安装程序，用户需要找到变通方法来使用其他包安装程序安装他们的依赖项。与 PaaS & IaaS 提供者的情况类似，IDE 提供者不想维护对 N 个不同 Python 安装程序的支持。相反，IDE 可以通过充当通用安装程序来调用安装程序接口的实现者（安装程序后端）。

使用 PaaS & IaaS 提供者的开发者

大多数 PaaS 和 IaaS 提供者只支持一个 Python 包安装程序：pip。（一些例外情况包括 Heroku 的 Python buildpack，它支持 pip 和 Pipenv）。这决定了开发者在使用这些提供者时可以使用的安装程序，而这可能不是他们应用程序或工作流程的最佳选择。

采用此 PEP 以成为安装程序后端的安装程序将允许用户使用第三方平台/基础设施，而无需担心他们必须使用哪个 Python 包安装程序，只要提供者使用通用安装程序。

使用 IDE 的开发者

大多数 IDE 只支持 pip 或少数几个 Python 包安装程序。因此，如果开发者使用不受支持的包安装程序，他们必须使用变通方法或 hacky 方法来安装其依赖项。

如果 IDE 使用/提供通用安装程序，它将允许使用开发者想要的任何安装程序后端来安装依赖项，从而使他们不必费力去安装依赖项，以便更紧密地集成到 IDE 的工作流程中。

与其他开发者合作的开发者

开发者希望在与其他开发者合作时使用他们选择的安装程序，但目前不得不同步他们的安装程序选择以兼容依赖项的安装。如果所有首选安装程序都实现了指定接口，那将允许跨安装程序的使用，从而让开发者能够选择一个安装程序，而无需考虑其协作者的偏好。

安装程序要求

由 requires 键指定的依赖项必须在 PEP 517 指定的约束范围内。特别是，不允许依赖循环，并且如果检测到循环，通用安装程序应拒绝安装依赖项。

其他参数或工具特定数据

其他参数或工具（安装程序后端）数据也可以存储在 pyproject.toml 文件中。这将在 PEP 518 指定的“tool.*”表中。例如，如果安装程序后端是 Poetry 并且您想指定多个依赖组，则 tool.poetry 表可以如下所示

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

[tool.poetry.deploy]
dependencies = "deploy"

数据也可以根据安装程序后端的需要以其他方式存储（例如，单独的配置文件）。

invoke_install

安装依赖项

def invoke_install(
    path: Union[str, bytes, PathLike[str]],
    *,
    dependency_group: str = None,
    **kwargs
) -> int:
    ...

• path : 一个绝对路径，安装程序后端应该从中调用（例如，pyproject.toml 所在的目录）。
• dependency_group : 一个可选标志，指定安装程序后端应安装的依赖组。如果依赖组不存在，安装将失败。用户可以通过调用 get_dependency_groups() 来查找所有依赖组，前提是安装程序后端支持依赖组。
• **kwargs : 安装程序后端可能需要但尚未指定的任意参数，允许向后兼容。
• 返回 : 退出代码（int）。成功时为 0，不成功时为任何正整数。

通用安装程序将使用退出代码来确定安装是否成功，并且应自行返回退出代码。

invoke_uninstall

卸载指定的依赖项

def invoke_uninstall(
    path: Union[str, bytes, PathLike[str]],
    *,
    dependency_group: str = None,
    **kwargs
) -> int:
    ...

• path : 一个绝对路径，安装程序后端应该从中调用（例如，pyproject.toml 所在的目录）。
• dependency_group : 一个可选标志，指定安装程序后端应卸载的依赖组。
• **kwargs : 安装程序后端可能需要但尚未指定的任意参数，允许向后兼容。
• 返回 : 退出代码（int）。成功时为 0，不成功时为任何正整数。

通用安装程序必须在通用安装程序自身被调用时所在的同一路径调用安装程序后端。

通用安装程序将使用退出代码来确定卸载是否成功，并且应自行返回退出代码。

get_dependencies_to_install

返回 invoke_install(...) 将要安装的依赖项。这允许包升级者（例如，Dependabot）在不解析依赖文件的情况下检索尝试安装的依赖项。

def get_dependencies_to_install(
    path: Union[str, bytes, PathLike[str]],
    *,
    dependency_group: str = None,
    **kwargs
) -> Sequence[str]:
    ...

• path : 一个绝对路径，安装程序后端应该从中调用（例如，pyproject.toml 所在的目录）。
• dependency_group : 指定一个依赖组，以获取 invoke_install(...) 将为该依赖组安装的依赖项。
• **kwargs : 安装程序后端可能需要但尚未指定的任意参数，允许向后兼容。
• 返回: 要安装的依赖项列表（PEP 508 字符串）。

如果指定了组，安装程序后端必须返回与提供的依赖组对应的依赖项。如果指定的组不存在，或者安装程序后端不支持依赖组，安装程序后端必须引发错误。

如果未指定组，并且安装程序后端提供了默认/未指定组的概念，安装程序后端可以返回默认/未指定组的依赖项，但否则必须引发错误。

get_dependency_groups

返回可安装的依赖组。这允许通用安装程序枚举安装程序后端已知的​​所有依赖组。

def get_dependency_groups(
    path: Union[str, bytes, PathLike[str]],
    **kwargs
) -> AbstractSet[str]:
    ...

• path : 一个绝对路径，安装程序后端应该从中调用（例如，pyproject.toml 所在的目录）。
• **kwargs : 安装程序后端可能需要但尚未指定的任意参数，允许向后兼容。
• 返回: 已知依赖组的集合，以字符串形式表示。空集表示没有依赖组。

update_dependencies

根据输入的包列表输出依赖文件

def update_dependencies(
    path: Union[str, bytes, PathLike[str]],
    dependency_specifiers: Iterable[str],
    *,
    dependency_group=None,
    **kwargs
) -> int:
    ...

• path : 一个绝对路径，安装程序后端应该从中调用（例如，pyproject.toml 所在的目录）。
• dependency_specifiers : 一个可迭代的依赖项，以 PEP 508 字符串形式表示，例如：["requests==2.8.1", ...]。可选地，为特定的依赖组。
• dependency_group : 包列表所属的依赖组。
• **kwargs : 安装程序后端可能需要但尚未指定的任意参数，允许向后兼容。
• 返回 : 退出代码（int）。成功时为 0，不成功时为任何正整数。