平臺/基礎設施提供者

平臺提供者（雲環境、應用託管等）和基礎設施服務提供者需要支援包安裝程式，以便其使用者可以安裝 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，不成功時為任何正整數。