分类： Python/Ruby
2013-05-22 23:37:57
一 setuptools 和easy_install
setuptools:setuptools 是一组由PEAK(Python Enterprise Application Kit)开发的 Python 的 distutils 工具的增强工具，可以让程序员更方便的创建和发布 Python的egg 包，特别是那些对其它包具有依赖性的状况。 由 setuptools 创建和发布的包看起来和基于 distutils 发布的包没什么不同。最终用户不需要事先安装 setuptools 甚至根本不需要知道 setuptools 的存在，而程序员也不需要附上完整的 setuptools，只需要包含一个大小约 8K 的ez_setup.py脚本作为启动模块，就可以在最终用户没有安装适当版本的 setuptools 时让这些包自动下载和安装 setuptools。
easy_install: 常使用python的人员，当需要安装第三方python包时，可能会用到easy_install命令。easy_install是由 PEAK(Python Enterprise Application Kit)开发的setuptools包里带的一个命令，它用来自动地从来安装egg包，相当于perl中的cpan或PPM。
二 windows上安装setuptool
方法1: exe安装文件 从这里下载： 安装文件
如果以前曾经安装旧版的setuptools，则在安装之前需要将系统中的site-packages目录（以及任何其他sys.path目录）下的所有setuptools*.egg和setuptools.pth文件删除。
如果之前也是使用.exe安装程序安装的setuptools，则安装前要在“添加/删除程序”中卸载旧的版本。
安装完毕后，在Python的Scripts子目录下就会出现easy_install.exe程序。 确保将这个目录（例如 C:\Python26\Scripts）加入 PATH 环境变量。
方法2: 手工安装
卸载旧版的方法同 1 相同。
下载ez_setup.py脚本， 然后在命令行运行： python ez_setup.py
三 Linux上的setuptool的安装
Debian/Ubuntu下可以直接使用apt安装：:
$ sudo apt-get install python-setuptools
手工安装的话，有两种方式：
$ wget $ sudo python ez_setup.py
更新setuptools：:
$ sudo python ez_setup.py -U setuptools
$ wget $ sudo sh setuptools-0.6c11-py2.6.egg
四 easy_install的使用
1) 使用easy_install来自动安装egg包
比如说要安装Python的MYSQL支持，可以执行如下命令，系统会自动在pypi网站列表里查找相关软件包：easy_install MySQL-python。
通过easy_install安装软件，相关安装信息会保存到easy-install.pth文件里，路径类似如下形式：C:\Python25\Lib\site-packages\easy-install.pth。
如果想删除通过easy_install安装的软件包，比如说：MySQL-python，可以执行命令：easy_install -m MySQL-python。
2）将egg安装包下载到本地安装
进入到安装包的目录，执行python setup.py install
3）如果easy_install安装某模块有错的话，则可以自己到下载，然后使用python setup.py install来安装。
有的时候easy_install并不能够很好地自动安装，比如我安装ldap：easy_install.exe python-ldap， easy_install应该到下下载，但是easy_install却找到了python-ldap 2.3.12，最总导致安装有错。（不知道是不是因为pypi上没有64bit的egg，我的系统是64bit的，但是我的python是32bit的啊）
五 egg的制作
egg包是目前最流行的python应用打包部署方式。如何制作和安装egg包？下面我就简单的分析了一下。
总是安装别人的egg包，是不是也想制作自己的egg包呢？好，接下来我们就自己制作一个简单的egg包。
首先建立工程目录egg-demo,初始化一个setup.py文件：
$ mkdir egg-demo $ cd egg-demo $ touch setup.py $ ls setup.py
下面主要就是填充setup.py。setup.py其实是python工具包distutils的配置文件，setuptools就是基于 distutils来做的。 在setup.py中通过setup函数来配置打包信息。首先要引入setuptools的函数setup。setuptools的setup其实就是 distutils的setup函数，填写setup.py为以下内容：
$ cat setup.py #!/usr/bin/env python #-*- coding:utf-8 -*- from setuptools import setup setup()
写到这里，一个空的egg配置文件就写好了。我们可以使用下面命令生成egg包：
$ python setup.py bdist_egg
下面看看究竟生成了什么：
$ ls -F build/ dist/ setup.py UNKNOWN.egg-info/
可以看到多了三个文件夹。而在dist文件夹下，有一个egg文件：UNKNOWN-0.0.0-py2.6.egg。
产蛋成功！先看看这个egg文件是什么格式的：
$ file dist/UNKNOWN-0.0.0-py2.6.egg dist/UNKNOWN-0.0.0-py2.6.egg: Zip archive data, at least v2.0 to extract
噢，原来就是一个zip压缩包呀！好，再来看看内部构造：
$ unzip -l dist/UNKNOWN-0.0.0-py2.6.egg
Archive: dist/KNOWN-0.0.0-py2.6.egg
Length Date Time Name
--------- ---------- ----- ----
120 2010-12-06 17:04 EGG-INFO/SOURCES.txt
1 2010-12-06 17:04 EGG-INFO/top_level.txt
1 2010-12-06 17:04 EGG-INFO/zip-safe
1 2010-12-06 17:04 EGG-INFO/dependency_links.txt
227 2010-12-06 17:04 EGG-INFO/PKG-INFO
--------- -------
350 5 files
只有一个EGG-INFO文件夹，内含五个egg信息文件，没了。
这个egg名称未知，版本0.0.0。这是因为我们在setup里什么也没有设置。
显然，这个egg什么也不能做。
下面给它加点料。
在setup.py中，setup函数接收一系列属性作为配置参数。
还有一些描述性的属性，如description，long_description，author，author_email，license，keywords，platform，url等。
填充setup.py文件如下：:
$ cat setup.py
#!/usr/bin/env python
#-*- coding:utf-8 -*-
from setuptools import setup, find_packages
setup(
name = "demo",
version="0.1.0",
packages = find_packages(),
zip_safe = False,
description = "egg test demo.",
long_description = "egg test demo, haha.",
author = "amoblin",
author_email = "amoblin@ossxp.com",
license = "GPL",
keywords = ("test", "egg"),
platforms = "Independant",
url = "",
)
在egg-demo目录下建立和上述name名称相同的目录demo，demo目录下写__init__.py文件：
$ mkdir demo
$ cat demo/__init__.py
#!/usr/bin/env python
#-*- coding:utf-8 -*-
def test():
print "Hello, I'm amoblin."
if __name__ == '__main__':
test()
再次生成egg包以后查看egg包信息：
$ python setup.py bdist_egg
$ unzip -l dist/demo-0.1.0-py2.6.egg
Archive: dist/demo-0.1.0-py2.6.egg
Length Date Time Name
--------- ---------- ----- ----
121 2010-12-06 17:30 demo/__init__.py
344 2010-12-06 17:46 demo/__init__.pyc
137 2010-12-06 17:46 EGG-INFO/SOURCES.txt
5 2010-12-06 17:46 EGG-INFO/top_level.txt
1 2010-12-06 17:46 EGG-INFO/zip-safe
1 2010-12-06 17:46 EGG-INFO/dependency_links.txt
227 2010-12-06 17:46 EGG-INFO/PKG-INFO
--------- -------
836 7 files
可以看到，多了一个文件夹demo，里面有我们写的__init__.py。
奉行敏捷原则，先安装了体验一下再说：
$ sudo python setup.py install running install install_dir /usr/local/lib/python2.6/dist-packages/ ... creating /usr/local/lib/python2.6/dist-packages/demo-0.1.0-py2.6.egg Extracting demo-0.1.0-py2.6.egg to /usr/local/lib/python2.6/dist-packages demo 0.1.0 is already the active version in easy-install.pth Installed /usr/local/lib/python2.6/dist-packages/demo-0.1.0-py2.6.egg Processing dependencies for demo==0.1.0 Finished processing dependencies for demo==0.1.0
OK!安装完毕！接下来我们就可以直接通过import来使用啦！
$ python -c "from demo import test;test()" Hello, I'm amoblin.
成功输出！这说明安装正确。我们的一个egg包诞生了。
一般情况下，我们的源程序都放在src目录下，所以接下来将demo文件夹移动到src里。但这样也要修改setup.py文件，修改find_packages函数中参数为’src’，同时增加package_dir参数：
packages=find_packages('src'),
package_dir = {'':'src'}
这样告诉setuptools在src目录下找包，而不是原来默认的工程根目录。
最后我们来手动的卸载以下刚才安装的egg文件，以python2.6版本为例，egg文件一般安装在/usr/local/lib /python2.6/dist-packages/目录下，该目录下还有一个easy-install.pth文件，用于存放安装的egg信息。:
$ cd /usr/local/lib/python2.6/dist-packages $ cat easy-install.pth|grep demo ./demo-0.1.0-py2.6.egg $ ls -F|grep demo demo-0.1.0-py2.6.egg/
卸载egg文件很简单，首先将包含此egg的行从easy-install.pth中删除，然后删除egg文件夹即可。
参考：
http://blog.ossxp.com/2010/12/2178/#id8