一 setuptools 和easy_install setuptools:setuptools 是一組由PEAK(Python Enterprise Application Kit)開發(fā)的 Python 的 distutils 工具的增強(qiáng)工具,可以讓程序員更方便的創(chuàng)建和發(fā)布 Python的egg 包,特別是那些對其它包具有依賴性的狀況。 由 setuptools 創(chuàng)建和發(fā)布的包看起來和基于 distutils 發(fā)布的包沒什么不同。最終用戶不需要事先安裝 setuptools 甚至根本不需要知道 setuptools 的存在,而程序員也不需要附上完整的 setuptools,只需要包含一個大小約 8K 的ez_setup.py腳本作為啟動模塊,就可以在最終用戶沒有安裝適當(dāng)版本的 setuptools 時讓這些包自動下載和安裝 setuptools。
easy_install: 常使用python的人員,當(dāng)需要安裝第三方python包時,可能會用到easy_install命令。easy_install是由PEAK(Python Enterprise Application Kit)開發(fā)的setuptools包里帶的一個命令,它用來自動地從http://pypi./simple/來安裝egg包,相當(dāng)于perl中的cpan或PPM。
二 windows上安裝setuptool 方法1: exe安裝文件 從這里下載:setuptools-0.6c11.win32-py2.6.exe 安裝文件 如果以前曾經(jīng)安裝舊版的setuptools,則在安裝之前需要將系統(tǒng)中的site-packages目錄(以及任何其他sys.path目錄)下的所有setuptools*.egg和setuptools.pth文件刪除。 如果之前也是使用.exe安裝程序安裝的setuptools,則安裝前要在“添加/刪除程序”中卸載舊的版本。 安裝完畢后,在Python的Scripts子目錄下就會出現(xiàn)easy_install.exe程序。 確保將這個目錄(例如 C:\Python26\Scripts)加入 PATH 環(huán)境變量。
方法2: 手工安裝 卸載舊版的方法同 1 相同。 下載ez_setup.py腳本, http://peak./dist/ez_setup.py 然后在命令行運(yùn)行: python ez_setup.py
三 Linux上的setuptool的安裝 Debian/Ubuntu下可以直接使用apt安裝:: $ sudo apt-get install python-setuptools 手工安裝的話,有兩種方式:
四 easy_install的使用 1) 使用easy_install來自動安裝egg包 比如說要安裝Python的MYSQL支持,可以執(zhí)行如下命令,系統(tǒng)會自動在pypi網(wǎng)站列表里查找相關(guān)軟件包:easy_install MySQL-python。 通過easy_install安裝軟件,相關(guān)安裝信息會保存到easy-install.pth文件里,路徑類似如下形式:C:\Python25\Lib\site-packages\easy-install.pth。 如果想刪除通過easy_install安裝的軟件包,比如說:MySQL-python,可以執(zhí)行命令:easy_install -m MySQL-python。
2)將egg安裝包下載到本地安裝 進(jìn)入到安裝包的目錄,執(zhí)行python setup.py install
3)如果easy_install安裝某模塊有錯的話,則可以自己到http://pypi./simple/python-ldap/下載,然后使用python setup.py install來安裝。 有的時候easy_install并不能夠很好地自動安裝,比如我安裝ldap:easy_install.exe python-ldap, easy_install應(yīng)該到http://pypi./simple/python-ldap/下下載python-ldap-2.3.8.win32-py2.6.exe,但是easy_install卻找到了python-ldap 2.3.12,最總導(dǎo)致安裝有錯。(不知道是不是因?yàn)閜ypi上沒有64bit的egg,我的系統(tǒng)是64bit的,但是我的python是32bit的?。?br> 五 egg的制作 egg包是目前最流行的python應(yīng)用打包部署方式。如何制作和安裝egg包?下面我就簡單的分析了一下。
總是安裝別人的egg包,是不是也想制作自己的egg包呢?好,接下來我們就自己制作一個簡單的egg包。 首先建立工程目錄egg-demo,初始化一個setup.py文件: $ mkdir egg-demo $ cd egg-demo $ touch setup.py $ ls setup.py 下面主要就是填充setup.py。setup.py其實(shí)是python工具包distutils的配置文件,setuptools就是基于distutils來做的。 在setup.py中通過setup函數(shù)來配置打包信息。首先要引入setuptools的函數(shù)setup。setuptools的setup其實(shí)就是distutils的setup函數(shù),填寫setup.py為以下內(nèi)容: $ 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。 產(chǎn)蛋成功!先看看這個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壓縮包呀!好,再來看看內(nèi)部構(gòu)造: $ 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文件夾,內(nèi)含五個egg信息文件,沒了。 這個egg名稱未知,版本0.0.0。這是因?yàn)槲覀冊趕etup里什么也沒有設(shè)置。 顯然,這個egg什么也不能做。 下面給它加點(diǎn)料。 在setup.py中,setup函數(shù)接收一系列屬性作為配置參數(shù)。
還有一些描述性的屬性,如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@", 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。 奉行敏捷原則,先安裝了體驗(yàn)一下再說: $ 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函數(shù)中參數(shù)為’src’,同時增加package_dir參數(shù): packages=find_packages('src'), package_dir = {'':'src'} 這樣告訴setuptools在src目錄下找包,而不是原來默認(rèn)的工程根目錄。
最后我們來手動的卸載以下剛才安裝的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文件夾即可。
參考: |
|