ensurepip --- Khởi động trình cài đặt pip

Added in version 3.4.

Source code: Lib/ensurepip

Gói ensurepip cung cấp hỗ trợ khởi động trình cài đặt pip vào bản cài đặt Python hoặc môi trường ảo hiện có. Cách tiếp cận khởi động này phản ánh thực tế rằng pip là một dự án độc lập có chu kỳ phát hành riêng và phiên bản ổn định mới nhất hiện có đi kèm với các bản phát hành tính năng và bảo trì của trình thông dịch tham chiếu CPython.

Trong hầu hết các trường hợp, người dùng cuối của Python không cần phải gọi trực tiếp mô-đun này (vì pip phải được khởi động theo mặc định), nhưng có thể cần nếu cài đặt pip bị bỏ qua khi cài đặt Python (hoặc khi tạo môi trường ảo) hoặc sau khi gỡ cài đặt pip một cách rõ ràng.

Ghi chú

Mô-đun này does not truy cập internet. Tất cả các thành phần cần thiết để khởi động pip đều được bao gồm dưới dạng các phần bên trong của gói.

Đây là một optional module. Nếu nó bị thiếu trong bản sao CPython của bạn, hãy tìm tài liệu từ nhà phân phối của bạn (nghĩa là bất kỳ ai đã cung cấp Python cho bạn). Nếu bạn là nhà phân phối, hãy xem Yêu cầu đối với các mô-đun tùy chọn.

Xem thêm

Cài đặt mô-đun Python

Hướng dẫn người dùng cuối cài đặt gói Python

PEP 453: Khởi động rõ ràng pip trong cài đặt Python

Cơ sở lý luận và đặc điểm kỹ thuật ban đầu cho mô-đun này.

sẵn có: not Android, not iOS, not WASI.

Mô-đun này không được hỗ trợ trên mobile platforms hoặc WebAssembly platforms.

Giao diện dòng lệnh

Giao diện dòng lệnh được gọi bằng cách sử dụng khóa chuyển -m của trình thông dịch.

Cách gọi đơn giản nhất có thể là:

python -m đảm bảopip

Lệnh gọi này sẽ cài đặt pip nếu nó chưa được cài đặt, nhưng nếu không thì sẽ không cài đặt gì. Để đảm bảo phiên bản đã cài đặt của pip ít nhất là phiên bản mới nhất có sẵn trong ensurepip, hãy chuyển tùy chọn --upgrade:

python -m đảm bảopip -- nâng cấp

Theo mặc định, pip được cài đặt vào môi trường ảo hiện tại (nếu một môi trường đang hoạt động) hoặc vào các gói trang web hệ thống (nếu không có môi trường ảo đang hoạt động). Vị trí cài đặt có thể được kiểm soát thông qua hai tùy chọn dòng lệnh bổ sung:

--root <dir>

Cài đặt pip liên quan đến thư mục gốc đã cho thay vì thư mục gốc của môi trường ảo hiện đang hoạt động (nếu có) hoặc thư mục gốc mặc định cho cài đặt Python hiện tại.

--user

Cài đặt pip vào thư mục gói trang web của người dùng thay vì trên toàn cầu đối với cài đặt Python hiện tại (tùy chọn này không được phép trong môi trường ảo đang hoạt động).

Theo mặc định, các tập lệnh pipX và pipX.Y sẽ được cài đặt (trong đó X.Y là viết tắt của phiên bản Python được sử dụng để gọi ensurepip). Các tập lệnh được cài đặt có thể được kiểm soát thông qua hai tùy chọn dòng lệnh bổ sung:

--altinstall

Nếu yêu cầu cài đặt thay thế, tập lệnh pipX sẽ được cài đặt.

--default-pip

Nếu yêu cầu cài đặt "pip mặc định", tập lệnh pip sẽ được cài đặt cùng với hai tập lệnh thông thường.

Việc cung cấp cả hai tùy chọn lựa chọn tập lệnh sẽ gây ra ngoại lệ.

Mô-đun API

ensurepip hiển thị hai chức năng để sử dụng theo chương trình:

ensurepip.version()

Trả về một chuỗi chỉ định phiên bản có sẵn của pip sẽ được cài đặt khi khởi động một môi trường.

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

Khởi động pip vào môi trường hiện tại hoặc được chỉ định.

root chỉ định một thư mục gốc thay thế để cài đặt. Nếu root là None thì quá trình cài đặt sẽ sử dụng vị trí cài đặt mặc định cho môi trường hiện tại.

upgrade cho biết có nên nâng cấp bản cài đặt hiện có của phiên bản cũ hơn của pip lên phiên bản có sẵn hay không.

user cho biết có nên sử dụng lược đồ người dùng thay vì cài đặt trên toàn cầu hay không.

Theo mặc định, các tập lệnh pipX và pipX.Y sẽ được cài đặt (trong đó X.Y là viết tắt của phiên bản Python hiện tại).

Nếu altinstall được đặt thì pipX sẽ được cài đặt not.

Nếu default_pip được đặt thì pip sẽ được cài đặt cùng với hai tập lệnh thông thường.

Đặt cả altinstall và default_pip sẽ kích hoạt ValueError.

verbosity kiểm soát mức đầu ra thành sys.stdout từ hoạt động khởi động.

Tăng một auditing event ensurepip.bootstrap với đối số root.

Ghi chú

Quá trình khởi động có tác dụng phụ trên cả sys.path và os.environ. Thay vào đó, việc gọi giao diện dòng lệnh trong một quy trình con cho phép tránh được những tác dụng phụ này.

Ghi chú

Quá trình khởi động có thể cài đặt các mô-đun bổ sung mà pip yêu cầu, nhưng phần mềm khác không nên cho rằng các phần phụ thuộc đó sẽ luôn xuất hiện theo mặc định (vì các phần phụ thuộc có thể bị xóa trong phiên bản tương lai của pip).