ensurepip —- 引導 pip 安裝器

3.4 新版功能.

創(chuàng)新互聯(lián)是網(wǎng)站建設專家,致力于互聯(lián)網(wǎng)品牌建設與網(wǎng)絡營銷，專業(yè)領域包括成都做網(wǎng)站、網(wǎng)站建設、電商網(wǎng)站制作開發(fā)、小程序開發(fā)、微信營銷、系統(tǒng)平臺開發(fā)，與其他網(wǎng)站設計及系統(tǒng)開發(fā)公司不同，我們的整合解決方案結合了恒基網(wǎng)絡品牌建設經(jīng)驗和互聯(lián)網(wǎng)整合營銷的理念，并將策略和執(zhí)行緊密結合，且不斷評估并優(yōu)化我們的方案，為客戶提供全方位的互聯(lián)網(wǎng)品牌整合方案！

---

ensurepip 包為在已有的python安裝實例或虛擬環(huán)境中引導 pip 安裝器提供了支持。需要使用引導才能使用pip的這一事實也正好反映了 pip 是一個獨立的項目，有其自己的發(fā)布周期，其最新版本隨CPython解釋器的維護版本和新特性版本一同捆綁。

在大多數(shù)情況下，Python的終端使用者不需要直接調(diào)用這個模塊（ pip 默認應該已被引導），不過，如果在安裝Python（或創(chuàng)建虛擬環(huán)境）之時跳過了安裝 pip 步驟，或者日后特意卸載了 pip ，則需要使用這個模塊。

備注

這個模塊 無需 訪問互聯(lián)網(wǎng)。引導啟動 pip 所需的全部組件均包含在包的內(nèi)部。

參見

安裝 Python 模塊

安裝Python包的終端使用者教程

PEP 453: 在Python安裝實例中顯式引導啟動pip

這個模塊的原始緣由以及規(guī)范文檔

Availability: not Emscripten, not WASI.

This module does not work or is not available on WebAssembly platforms wasm32-emscripten and wasm32-wasi. See WebAssembly platforms for more information.

命令行界面

使用解釋器的 -m 參數(shù)調(diào)用命令行接口。

最簡單的調(diào)用方式為：

 
 
 
 

  
  
  
  
python -m ensurepip
 
 
 
 

該調(diào)用會在當前未安裝 pip 的情況下安裝 pip ，如已安裝則無事發(fā)生。如要確保安裝的 pip 版本至少為 ensurepip 所支援的最新版本，傳入 --upgrade 參數(shù)：

 
 
 
 

  
  
  
  
python -m ensurepip --upgrade
 
 
 
 

在默認情況下，pip 會被安裝到當前虛擬環(huán)境（如果激活了虛擬環(huán)境）或系統(tǒng)的包目錄（如果未激活虛擬環(huán)境）。 安裝位置可通過兩個額外的命令行選項來控制:

• --root 1: 相對于給定的根目錄而不是當前已激活虛擬環(huán)境（如果存在）的根目錄或當前 Python 安裝版的默認根目錄來安裝 pip。

• --user: 將 pip 安裝到用戶包目錄而不是全局安裝到當前 Python 安裝版（此選項不允許在已激活虛擬環(huán)境中使用）。

在默認情況下，腳本 pipX 和 pipX.Y 將被安裝（其中 X.Y 表示被用來發(fā)起調(diào)用 ensurepip 的 Python 的版本）。 所安裝的腳本可通過兩個額外的命令行選項來控制:

• --altinstall: 如果請求了一個替代安裝版，則 pipX 腳本將 不會 被安裝。

• --default-pip: 如果請求了一個 “默認的 pip” 安裝版，則除了兩個常規(guī)腳本之外還將安裝 pip 腳本。

同時提供這兩個腳本選擇選項將會觸發(fā)異常。

模塊 API

ensurepip 暴露了兩個函數(shù)用于編程:

ensurepip.version()

返回一個指明在初始創(chuàng)建環(huán)境時將被安裝的可用 pip 版本的字符串。

ensurepip.bootstrap(root=None, upgrade=False, user=False, altinstall=False, default_pip=False, verbosity=0)

初始創(chuàng)建 pip 到當前的或指定的環(huán)境中。

root 指明要作為相對安裝路徑的替代根目錄。 如果 root 為 None，則安裝會使用當前環(huán)境的默認安裝位置。

upgrade 指明是否要將一個現(xiàn)有的較早版本的 pip 的安裝版升級到可用的新版本。

user 指明是否使用針對用戶的安裝方案而不是全局安裝。

在默認情況下，將會安裝 pipX 和 pipX.Y 腳本（其中 X.Y 表示 Python 的當前版本）。

如果設置了 altinstall，則 pipX 將 不會 被安裝。

如果設置了 default_pip，則除了兩個常規(guī)腳本外還將安裝 pip。

同時設置 altinstall 和 default_pip 將觸發(fā) ValueError。

verbosity 控制初始創(chuàng)建操作對 sys.stdout 的輸出信息級別。

引發(fā)一個 審計事件 ensurepip.bootstrap 附帶參數(shù) root。

備注

創(chuàng)建創(chuàng)建過程對于 sys.path 和 os.environ 都會有附帶影響。 改為在子進程中發(fā)起調(diào)用命令行接口可以避免這些附帶影響。

備注

初始創(chuàng)建過程可能會安裝 pip 所需的額外模塊，但其他軟件不應假定這些依賴將總是會默認存在（因為這些依賴可能會在未來的 pip 版本中被移除）。

分享標題：創(chuàng)新互聯(lián)Python教程：ensurepip—-引導pip安裝器
文章起源：http://uogjgqi.cn/article/dhpjhoo.html