ICode9

精准搜索请尝试: 精确搜索
首页 > 编程语言> 文章详细

python pip download_Python Pip 参考手册 - pip download 命令

2021-09-10 15:59:57  阅读:229  来源: 互联网

标签:选项 解释器 参考手册 -- abi pip download


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

标签:选项,解释器,参考手册,--,abi,pip,download
来源: https://blog.csdn.net/javastart/article/details/120223832

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有