egg文件制作与安装

2011-06-10 14:22:50|  分类: python |  标签:python  egg   |字号大中小 订阅

 
 

python的egg文件有点像java中的jar文件,是一个工程打包文件,便于安装部署,仅此一点,给多少pythoner带来了多少激动。

如何制作egg文件呢?see官方文档http://peak.telecommunity.com/DevCenter/PythonEggs,
到http://pypi.python.org/pypi/setuptools下载setuptools包,然后安装:

python setup.py

1.制作egg文件

下面开始egg文件的制作:
在要打包的文件夹父目录中新建setup.py

#setup.py
view plaincopy to clipboardprint?
01.#coding=utf8  
02. 
03.from setuptools import setup, find_packages  
04. 
05.setup(  
06.    name = "eggtest",  
07.    version = "0.1",  
08.    packages = find_packages(),  
09. 
10.    description = "egg test demo",  
11.    long_description = "egg test demo",  
12.    author = "lidehong",  
13.    author_email = "idehong@gmail.com",  
14. 
15.    license = "GPL",  
16.    keywords = ("test", "egg"),  
17.    platforms = "Independant",  
18.    url = "http://blog.csdn.net/hong201/",   
19.      
20.) 
#coding=utf8

from setuptools import setup, find_packages

setup(
    name = "eggtest",
    version = "0.1",
    packages = find_packages(),

description = "egg test demo",
    long_description = "egg test demo",
    author = "lidehong",
    author_email = "idehong@gmail.com",

license = "GPL",
    keywords = ("test", "egg"),
    platforms = "Independant",
    url = "http://blog.csdn.net/hong201/",
   
)

name:包名
version:版本
packages :打包的文件
description:描述信息
author:作者
url:下载地址

执行python setup.py bdist_egg命令之后,在dist目录下会生成egg文件,egg文件其实只是一个压缩包

制作其他安装文件:

python setup.py build  # 编译
python setup.py sdist  # zip格式包
python setup.py bdist_wininst # exe格式包
python setup.py bdist_rpm # rpm格式包

注: 查看更多命令:

