Python之包管理工具

安装Python包的过程中，经常涉及到distutils、setuptools、distribute、setup.py、easy_install、easy_install和pip等等。

distuils

distutils 是 python 标准库的一部分，这个库的目的是为开发者提供一种方便的打包方式，同时为使用者提供方便的安装方式。

经常使用的setup.py就是基于distutils实现的，然后通过setup.py就可以进行打包或者安装了。

[root@node175 webdemo]# ls -a -l

总用量 20

drwxr-xr-x   5 root root  126 1月   5 17:25 .

drwxr-xr-x. 45 root root 4096 1月   5 14:50 ..

drwxr-xr-x   8 root root 4096 1月   5 14:53 .git

-rw-r--r--   1 root root    0 1月   5 14:45 LICENSE

-rw-r--r--   1 root root    0 1月   5 14:45 README.md

-rw-r--r--   1 root root  226 1月   5 14:48 requirement.txt

-rw-r--r--   1 root root  607 1月   5 14:50 setup.cfg

-rw-r--r--   1 root root  355 1月   5 14:47 setup.py

drwxr-xr-x   2 root root   24 1月   5 14:46 webdemo

这个是一个最简单的Python项目目录：

源代码放在子目录Webdemo/下,然后包含了软件包管理的所需的文件：

setup.py
setup.cfg
requirements.txt
LICENSE
README

set.py

    #encoding=utf-8

import setuptools

# In Python < 2.7.4, a lazy loading of package `pbr` will break

# setuptools if some other modules registered functions in `atexit`.

# solution from: http://bugs.Python.org/issue15881#msg170215

try:

    import multiprocessing  # noqa

except ImportError:

    pass

setuptools.setup(

    setup_requires=['pbr'], pbr=True)

setup.cfg

[metadata]

name = webdemo

version = 0.0.1

summary = Web Application Demo

description-file = README.md

author = author

author-email = author@example.com

classifier =

    Environment :: Web Environment

    Intended Audience :: Developers

    Intended Audience :: Education

    License :: OSI Approved :: GNU General Public License v2 (GPLv2)

    Operating System :: POSIX :: Linux

    Programming Language :: Python

    Programming Language :: Python :: 2

    Programming Language :: Python :: 2.7

[global]

setup-hooks =

    pbr.hooks.setup_hook

[files]

packages = webdemo

[entry_points]

console_scripts =

只包含最基本的信息，接下来是requirements.txt文件：

# The order of packages is significant, because pip processes them in the order

# of appearance. Changing the order has an impact on the overall integration

# process, which may cause wedges in the gate later.

pbr<2.0,>=0.11

配合git：

git init

git add .

git commit -m "init project"

git tag -a 0.0.1 -m "version 0.01"

然后就可以使用Python setup.py sdist命令来生成一个0.0.1版本的源码归档了：

python setup.py sdist

查看文件：

[root@node175 webdemo]# tree

.

├── AUTHORS

├── ChangeLog

├── dist

│   └── webdemo-0.0.1.tar.gz   #生成的压缩包

├── LICENSE

├── README.md

├── requirement.txt

├── setup.cfg

├── setup.py

├── webdemo

│   └── __init__.py

└── webdemo.egg-info

    ├── dependency_links.txt

    ├── entry_points.txt

    ├── not-zip-safe

    ├── pbr.json

    ├── PKG-INFO

    ├── SOURCES.txt

    └── top_level.txt

3 directories, 16 files

使用者就可以解压缩这个包然后执行 python setup.py install进行安装，然后就可以使用这个模块了；

setuptools 与 distribute

setuptools 是对 distutils 的增强，尤其是引入了包依赖管理。我们可以通过ez_setup.py来安装setuptools

至于distribute，它是setuptools的一个分支版本。分支的原因是有一部分开发者认为 setuptools 开发太慢。但现在，distribute 又合并回了 setuptools 中，所以可以认为它们是同一个东西。

前面看到setup.py可以创建一个压缩包，而setuptools使用了一种新的文件格式（.egg），可以为Python包创建 egg文件。setuptools 可以识别.egg文件，并解析、安装它；

当安装好setuptools/distribute之后，我们就可以直接使用easy_install这个工具了：

从PyPI上安装一个包：当使用 easy_install package 命令后，easy_install 可以自动从 PyPI 上下载相关的包，并完成安装，升级
下载一个包安装：通过 easy_install package.tgz 命令可以安装一个已经下载的包
安装egg文件：通过 easy_install package.egg 可以安装一个egg格式的文件

setuptools/distribute和easy_install之间的关系：

setuptools/distribute 都扩展了 distutils，提供了更多的功能
easy_install是基于setuptools/distribute的一个工具，方便了包的安装和省级

pip

pip install pkg