pip download 命令用于下载包

语法

pip download 命令的语法格式如下

pip [options] [package-index-options] ...

或

pip download [options] -r [package-index-options] ...

或

pip download [options] ...

或

pip download [options] ...

或

pip download [options] ...

pip download 命令可以从以下地址下载包

使用需求说明符从 PiPY 或其它索引上下载

VCS 项目网址

本地项目目录

本地或远程源代码归档

pip 还支持从 「 需求文件 」 ( requirements file ) 下载，这为下载指定的整个环境提供了一种简便方法

简介

pip download 和 pip install 有着相同的解析和下载过程，不同的是，pip install 会安装依赖项，而 pip download 会把所有已下载的依赖项保存到指定的目录 ( 默认是当前目录 )，此目录稍后可以作为值传递给 pip install --find-links 以便离线或锁定下载包安装

如果给 pip download 命令添加选项 --platform、 --python-version、 --implementation 和 --abi 可以用于获取解释器和系统的依赖关系，而不是运行 pip 的解释器和系统的依赖关系，当添加了这些选项时，也必须同时添加 --only-binary=:all: 或 --no-deps

重要的是要注意，上面这些选项都默认为当前系统/解释器，且不是最严格的约束 ( 例如，任何平台，无 abi 等 )。

为了避免获取恰好与当前解释器 ( 但不是你的目标解析器 ) 的约束相匹配的依赖项，如果你指定其中一个，那么建议指定所有这些选项

通用依赖项(例如，通用 wheel ，或没有平台的依赖关系，abi或实现约束 )仍将匹配过度约束的下载要求

选项

-c, --constraint

使用给定的约束文件约束版本，该选项可以重复添加

-r, --requirement

从给定的需求文件中安装，该选项可以重复添加

按照惯例，需求文件名为 requirements.txt

-b, --build

用于存放解压缩的包和构建的包

请注意，初始构建仍发生在临时目录中

可以通过适当地设置 TMPDIR 环境变量 ( Windows上的 TEMP ) 来控制临时目录的位置

注意，如果使用了该参数，当构建发生故障时，并不会清空构建目录

--no-deps

不安装包的任何依赖项

--global-option

在 bdist_wheel 命令之前提供给 setup.py 调用的额外全局选项

--no-binary

不使用二进制包

该选项可以重复添加，每增加一个就会自增当前的值

可选的值有

:all: ：禁用所有二进制包

:none: ：清空集合，或者使用逗号之间的一个或多个包名称

注意，某些软件包编译起来很棘手，并且，即使在添加了此选项后仍然可能无法安装

--only-binary

不使用源代码包

该选项可以重复添加，每增加一个就会自增当前的值

可选的值有

:all: ：禁用所有源代码包

:none: ：清空集合，或者使用逗号之间的一个或多个包名称

注意，没有二进制发行版的软件包在使用此选项时将无法安装

--src

用于存放迁出的可编辑项目

在虚拟环境中，默认的目录为 /src， 在全局安装中，默认的目录为 /src

--pre

包含预发布版本和开发版本，默认只会包行稳定的版本

--no-clean

不要清空构建目录

--require-hashes

对于可重复安装，需要根据哈希值来检查每个需求

如果需求文件中的任何一项包含了 --hash 选项，则隐式包含此选项

--progress-bar

用于指定要显示的进度条类型，可选项有 on、ascii、off、pretty、emoji，默认为 on

--no-build-isolation

在构建现代的源代码分发包是禁用隔离

如果使用了此选项，则必须已安装 PEP518 规定的构建依赖项

-d, --dest

存放已下载的包的目录

--platform

只下载与 平台兼容的 wheel

默认为当前正在运行的系统的平台

--python-version

只下载兼容 Python 解释器版本 的 wheel

如果未指定，默认会使用当前系统解释器的次要版本

可以指定一个主版本号 ( 例如 2 ) 来匹配该主要版本的所有次版本。同时也可以指定次要版本，如 34

--implementation

只下载与 Python 实现 相兼容的 wheel, 例如，pp、jy、 cp 或 ip

如果未指定，那么使用当前解释器实现，可以使用 py 来强制使用与实现无关的 wheel

--abi

只下载与 Python abi 相兼容的 wheel，例如 pypy_41

如果未指定，则使用当前解释器的 abi 标签

通常，在使用该选项时，必须同时指定 --implementation、--platform 和 --python-version

-i, --index-url

Python 包索引的基础 URL 地址，默认为 https://pypi.org/simple

该选项的值应该指向符合 PEP503 ( 简单存储库 API ) 的存储库或以相同格式布局的本地目录

--extra-index-url

除了 --index-url 之外的附加的 Python 包索引 URL，规则和 --index-url 一样

--no-index

忽略包索引，使用 -find-links 指定的 URL

-f, --find-links

如果提供的 URL 或路径链接到一个 html 文件，则会解析该 html 文件以获取归档

如果是本地目录，或 file://url 指向的是一个目录，那么就在该目录中查找归档

--process-dependency-links

启用依赖关系链接的处理

范例

下载一个包及其所有的依赖项

$ pip download SomePackage

$ pip download -d . SomePackage # equivalent to above

$ pip download --no-index --find-links=/tmp/wheelhouse -d /tmp/otherwheelhouse SomePackage

指定使用 OSX 作为解释器的约束，下载包及其所有依赖项

这会强制使用 OSX 10.10 或更低的兼容性。由于 OSX deps 是向前兼容的，这也将匹配 macosx-10_9_x86_64, macosx-10_8_x86_64, macosx-10_8_intel 等等，它还会匹配 deps 与平台 any

还强制解释器版本为 27( 或更通用，即 2 ) 和实现为 cp ( 或更通用，即 py )

$ pip download \

--only-binary=:all: \

--platform macosx-10_10_x86_64 \

--python-version 27 \

--implementation cp \

SomePackage

下载指定的 linux 约束下的包及其依赖项

强制解释器是 py3k 的任何次要版本，并且只接受 abi 为 cp34m或 none 的 requests

$ pip download \

--only-binary=:all: \

--platform linux_x86_64 \

--python-version 3 \

--implementation cp \

--abi cp34m \

requests

$ ls requests*

requests-2.19.1-py2.py3-none-any.whl

强制使用指定的 platform 和 implementation，同时 abi 未知

$ pip download \

--only-binary=:all: \

--platform any \

--python-version 3 \

--implementation py \

--abi none \

requests

$ ls requests*

requests-2.19.1-py2.py3-none-any.whl

即使是过度约束，仍然可以正确的获取 pip 通用的 wheel

$ pip download \

--only-binary=:all: \

--platform linux_x86_64 \

--python-version 33 \

--implementation cp \

--abi cp34m \

pip > 10

$ ls pip-10.0.1-py2.py3-none-any.whl

pip-10.0.1-py2.py3-none-any.whl