执行 python setup.py --help-commands后可以看到相关可用命令
Standard commands:
  build             build everything needed to install
  build_py          "build" pure Python modules (copy to build directory)
  build_ext         build C/C++ extensions (compile/link to build directory)
  build_clib        build C/C++ libraries used by Python extensions
  build_scripts     "build" scripts (copy and fixup #! line)
  clean                clean up temporary files from 'build' command
  install               install everything from build directory
  install_lib          install all Python modules (extensions and pure Python)
  install_headers   install C/C++ header files
  install_scripts     install scripts (Python or otherwise)
  install_data       install data files
  sdist                   create a source distribution (tarball, zip file, etc.)
  register              register the distribution with the Python package index
  bdist                  create a built (binary) distribution
  bdist_dumb       create a "dumb" built distribution
  bdist_rpm          create an RPM distribution
  bdist_wininst     create an executable installer for MS Windows
  upload              upload binary package to PyPI

 2.egg文件安装

羡慕cetos的yum,羡慕Ubuntu的apt-get,羡慕ruby的gem,现在python的egg成熟了,强大了,不用再羡慕了。

如果已经把egg文件下载到了本地,则easy_install xxx.egg就ok了,如何有依赖,则会自动下载安装,省心了。如果没有下载下来,网络安装更爽,直接 easy_install 包名,此时喝点咖啡休息一下,回过神来时已经安装好了。唯一一点不好的感觉是,easy_install现在还不支持自动卸载,网上流传的用 easy_install -m xxx来卸载,是不行了,这个命令式用来安装同一个包的多个版本的。

3.egg文件卸载

目前不能自动删除egg包,只能手动删除,而手动删除很简单

vim $python_path/Lib/site-packages/easy-install.pth

删除到egg包名所在行,

:wq

重启python环境。

这样做了之后egg包还是遗留下来了,没有被清除,不过这个不用担心,egg包已经不能被引用到python环境了,因为包名中不能有连字符-,而egg文件名中却包含连字符。

本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/hong201/archive/2009/05/28/4219035.aspx

-------------------------------

一 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包里带的一个命令,它用来自动地从http://pypi.python.org/simple/来安装egg包,相当于perl中的cpan或PPM。

二 windows上安装setuptool

方法1: exe安装文件 从这里下载:setuptools-0.6c11.win32-py2.6.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脚本, http://peak.telecommunity.com/dist/ez_setup.py  然后在命令行运行:  python ez_setup.py

三 Linux上的setuptool的安装

Debian/Ubuntu下可以直接使用apt安装::

  1. $ sudo apt-get install python-setuptools

手工安装的话,有两种方式:

  • 通过引导程序 ez_setup.py 来安装。这个引导程序会联网下载最新版本setuptools来安装,同时也可以更新本地的setuptools。

    1. $ wget http://peak.telecommunity.com/dist/ez_setup.py
    2. $ sudo python ez_setup.py

    更新setuptools::

    1. $ sudo python ez_setup.py -U setuptools
  • 或者下载setuptools的egg包来安装。可以在 这里 查看最新版本下载。下载完毕以后通过sh安装。
    1. $ wget http://pypi.python.org/packages/2.6/s/setuptools/setuptools-0.6c11-py2.6.egg
    2. $ 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安装某模块有错的话,则可以自己到http://pypi.python.org/simple/python-ldap/下载,然后使用python setup.py install来安装。

有的时候easy_install并不能够很好地自动安装,比如我安装ldap:easy_install.exe python-ldap, easy_install应该到http://pypi.python.org/simple/python-ldap/下下载python-ldap-2.3.8.win32-py2.6.exe,但是easy_install却找到了python-ldap 2.3.12,最总导致安装有错。(不知道是不是因为pypi上没有64bit的egg,我的系统是64bit的,但是我的python是32bit的啊)

五 egg的制作

egg包是目前最流行的python应用打包部署方式。如何制作和安装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.  
  5. from setuptools import setup
  6.  
  7. 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.  
  5. from setuptools import setup, find_packages
  6.  
  7. setup(
  8. name = "demo",
  9. version="0.1.0",
  10. packages = find_packages(),
  11. zip_safe = False,
  12.  
  13. description = "egg test demo.",
  14. long_description = "egg test demo, haha.",
  15. author = "amoblin",
  16. author_email = "amoblin@ossxp.com",
  17.  
  18. license = "GPL",
  19. keywords = ("test", "egg"),
  20. platforms = "Independant",
  21. url = "",
  22. )

在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.  
  6. def test():
  7. print "Hello, I'm amoblin."
  8.  
  9. if __name__ == '__main__':
  10. 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.  
  9. Installed /usr/local/lib/python2.6/dist-packages/demo-0.1.0-py2.6.egg
  10. Processing dependencies for demo==0.1.0
  11. Finished processing dependencies for demo==0.1.0

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

  1. $ python -c "from demo import test;test()"
  2. Hello, I'm amoblin.

成功输出!这说明安装正确。我们的一个egg包诞生了。

一般情况下,我们的源程序都放在src目录下,所以接下来将demo文件夹移动到src里。但这样也要修改setup.py文件,修改find_packages函数中参数为’src’,同时增加package_dir参数:

  1. packages=find_packages('src'),
  2. package_dir = {'':'src'}

这样告诉setuptools在src目录下找包,而不是原来默认的工程根目录。

最后我们来手动的卸载以下刚才安装的egg文件,以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://pypi.python.org/pypi/setuptools

http://blog.ossxp.com/2010/12/2178/#id8

python的egg包的安装和制作]的更多相关文章

  1. Python的egg包

    1.背景 查看flower的源码,首先看到flower的主程序如下: #!/usr/local/sinasrv2/bin/python2.7 # EASY-INSTALL-ENTRY-SCRIPT: ...

  2. python egg包免安装直接使用

    import sys egg_path='egg.egg' sys.path.append(egg_path) import egg_sample

  3. 测试miniconda,python以及机器学习包是否安装成功

    1.测试安装版本 conda -V python -V 2.安装的命令 (1)库升级和安装 升级全部库:  conda upgrade --all [不知道为什么,我的conda install nu ...

  4. 【Python使用】使用pip安装卸载Python包(含离线安装Python包)未完成???

    pip 是 Python 包管理工具,该工具提供了对Python包的查找.下载.安装.卸载的功能.Python 2.7.9 + 或 Python 3.4+ 以上版本都自带 pip 工具. pip使用( ...

  5. windows下安装python和依赖包的利器——Anaconda

    在windows下安装python和很多依赖包,安装起来略为痛苦,可以使用python的大整合包——Anaconda Anaconda下载地址: http://continuum.io/downloa ...

  6. Python之扩展包安装

    读者朋友,在比较新的版本(Python 2 >=2.7.9 or Python 3 >=3.4)中,pip或者easy_install 扩展包命令已经默认安装(可查看   你的安装目录\p ...

  7. python 使用 setup.py 方式安装及包的卸载

     安装:         可通过 --home 或 --prefix 指定安装目录 --prefix=xx/xxx    选择安装目录 --record files.txt   记录所有安装文件的路径 ...

  8. 使用pip install 或者easy_install安装Python的各种包出现cc failed with exit status 1

    *:first-child { margin-top: 0 !important; } body > *:last-child { margin-bottom: 0 !important; } ...

  9. CentOS6.5 安装Python 的依赖包

    1.CentOS6.5 安装Python 的依赖包 yum groupinstall "Development tools"yum install zlib-devel bzip2 ...

随机推荐

  1. Canvas 和 SVG 都允许您在浏览器中创建图形,但是它们在根本上是不同的

    SVG SVG 是一种使用 XML 描述 2D 图形的语言. SVG 基于 XML,这意味着 SVG DOM 中的每个元素都是可用的.您可以为某个元素附加 JavaScript 事件处理器. 在 SV ...

  2. FZU Problem 2136 取糖果

     Problem 2136 取糖果 Time Limit: 1000 mSec    Memory Limit : 32768 KB  Problem Description 有N个袋子放成一排,每个 ...

  3. Visual 中控制台程序如何使用MFC类库

    unresolved external symbol __beginthreadex错误的解决Win32 Consle Application使用MFC的一些类如CString时编译时相信会很经常遇到 ...

  4. 图论Hrbust1708许可证

    http://acm.hrbust.edu.cn/index.php?m=ProblemSet&a=showProblem&problem_id=1708 #include<st ...

  5. jmeter随笔(29)-关于自己的jar包和beanshell的使用

    点击标题下「蓝色微信名」可快速关注 坚持的是分享,搬运的是知识,图的是大家的进步,没有收费的培训,没有虚度的吹水,喜欢就关注.转发(免费帮助更多伙伴)等来交流,想了解的知识请留言,给你带来更多价值,是 ...

  6. OpenGL: 渲染管线理论

    http://blog.csdn.net/augusdi/article/details/19934463 学习着色器,并理解着色器的工作机制,就要对OpenGL的固定功能管线有深入的了解. 首先要知 ...

  7. Java后台工程师面试杂记——不跳不涨工资星人跳槽经历

    经过接近一个月的时间,完成换工作这件“小事”,前后总计面试了多家公司,最后也没接到几个offer,不过最终总算尘埃落定,就对这个过程进行一个总结吧. 在某互联网公司工作了近一年的时间,但是频繁的业务需 ...

  8. 【考试】简单的sql语句

    )显示正好为5个字符的员工的姓名 HR@ORA11GR2>select last_name,first_name from employees ; )显示不带有"R"的员工的 ...

  9. springMVC导出 CSV案例

    导出csv 第一步 Controller类里调用 OrderParamsVo 传入的参数 orderService.findBuyCSV 查询到要导出的信息 /** * 购买订单CSV * Order ...

  10. Swift开发中的一些琐碎

    1.Swift中使用OC 1.创建 pch 文件,直接引用需要的头文件  #import"SQLite3.h" 2.修改 pct 路径 ,如下图,就可以使用了 2. Swift 没 ...