一 setuptools 和easy_install setuptools:setuptools 是一組由PEAK(Python Enterprise Application Kit)開發(fā)的 Python 的 distutils 工具的增強(qiáng)工具,,可以讓程序員更方便的創(chuàng)建和發(fā)布 Python的egg 包,,特別是那些對(duì)其它包具有依賴性的狀況,。 由 setuptools 創(chuàng)建和發(fā)布的包看起來和基于 distutils 發(fā)布的包沒什么不同,。最終用戶不需要事先安裝 setuptools 甚至根本不需要知道 setuptools 的存在,,而程序員也不需要附上完整的 setuptools,,只需要包含一個(gè)大小約 8K 的ez_setup.py腳本作為啟動(dòng)模塊,,就可以在最終用戶沒有安裝適當(dāng)版本的 setuptools 時(shí)讓這些包自動(dòng)下載和安裝 setuptools。
easy_install: 常使用python的人員,,當(dāng)需要安裝第三方python包時(shí),,可能會(huì)用到easy_install命令,。easy_install是由PEAK(Python Enterprise Application Kit)開發(fā)的setuptools包里帶的一個(gè)命令,它用來自動(dòng)地從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子目錄下就會(huì)出現(xiàn)easy_install.exe程序,。 確保將這個(gè)目錄(例如 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來自動(dòng)安裝egg包 比如說要安裝Python的MYSQL支持,可以執(zhí)行如下命令,,系統(tǒng)會(huì)自動(dòng)在pypi網(wǎng)站列表里查找相關(guān)軟件包:easy_install MySQL-python,。 通過easy_install安裝軟件,相關(guān)安裝信息會(huì)保存到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安裝某模塊有錯(cuò)的話,,則可以自己到http://pypi./simple/python-ldap/下載,,然后使用python setup.py install來安裝。 有的時(shí)候easy_install并不能夠很好地自動(dòng)安裝,,比如我安裝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)致安裝有錯(cuò),。(不知道是不是因?yàn)閜ypi上沒有64bit的egg,,我的系統(tǒng)是64bit的,但是我的python是32bit的?。?br> 五 egg的制作 egg包是目前最流行的python應(yīng)用打包部署方式,。如何制作和安裝egg包?下面我就簡(jiǎn)單的分析了一下,。
總是安裝別人的egg包,,是不是也想制作自己的egg包呢?好,,接下來我們就自己制作一個(gè)簡(jiǎn)單的egg包,。 首先建立工程目錄egg-demo,初始化一個(gè)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() 寫到這里,一個(gè)空的egg配置文件就寫好了,。我們可以使用下面命令生成egg包: $ python setup.py bdist_egg 下面看看究竟生成了什么: $ ls -F build/ dist/ setup.py UNKNOWN.egg-info/ 可以看到多了三個(gè)文件夾,。而在dist文件夾下,有一個(gè)egg文件:UNKNOWN-0.0.0-py2.6.egg,。 產(chǎn)蛋成功,!先看看這個(gè)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 噢,原來就是一個(gè)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 只有一個(gè)EGG-INFO文件夾,內(nèi)含五個(gè)egg信息文件,,沒了,。 這個(gè)egg名稱未知,版本0.0.0,。這是因?yàn)槲覀冊(cè)趕etup里什么也沒有設(shè)置,。 顯然,這個(gè)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 可以看到,多了一個(gè)文件夾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. 成功輸出!這說明安裝正確,。我們的一個(gè)egg包誕生了,。 一般情況下,我們的源程序都放在src目錄下,,所以接下來將demo文件夾移動(dòng)到src里。但這樣也要修改setup.py文件,,修改find_packages函數(shù)中參數(shù)為’src’,,同時(shí)增加package_dir參數(shù): packages=find_packages('src'), package_dir = {'':'src'} 這樣告訴setuptools在src目錄下找包,而不是原來默認(rèn)的工程根目錄,。
最后我們來手動(dòng)的卸載以下剛才安裝的egg文件,,以python2.6版本為例,egg文件一般安裝在/usr/local/lib/python2.6/dist-packages/目錄下,,該目錄下還有一個(gè)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文件很簡(jiǎn)單,,首先將包含此egg的行從easy-install.pth中刪除,,然后刪除egg文件夾即可,。
參考: |
|