網頁

2012年12月9日 星期日

Python 套件的引入與發行步驟

使用Python程式時常會引用他人寫好的函式或模組來使用
Python Package Index是第三方Python模組的集散地
要看到Python的模組路徑就執行下列兩行
import sys;
print(sys.path)
Python直譯器會到這些被印出的路徑找模組執行

引入時在IDE輸入 import 關鍵字就會引入套件,例如 import demo 就會引入demo套件
但使用時注意要用 demo.print_list(lists)  #因為函式會被關連到命名空間 "demo"
這種做法會汙染命名空間,要慎用
另一種引入作法是 from demo import print_list
這樣可以不用經由命名空間呼叫函式,但要注意引入的函式間是否彼此有命名上的衝突

如果要建立套件發行則依照下列步驟執行-

1.建立資料夾並將自製的模組放入

2.在資料夾中建立名為 "setup.py" 的檔案
  檔案中的程式碼如下:
  from distutils.core import setup  #從Python的發行套件公用函式匯入setup函式

  setup(
    name = 'demo',
    version = '1.0.0',
  py_modules = ['demo'],  #將模組的metadata關連到setup函式
    author = 'vencs',
    author_email = 'vencsvencil@gmail.com',
    url = '....',
    description = 'used for demo',
   )

3.建構發行套件檔
  打開命令提示字元,將當前目錄切換到模組的資料夾底下
   #如果不是在windows底下則輸入python3 setup.py sdist
  輸入 C:\Python32\python.exe setup.py sdist   #指令為當前python.exe的路徑

4.把發行套件安裝成python的local副本
  在命令提示字元繼續輸入 python3 setup.py install

如果要分享自己製的模組到PYPI上還有步驟,這裡不贅述

若日後修改了套件程式碼,只需要在version的部分做變動(ex:1.0.1)
使用setup.py安裝最新版時,他就會變成當前的版本並取代之前的版本

沒有留言:

張貼留言