任我行

py2exe工具簡介......                                      

py2exe是一個工具程式，可以將python程式轉換成為單一的執行檔案。在某些情況下使用者也許不希望安裝整個python套件或是相關的檔案。透過py2exe可以將您的工具包裝成單一的執行檔，及數個相關檔案。使用者只要下載這幾個檔案就可以執行該程式了。因為py2exe會自動將該工具的或自動搜尋您的python程式中所有用到的模組及檔案加以集中包裝至這數個檔案中。關於py2exe的相關資訊可以在下面的網站中找到。http://sourceforge.net/projects/py2exe/

且讓我用一個範例來說明。我寫了一個wxPython的程式。大家都知道wxPython就是python及wxWindows的結合。對於使用者來說，要同時在他們的電腦中安裝python及wxPython，其實是個蠻沈重的負擔。所以我打算使用py2exe將我寫的工具包裝起來。我的程式總共有兩個檔案分別是：HtmlConv.py及MainFrame.py。此時，我們需要準備小小的python程式，透過這個程式來呼叫py2exe包裝我們的程式。我們將這個程式取名為setup.py。其內容如下：# setup.py
from distutils.core import setup
import py2exe
 setup(windows=["HtmlConv.py"])
讓我們來看一下這個檔案的內容。首先，我們可以看到這個python程式引入了distutils這個模組，這個模組是python的標準模組之一。py2exe其實算是他的擴充模組之一，所以需要載入這個模組中的setup部分。然後，再引入py2exe這個模組。因為我們的程式很簡單，所以只需要簡單的呼叫setup function。並且在在參數中指定您的主要程式的檔名。您或許會懷疑，我們怎麼不用指定MainFrame.py這個檔案呢？因為MainFrame.py是被HtmlConv.py這個檔案所import的，py2exe在處理HtmlConv.py時，就會處理到MainFrame.py了。有了這三個檔案後，我們需要透過command的方式呼叫python來執行我們的setup.py程式。指令如下：python.exe setup.py py2exe
您也可以透過下面的命令來瞭解py2exe提供了哪些command line參數：python.exe setup.py py2exe --help
接著，您會看到許多的訊息跑出來，如果都沒有錯誤出現，您會看到出現了兩個新的目錄名為build以及dist。其中build是py2exe再製作過程中的一個暫存目錄。您可以不予理會。而dist目錄中就是您要的東西了。我們的範例中dist目錄產生了下面這些檔案：HtmlConv.exe
library.p
python23.dll
w9xpopen.exe
wxc.pyd
xmsw24uh.dll
使用者只需要將這幾個檔案拷貝回去執行HtmlConv.exe就可以執行我們的工具程式。這對於使用者來說，無疑是非常方便的。現在讓我們重新看看setup.py這個檔案的內容。因為我的工具程式是視窗介面的，不需要出現console視窗。因此，我透過指定 windows=["HtmlConv.py"] 的方式來指定主要檔案。如果您的程式是屬於console介面的，您就應該使用 console=["xxx.py"] 的方式來指定您的程式。此外，py2exe也支援Windows Service及COM元件類型的程式。分別使用下面的方式指定之：service=["MyService"]
或com_server=["win32com.server.interp"]
py2exe其實是透過python的modulefinder來找到所需的module，再將他們包裝在一起。您在dist目錄中所看到的library.p就是這些module的壓縮檔。不過，也正因為如此，如果是一些您程式中所需要的資料檔，如圖片，音效等等。py2exe並沒有辦法幫您自動包裝起來。不過，您還是可以透過手動的方式在setup.py中指定setup function的參數來告訴py2exe您還有哪些檔案。假設我們原來程式有一個子目錄名為bmp，下面放了一些程式用到的圖形檔。另外，還有一個子目錄名為wav，放了一些程式會用到的wav檔案。此時，我們的setup function參數應修改為如下：setup(windows=["HtmlConv.py"],
      data_files=[("bmp",
                   ["bmp/logo.bmp", "bmp/title.gif"]),
                  ("wav",
                   glob.glob("sounds\*.wav"))])
data_files這個參數是一個list，list內的每個元素都是一個pair。pair的第一個元素是您所指定的檔案的目的地。第二個元素是一個list，列出了那些檔案的來源。且讓我們仔細看看上面的範例。第一組pair，告訴py2exe在dist目錄下面另外建立一個bmp目錄，並且將原來bmp目錄中的的logo.bmp及title.gif檔案複製到dist目錄中的bmp子目錄。如果您不希望建立子目錄，可以將目的目錄指定為空白字串。此時，py2exe會將您指定的檔案複製到dist目錄下。而第二組pair告訴py2exe在dist目錄中建立wav子目錄。然後將sounds目錄中的所有副檔名為wav的檔案拷貝過去。由於我們用了glob的功能。所以別忘了在setup.py中import glob模組。預設的狀況下，製作出來的執行檔所使用的icon是windows下的預設icon。其實，您可以自己將他修改成其他的icon。首先您先要準備好一個icon檔案。以上面的例子來說，我們準備一個名為HtmlConv.ico的檔案(檔名未必要與python程式相同)。接著，將上面的範例修改如下：setup(windows=["HtmlConv.py", {"script":"HtmlConv.py", "icon_resources":[(1, "HtmlConv.ico")]}],
      data_files=[("bmp",
                   ["bmp/logo.bmp", "bmp/title.gif"]),
                  ("wav",
                   glob.glob("sounds\*.wav"))])
重新製作執行檔後，該執行檔就會是您所指定的icon囉。py2exe的使用對於會使用python的programmer來說，是非常簡單。而對於使用者而言，可以不用安裝許多不必要的東西就可以使用。實在是非常值得推薦的工具。