Question

PyPI全称Python Package Index，直译过来就是“Python包索引”，它是Python编程语言的软件仓库，类似Perl的CPAN或Ruby的Gems，目前已经有将近35?000个软件和库（统称为包）提交到上面。既然名字中带有“索引”一词，顾名思义，可以通过包的名字查找、下载、安装PyPI上的包。对于包的作者，在PyPI上注册账号后，还可以登记、更新、上传包等。

注意

PyPI有良好的镜像机制，可以方便地在全球各地架设自有镜像，目前可用的几个镜像列出在PyPI Mirrors页面上，而各个镜像的同步情况可以在专门的网站上看到。因为访问外国网站普遍比较慢，为了方便众多的Python程序员，豆瓣网架设了一个镜像，地址是http://pypi.douban.com，访问速度很快，推荐使用（具体的使用方法见easy_install/pip的--index参数）。

某日，你在邮件列表里看到有人推荐requests，写得非常煽情，让你相当有兴趣想要试一试这个号称“更适合给人用”的HTTP客户端库，那么可以打开你的浏览器，并导航到PyPI，在右上角输入reuqests然后单击搜索按钮，如图7-1所示。

图7-1　PyPI首页

接下来浏览器将会显示搜索结果列表，从中找到名为requests的项目，打开以后页面的上半部分是requests的简要文档，往下拉可以看到它的下载链接，单击后下载保存，然后进入下载目录，执行tar解压缩。

:~# tar zxvf requests-1.2.3.tar.gz 

然后进入requests-1.2.3目录安装。

:~# cd requests-1.2.3
:~/requests-1.2.3# python setup.py install

Python setup.py install命令将把requests库安装到Python的库目录中。

注意

因为包在PyPI上的主页的URL都是https://pypi.python.org/pypi/{package}的形式，所以在知道包名的情况下，熟手一般并不使用搜索功能，而是直接手动输入URL。

显然，手动安装包实在是太麻烦了，查找、下载、解压、安装整个流程完全可以自动化。爱好偷懒的Pythonista自然编写好了工具供大家使用，其中setuptools尤其值得优先推荐给大家。在Ubuntu Linux上，可以使用apt安装这个包。

sudo aptitude install python-setuptools

其他操作系统大同小异，运行其相应的包管理软件就可安装。但如果你使用MS Windows，则需要去它的主页（https://pypi.python.org/pypi/setuptools）下载，然后手动安装。

操作系统对应的软件仓库中的setuptools版本通常比较低，所以安装完成以后，最好执行以下命令将其更新到最新版本：

easy_install -U setuptools

setuptools是来自PEAK（Python Enterprise Application Kit，一个致力于提供Python开发企业级应用工具包的项目），由一组发布工具组成，方便程序员下载、构建、安装、升级和卸载Python包，因为它可以自动处理包的依赖关系，所以深受大家的喜爱。

注意

因为PEAK最近几年发展停滞，累及setuptools也有好几年没有更新。所以有些程序员重新创建了一个分支项目，称为distribute，受到了大家的喜爱。在很长一段时间里，运行easy_install -U setuptools更新的时候，安装的其实是distribute。但是，在2013年年初，distribute合并到setuptools，回归主分支，并发布了setuptools 0.7版本。随后几个月频繁发布大版本，至2013年9月，最新的版本已经是1.1.5版，而distribute项目也就不再维护了。

安装setuptools之后，就可以运行easy_install命令了。

# easy_install requests
Searching for requests
Reading https://pypi.python.org/simple/requests/
Best match: requests 1.2.3
Downloading
https://pypi.python.org/packages/source/r/requests/requests-
  1.2.3.tar.gz#md5=adbd3f18445f7fe5e77f65c502e264fb
Processing requests-1.2.3.tar.gz
Writing /tmp/easy_install-vwjYKV/requests-1.2.3/setup.cfg
Running requests-1.2.3/setup.py -q bdist_egg --dist-dir 
  /tmp/easy_install-vwjYKV/requests-1.2.3/egg-dist-tmp-MeMFX1
Adding requests 1.2.3 to easy-install.pth file
Installed /usr/local/lib/python2.6/dist-packages/requests-1.2.3-py2.6.egg
Processing dependencies for requests
Finished processing dependencies for requests

这就是使用setuptools安装requests的过程，可以从输出中看到easy_install能够查找到最新版本的包，然后进行下载、安装，比手动安装要简单、方便得多。

注意

setuptools的功能非常丰富，包括对Python包的构建、测试、发布等都支持得很好，这些功能将在后续的几节中讲述。