概覽

這裡主要收集python專案的打包、釋出和部署的常用方法，只是入門級別，深入的流程還是以官方文件為準（連結每節都已經給出）。

簡介

1. distutils - Python自帶的基本安裝工具, 適用於非常簡單的應用場景使用, 不支援依賴包的安裝 
   　　通過distutils來打包，生成安裝包，安裝python包等工作，需要編寫名為setup.py python指令碼檔案。

2. setuptools - 針對 distutils 做了大量擴充套件, 尤其是加入了包依賴機制。不支援python3，安裝完setuptools後會有easy_install

3. distribute - 類似於setuptools，支援python3，安裝完distribute後會有easy_install。

4. easy_install - setuptools 和 distribute 自帶的安裝指令碼, 也就是一旦setuptools或distribute安裝完畢, easy_install 也便可用了。

5. pip - 目標是取代easy_install。easy_install 有很多不足: 安裝事務是非原子操作, 只支援 svn, 沒有提供解除安裝命令, 安裝一系列包時需要寫指令碼; pip 解決了以上問題, 已儼然成為新的事實標準, virtualenv 與它已經成為一對好搭檔;

6. distutils2 - setuptools 和 distribute 的誕生是因為 distutils 的不濟, 進而導致目前分化的狀況。它將成為 Python 3.3 的標準庫 packaging , 並在其它版本中以distutils2 的身份出現; 換句話說, 它和 pip 將聯手結束目前混亂的狀況。

7. virtualenv - 用來建立隔離的python環境，處理python環境的多版本和模組依賴。

8. 常識 
   • sudo apt-get install 安裝的package存放在 /usr/lib/python2.7/dist-packages目錄中
   • pip 或者 easy_install安裝的package存放在/usr/local/lib/python2.7/dist-packages目錄中
   • 手動從原始碼安裝的package存放在site-packages目錄中

一、distutils

1. 新建資料夾(例如:distribution), 將專案檔案放進去

2. 在該資料夾下,新建setup.py檔案

   • 編輯內容:

     from distutils.core import setup 
     setup( 
     name=’logIn’, #這個是最終打包的檔名 
     version=’1.0.0’, 
     py_modules=[‘logInr’], #要打包哪些，.py檔案， 
     )

   • 儲存退出

3. 在命令列下,進入該資料夾,執行一下命令:

   • (1). 打包:python setup.py sdist 
     這樣在資料夾中就多出了幾個檔案,在dist資料夾中的，logIn-1.0.0.tar.gz就是我們的釋出包了；
   • (2). 安裝包到本地副本中(路徑為：/usr/local/lib/python2.7/dist-packages): 
     sudo python setup.py install (–record files.txt) 
     注意:為了方便解除安裝,可以新增括號中的選項(當前資料夾會產生files.txt), 解除安裝時就可以在當前資料夾下使用如下命令: 
     sudo cat files.txt | sudo xargs rm -rf

二、setuptools:

1. setuptools 只是對distutils 的增強, 其使用過程還是一樣:

   編輯: 先在專案主目錄下編輯setup.py,
   打包: python setup.py sdist 
   安裝: sudo python setup.py install  (--record files.txt)
   解除安裝: sudo cat files.txt | sudo  xargs rm -rf
   

2. setuptools工具的setup.py的模板

   • 模板 （只是一部分, 詳見官網說明）

     import ez_setup
     ez.setup.use_setuptools()   # 這兩行是當setuptools不存在時,自動從網上下載安裝所需的setuptools包.
     from setuptools import setup, find_packages
     setup(
         name = "HelloWorld",
         version = "0.1",
         packages = find_packages(),     # 常用,要熟悉 :會自動查詢當前目錄下的所有模組(.py檔案) 和包(包含__init___.py檔案的資料夾)
         scripts = ['say_hello.py'],
         # Project uses reStructuredText, so ensure that the docutils get
         # installed or upgraded on the target machine
         install_requires = ['docutils>=0.3'],       # 常用
         package_data = {
             # If any package contains *.txt or *.rst files, include them:
             '': ['*.txt', '*.rst'],
             # And include any *.msg files found in the 'hello' package, too:
             'hello': ['*.msg'],
         },
         # 
         entry_points = {
             'console_scripts': [
                 'foo = demo:test',
                 'bar = demo:test',
             ],
             'gui_scripts': [
                 'baz = demo:test',
             ]
         },
         # metadata for upload to PyPI
         author = "Me",
         author_email = "[email protected]",
         description = "This is an Example Package",
         license = "PSF",
         keywords = "hello world example examples",
         url = "http://example.com/HelloWorld/",   # project home page, if any
         # could also include long_description, download_url, classifiers, etc.
     )
     

三、virtualenv

1. 主要命令:

       $ virtualenv ENV
       $ virtualenv --system-site-packages ENV   # 繼承系統原來的安裝包
       $ source bin/activate  # 啟動虛擬環境
       $ deactivate       # 退出環境
       $ rm -r /path/to/ENV   # 刪除環境
       $ virtualenv --relocatable ENV  #  創造可以浮動的虛擬環境
       $ virtualenv --extra-search-dir=/path/to/distributions ENV # 新增自定義版本的pip或setuptools        
   

2. 移植:

       建立無繼承的虛擬環境
       virtualenv  --no-site-packages  PATH/to/projDirName
   
       進入projDirName, 編輯專案
       cd  PATH/to/projDirName
   
       退出,至上級目錄
       cd  ..
       virtualenv --relocatable   projDirName#  創造可以浮動的虛擬環境
   
       將整個資料夾複製到指定的機器上, 進入PATH/to/projDirName, 啟動環境,執行程式
   

四 、pip

• 這裡只列出部署相關的兩條命令

      pip freeze  > requirements      #  freeze 是匯出當前環境安裝的安裝包
  
      pip install -r requirements.txt         # 這個requirements.txt 有格式要求