ensurepip ---启动 pip 安装程序

3.4 新版功能.

这个 ensurepip 包提供对引导 pip 安装到现有的python安装或虚拟环境中。这种自举方法反映了这样一个事实： pip 是一个独立的项目，有自己的发布周期，最新的稳定版本与cpython参考解释器的维护和特性发布捆绑在一起。

在大多数情况下，python的最终用户不需要直接调用这个模块（如 pip 默认情况下应该是引导的），但如果安装 pip 在安装python（或创建虚拟环境）或显式卸载之后跳过 pip .

注解

这个模块 不 访问互联网。引导所需的所有组件 pip 包含在封装的内部。

参见

安装python模块

安装python包的最终用户指南

PEP 453 ：python安装中PIP的显式引导

本模块的原始原理和规范。

命令行界面

使用解释器的 -m 开关。

最简单的可能调用是：

python -m ensurepip

此调用将安装 pip 如果尚未安装，则不执行任何操作。要确保已安装的版本，请执行以下操作 pip 至少与 ensurepip ，将 --upgrade 选项：：

python -m ensurepip --upgrade

默认情况下， pip 安装到当前虚拟环境（如果其中一个处于活动状态）或系统站点包（如果没有活动虚拟环境）中。安装位置可以通过两个附加的命令行选项进行控制：

  • --root <dir> 安装 pip 相对于给定的根目录，而不是当前活动虚拟环境（如果有）的根目录或当前python安装的默认根目录。

  • --user 安装 pip 进入用户站点包目录，而不是当前python安装的全局目录（在活动虚拟环境中不允许使用此选项）。

默认情况下，脚本 pipX 和 pipX.Y 将安装（其中x.y代表用于调用的python版本 ensurepip ）。安装的脚本可以通过两个附加的命令行选项进行控制：

  • --altinstall ：如果请求备用安装，则 pipX 脚本意志 not 安装。

  • --default-pip ：如果请求“默认PIP”安装，则 pip 除了两个常规脚本外，还将安装脚本。

提供两个脚本选择选项将触发异常。

模块API

ensurepip 显示两个函数以供编程使用：

ensurepip.version()

返回一个字符串，该字符串指定引导环境时将安装的pip的可用版本。

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

靴带 pip 进入当前或指定的环境。

root 指定要相对于安装的备用根目录。如果 root 是 None ，然后安装将使用当前环境的默认安装位置。

升级 指示是否升级早期版本的现有安装 pip 到可用的版本。

user 指示是否使用用户方案而不是全局安装。

默认情况下，脚本 pipX 和 pipX.Y 将安装（其中x.y代表当前版本的python）。

如果 ALT安装 然后设置 pipX 将 not 安装。

如果 default_pip 然后设置 pip 将在两个常规脚本之外安装。

设置两者 ALT安装 和 default_pip 将触发 ValueError .

冗长 将输出级别控制为 sys.stdout 从引导操作。

提出一个 auditing event ensurepip.bootstrap 带着论证 root .

注解

引导过程对两者都有副作用。 sys.path 和 os.environ . 相反，在子进程中调用命令行接口可以避免这些副作用。

注解

引导过程可能会安装 pip ，但其他软件不应假定这些依赖项在默认情况下始终存在（因为在将来的版本中可能会删除这些依赖项） pip ）