pip 18.1官方文档

想了解pip的工作原理，无奈没找想要的内容，所以打算翻译一下pip官方文档的User Guide部分。
我使用的mac OSX系统，一些linux或者mac os的上的操作，我会用本地操作代替。

---

User Guide

目录如下：

image.png

Running pip

pip是一个命令行程序。当你安装了pip过后，pip就会被添加到你的系统中，就可以在命令提示符后使用pip了。

本地运行pip命令

如果你不能直接运行pip命令(很可能是因为pip没有被安装在系统的环境变量PATH中)，然后你可以通过python解释器运行pip命令。

image.png

在Windows系统中，可以使用py启动器

image.png

尽管pip可以从你的python安装中作为一个模块导入(通过import pip)，但是不支持这样使用pip，了解更多关于程序中使用pip请看Using pip from your program。

Install Packages

pip支持从PyPI、版本控制、本地项目或者分发式文件(distribution files)中安装。
最常见的场景就是，使用Requirement Specifiers从PyPI中安装。

$ pip install SomePackage            # latest version
$ pip install SomePackage==1.0.4     # specific version
$ pip install 'SomePackage>=1.0.4'     # minimum version

更多信息和案例，请参考pip install。

使用代理服务器(Using a Proxy Server)

当从PyPI安装包时，pip需要访问网络，在很多公司的网络环境中需要一个HTTP代理服务器。
pip可以使用多种配置方式通过一个代理服务器连接网路：

• 命令行使用--proxy选项，用来指定一个代理服务，[user:passwd@]proxy.server:port
• 在配置文件( Config file
  )中使用proxy。
• 通过设置标准的环境变量http_proxy, https_proxy和no_proxy。

Requirement Files

"Requirement Files"是包含了要被安装的包的一个列表，使用pip安装就像这样：

image.png

文件内容的格式细节可以参考：Requirements File Format

理论上来讲，一个"Requirement File"就是一个使用pip安装参数的列表文件。注意，你不应该以任何特定顺序依赖pip安装的文件中的项目。

实际上，"Requirement Files"有4中常用方式：

1. "Requirement Files"用来保存pip freeze命令的结果，pip freeze的目的是用来实现重复安装。这样一来，你的"Requirement File"包含了一些列固定版本的，由pip freeze运行产生的结果的依赖包列表。

   
   
   

   image.png

2. "Requirement Files"用来强制解决包的依赖关系。想现在这样，pip并没有一个正确的依赖方案，只不过是使用第一个规格参数(比如aiohttp==3.4.4)来为项目寻找包。例如，如果pkg1需要pkg3>=1.0并且pkg2需要pkg3>=1.0，<=2.0，如果只有pkg1被解析，那么将只会用pkg3>=1.0，但是很容易安装一个和pkg依赖相冲突的版本。为了解决这个问题，你可以直接把 pkg3>=1.0,<=2.0 放入你的requirement file中，就像这样：

pkg1
pkg2
pkg3>=1.0,<=2.0

3. Requirements files强制pip安装按一个对所有子依赖项可用的版本。例如，为了支持ProjectA，在你的Requirements files需要ProjectB，但是最新的班本有bug，你可以强制pip使用更早的版本。

ProjectA
ProjectB<1.3

4. Requirements files用来覆盖与版本控制中的本地补丁程序的依赖关系。例如，假定有一个依赖，PyPI中的一些依赖有bug，而你又不能等待上游更新。你可以复制源文件，然后修复，在VCS中标记一个tag。你可以在需求文件中使用类似的行引用它。

   
   
   

   image.png

如果SomeDependency以前是需求文件中的顶级要求，则将该行替换为新行。 如果SomeDependency是子依赖项，则添加新行。

重要的是要明确pip使用install_requires元数据确定包依赖关系，而不是通过发现项目中嵌入的requirements.txt文件。

参考：

• • Requirements File Format
• • pip freeze
• • “setup.py vs requirements.txt” (an article by Donald Stufft)