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
  1. Requirements files强制pip安装按一个对所有子依赖项可用的版本。例如,为了支持ProjectA,在你的Requirements files需要ProjectB,但是最新的班本有bug,你可以强制pip使用更早的版本。
ProjectA
ProjectB<1.3
  1. Requirements files用来覆盖与版本控制中的本地补丁程序的依赖关系。例如,假定有一个依赖,PyPI中的一些依赖有bug,而你又不能等待上游更新。你可以复制源文件,然后修复,在VCS中标记一个tag。你可以在需求文件中使用类似的行引用它。


    image.png

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

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

参考:

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,384评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,845评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,148评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,640评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,731评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,712评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,703评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,473评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,915评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,227评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,384评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,063评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,706评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,302评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,531评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,321评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,248评论 2 352

推荐阅读更多精彩内容