Chinaunix首页 | 论坛 | 博客
  • 博客访问: 5119557
  • 博文数量: 921
  • 博客积分: 16037
  • 博客等级: 上将
  • 技术积分: 8469
  • 用 户 组: 普通用户
  • 注册时间: 2006-04-05 02:08
文章分类

全部博文(921)

文章存档

2020年(1)

2019年(3)

2018年(3)

2017年(6)

2016年(47)

2015年(72)

2014年(25)

2013年(72)

2012年(125)

2011年(182)

2010年(42)

2009年(14)

2008年(85)

2007年(89)

2006年(155)

分类: Python/Ruby

2013-10-22 17:10:54

目录

经常接触Python的同学可能会注意到,当需要安装第三方python包时,可能会用到easy_install命令。easy_install是由PEAK(Python Enterprise Application Kit)开发的setuptools包里带的一个命令,它用来安装egg包。egg包是目前最流行的python应用打包部署方式。如何制作和安装egg包?下面我就简单的分析了一下。

首先要安装setuptools工具。Debian/Ubuntu下可以直接使用apt安装::

  1. $ sudo apt-get install python-setuptools

手工安装的话,有两种方式:
  • 通过引导程序  来安装。这个引导程序会联网下载最新版本setuptools来安装,同时也可以更新本地的setuptools。
$ wget
$ sudo python ez_setup.py

更新setuptools::

  1. $ sudo python ez_setup.py -U setuptools
*  或者下载setuptools的egg包来安装。可以在  查看最新版本下载。下载完毕以后通过sh安装。

  1. $ wget
  2. $ sudo sh setuptools-0.6c11-py2.6.egg
现在就可以使用easy_install命令来安装其他的egg包了。

总是安装别人的egg包,是不是也想制作自己的egg包呢?好,接下来我们就自己制作一个简单的egg包。 首先建立工程目录egg-demo,初始化一个setup.py文件:


  1. $ mkdir egg-demo
  2. $ cd egg-demo
  3. $ touch setup.py
  4. $ ls
  5. setup.py

下面主要就是填充setup.py。setup.py其实是python工具包distutils的配置文件,setuptools就是基于distutils来做的。 在setup.py中通过setup函数来配置打包信息。首先要引入setuptools的函数setup。setuptools的setup其实就是distutils的setup函数,填写setup.py为以下内容:


  1. $ cat setup.py
  2. #!/usr/bin/env python
  3. #-*- coding:utf-8 -*-

  4. from setuptools import setup

  5. setup()
写到这里,一个空的egg配置文件就写好了。我们可以使用下面命令生成egg包:


  1. python setup.py bdist_egg

下面看看究竟生成了什么:

  1. $ ls -F
  2. build/ dist/ setup.py UNKNOWN.egg-info/
可以看到多了三个文件夹。而在dist文件夹下,有一个egg文件:UNKNOWN-0.0.0-py2.6.egg。 产蛋成功!先看看这个egg文件是什么格式的:


  1. $ file dist/UNKNOWN-0.0.0-py2.6.egg
  2. dist/UNKNOWN-0.0.0-py2.6.egg: Zip archive data, at least v2.0 to extract
噢,原来就是一个zip压缩包呀!好,再来看看内部构造:

  1. $ unzip -l dist/UNKNOWN-0.0.0-py2.6.egg
  2. Archive: dist/KNOWN-0.0.0-py2.6.egg
  3. Length Date Time Name
  4. --------- ---------- ----- ----
  5. 120 2010-12-06 17:04 EGG-INFO/SOURCES.txt
  6. 1 2010-12-06 17:04 EGG-INFO/top_level.txt
  7. 1 2010-12-06 17:04 EGG-INFO/zip-safe
  8. 1 2010-12-06 17:04 EGG-INFO/dependency_links.txt
  9. 227 2010-12-06 17:04 EGG-INFO/PKG-INFO
  10. --------- -------
  11. 350 5 files

只有一个EGG-INFO文件夹,内含五个egg信息文件,没了。 这个egg名称未知,版本0.0.0。这是因为我们在setup里什么也没有设置。 显然,这个egg什么也不能做。 下面给它加点料。 在setup.py中,setup函数接收一系列属性作为配置参数。
  • name name是egg包的名称,也是寻找要打包的文件夹的名称,默认是UNKNOWN。
  • version 版本号,默认0.0.0
  • packages 这里要用到setuptools的另一个函数find_packages,顾名思义,find_packages用来将指定目录下的文件打包。
  • zip_safe 默认是False,这样在每次生成egg包时都会检查项目文件的内容,确保无误。
