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