python egg怎麼安裝-Python教學-PHP中文網

python egg怎麼安裝

經常接觸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&#39;m amoblin."
if __name__ == &#39;__main__&#39;:
    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&#39;m amoblin.

登入後複製

成功輸出！這說明安裝正確。我們的一個egg包誕生了。一般情況下，我們的原始程式都放在src目錄下，所以接下來將demo資料夾移到src裡。但這樣也要修改setup.py文件，修改find_packages函數中參數為'src'，同時增加package_dir參數：

packages=find_packages(&#39;src&#39;),
package_dir = {&#39;&#39;:&#39;src&#39;}

登入後複製

這樣告訴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資料夾即可。