还有一些描述性的属性,如description,long_description,author,author_email,license,keywords,platform,url等。 填充setup.py文件如下::


  1. $ cat setup.py
  2. #!/usr/bin/env python
  3. #-*- coding:utf-8 -*-

  4. from setuptools import setup, find_packages

  5. setup(
  6.         name = "demo",
  7.         version="0.1.0",
  8.         packages = find_packages(),
  9.         zip_safe = False,

  10.         description = "egg test demo.",
  11.         long_description = "egg test demo, haha.",
  12.         author = "amoblin",
  13.         author_email = "amoblin@ossxp.com",

  14.         license = "GPL",
  15.         keywords = ("test", "egg"),
  16.         platforms = "Independant",
  17.         url = "",
  18.         )

在egg-demo目录下建立和上述name名称相同的目录demo,demo目录下写__init__.py文件:


  1. $ mkdir demo
  2. $ cat demo/__init__.py
  3. #!/usr/bin/env python
  4. #-*- coding:utf-8 -*-

  5. def test():
  6.     print "Hello, I'm amoblin."

  7. if __name__ == '__main__':
  8.     test()
再次生成egg包以后查看egg包信息:

  1. $ python setup.py bdist_egg
  2. $ unzip -l dist/demo-0.1.0-py2.6.egg
  3. Archive: dist/demo-0.1.0-py2.6.egg
  4.   Length Date Time Name
  5. --------- ---------- ----- ----
  6.       121 2010-12-06 17:30 demo/__init__.py
  7.       344 2010-12-06 17:46 demo/__init__.pyc
  8.       137 2010-12-06 17:46 EGG-INFO/SOURCES.txt
  9.         5 2010-12-06 17:46 EGG-INFO/top_level.txt
  10.         1 2010-12-06 17:46 EGG-INFO/zip-safe
  11.         1 2010-12-06 17:46 EGG-INFO/dependency_links.txt
  12.       227 2010-12-06 17:46 EGG-INFO/PKG-INFO
  13. --------- -------
  14.       836 7 files
可以看到,多了一个文件夹demo,里面有我们写的__init__.py。 奉行敏捷原则,先安装了体验一下再说:

  1. $ sudo python setup.py install
  2. running install
  3. install_dir /usr/local/lib/python2.6/dist-packages/
  4. ...
  5. creating /usr/local/lib/python2.6/dist-packages/demo-0.1.0-py2.6.egg
  6. Extracting demo-0.1.0-py2.6.egg to /usr/local/lib/python2.6/dist-packages
  7. demo 0.1.0 is already the active version in easy-install.pth
  8. Installed /usr/local/lib/python2.6/dist-packages/demo-0.1.0-py2.6.egg
  9. Processing dependencies for demo==0.1.0
  10. Finished processing dependencies for demo==0.1.0

OK!安装完毕!接下来我们就可以直接通过import来使用啦

  1. $ python -c "from demo import test;test()"
  2. Hello, I
成功输出!这说明安装正确。我们的一个egg包诞生了。 一般情况下,我们的源程序都放在src目录下,所以接下来将demo文件夹移动到src里。但这样也要修改setup.py文件,修改find_packages函数中参数为'src',同时增加package_dir参数:


  1. packages=find_packages('src'),
  2. package_dir = {'':'src'}
这样告诉setuptools在src目录下找包,而不是原来默认的工程根目录。

以python2.6版本为例,egg文件一般安装在/usr/local/lib/python2.6/dist-packages/目录下,该目录下还有一个easy-install.pth文件,用于存放安装的egg信息。:


  1. $ cd /usr/local/lib/python2.6/dist-packages
  2. $ cat easy-install.pth|grep demo
  3. ./demo-0.1.0-py2.6.egg
  4. $ ls -F|grep demo
  5. demo-0.1.0-py2.6.egg/

卸载egg文件很简单,首先将包含此egg的行从easy-install.pth中删除,然后删除egg文件夹即可。

原文地址:http://blog.csdn.net/turkeyzhou/article/details/8876658





 

阅读(1404) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~