pip download 命令用于下载包

语法

pip download 命令的语法格式如下

pip [options] <requirement specifier> [package-index-options] ...

或

pip download [options] -r <requirements file> [package-index-options] ...

或

pip download [options] <vcs project url> ...

或

pip download [options] <local project path> ...

或

pip download [options] <archive url/path> ...

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 <file>

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

• -r, --requirement <file>

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

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

• -b, --build <dir>

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

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

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

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

• --no-deps

  不安装包的任何依赖项

• --global-option <options>

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

• --no-binary <format_control>

  不使用二进制包

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

  可选的值有

  • :all: ：禁用所有二进制包
  • :none: ：清空集合，或者使用逗号之间的一个或多个包名称

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

• --only-binary <format_control>

  不使用源代码包

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

  可选的值有

  • :all: ：禁用所有源代码包
  • :none: ：清空集合，或者使用逗号之间的一个或多个包名称

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

• --src <dir>

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

  在虚拟环境中，默认的目录为 <venv path>/src， 在全局安装中，默认的目录为 <current dir>/src

• --pre

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

• --no-clean

  不要清空构建目录

• --require-hashes

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

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

• --progress-bar <progress_bar>

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

• --no-build-isolation

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

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

• -d, --dest <dir>

  存放已下载的包的目录

• --platform <platform>

  只下载与 <platform> 平台兼容的 wheel

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

• --python-version <python_version>

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

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

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

• --implementation <implementation>

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

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

• --abi <abi>

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

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

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

• -i, --index-url <url>

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

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

• --extra-index-url <url>

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

• --no-index

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

• -f, --find-links <url>

  如果提供的 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