需求說明符號

pip 使用 需求說明符號 支援從封裝索引安裝。一般而言，需求說明符號由專案名稱後接一組選用的 版本說明符號 所組成。

PEP 508 包含了需求格式的完整規格。

6.0 版新增: 支援環境標記。

19.1 版新增: 支援直接 URL 參考表單。

概述

需求說明符號有兩種格式

• 下列組成的基於名稱的格式

  • 封裝名稱(例如: requests)

  • 選用的一組用於安裝選用依賴項的「額外功能」(例如: security)

  • 選用的封裝版本限制

  • 選用的環境標記

• 下列組成的基於 URL 的格式

  • 封裝名稱(例如: requests)

  • 選用的一組用於安裝選用依賴項的「額外功能」(例如: security)

  • 封裝的 URL

  • 選用的環境標記

範例

幾個基於名稱的範例需求說明符號

SomeProject
SomeProject == 1.3
SomeProject >= 1.2, < 2.0
SomeProject[foo, bar]
SomeProject ~= 1.4.2
SomeProject == 5.4 ; python_version < '3.8'
SomeProject ; sys_platform == 'win32'
requests [security] >= 2.8.1, == 2.8.* ; python_version < "2.7"

注意

使用 >、< 或環境標記時，請在殼層中使用引號標示說明符號。

在需求檔案中不要使用引號。只有一個例外：pip v7.0 和 v7.0.1 (2015 年 5 月) 在需求檔案中使用環境標記時必須在說明符號周圍加上引號。

幾個基於 URL 的範例需求說明符號

pip @ https://github.com/pypa/pip/archive/22.0.2.zip
requests [security] @ https://github.com/psf/requests/archive/refs/heads/main.zip ; python_version >= "3.11"