經常接觸Python的同學可能會注意到,當需要安裝第三方python套件時,可能會用到easy_install指令。 easy_install是由PEAK(Python Enterprise Application Kit)開發的setuptools包裡帶的指令,它用來安裝egg包。 egg包是目前最受歡迎的python應用程式打包部署方式。
如何製作和安裝egg包?下面我就簡單的分析了一下。
1.1 安裝setuptools
#首先要安裝setuptools工具。 Debian/Ubuntu下可以直接使用apt安裝::
$ sudo apt-get install python-setuptools
手動安裝的話,有兩種方式:
透過引導程式 ez_setup.py 來安裝。這個引導程式會連網下載最新版本setuptools來安裝,同時也可以更新本地的setuptools。
$ wget http://peak.telecommunity.com/dist/ez_setup.py $ sudo python ez_setup.py
更新setuptools::
$ sudo python ez_setup.py -U setuptools
或下載setuptools的egg包來安裝。可以在 這裡 查看最新版本下載。下載完畢以後再透過sh安裝。
$ wget http://pypi.python.org/packages/2.6/s/setuptools/setuptools-0.6c11-py2.6.egg $ sudo sh setuptools-0.6c11-py2.6.egg
現在就可以使用easy_install指令來安裝其他的egg包了。
1.2 製作自己的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函數接收一系列屬性作為配置參數。
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檔案如下::
$ 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目錄下找包,而不是原來預設的工程根目錄。
1.3 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資料夾即可。
相關推薦:《Python教學》
以上是python egg怎麼安裝的詳細內容。更多資訊請關注PHP中文網其他相關文章!