py2exe使用方法 (含一些调试技巧，如压缩email 类)

http://justcoding.iteye.com/blog/900993

一、简介

py2exe是一个将python脚本转换成windows上的可独立执行的可执行程序(*.exe)的工具，这样，你就可以不用装python而在windows系统上运行这个可执行程序。

py2exe已经被用于创建wxPython,Tkinter,Pmw,PyGTK,pygame,win32com client和server,和其它的独立程序。py2exe是发布在开源许可证下的。

二、安装py2exe

从http://prdownloads.sourceforge.net/py2exe 下载并运行与你所安装的Python对应的py2exe版本的installer，这将安装py2exe和相应的例子；这些例子被安装在lib\site-packages\py2exe\samples目录下。

三、py2exe的用法

如果你有一个名为helloworld.py的python脚本，你想把它转换为运行在windows上的可执行程 序，并运行在没有安装python的 windows系统上，那么首先你应写一个用于发布程序的设置脚本例如mysetup.py，在其中的setup函数前插入语句 import py2exe 。

mysetup.py示例如下:

Python代码  

1. from distutils.core import setup
2. import py2exe
3. setup(console=["helloworld.py"])

如果显示错误提示的话 “ msvcp90.dll: no such file or directory”

请尝试下面的方法：

Python代码  

1. from distutils.core import setup
2. import py2exe
3. setup(
4. console=["helloworld.py"],
5. options = { "py2exe": { "dll_excludes": ["MSVCP90.dll"] } }
6. )

然后按下面的方法运行mysetup.py: （dos:  cmd => cd desktop => mysetup.py py2exe）
python mysetup.py py2exe

上面的命令执行后将产生一个名为dist的子目录，其中包含了helloworld.exe,python24.dll,library.zip这些文件。
如果你的helloworld.py脚本中用了已编译的C扩展模块，那么这些模块也会被拷贝在个子目录中，同样，所有的dll文件在运行时都是需要的，除了系统的dll文件。

dist子目录中的文件包含了你的程序所必须的东西，你应将这个子目录中的所有内容一起发布。

默认情况下，py2exe在目录dist下创建以下这些必须的文件：
1、一个或多个exe文件。
2、python##.dll。 
3、几个.pyd文件，它们是已编译的扩展名，它们是exe文件所需要的；加上其它的.dll文件，这些.dll是.pyd所需要的。
4、一个library.zip文件，它包含了已编译的纯的python模块如.pyc或.pyo

上面的mysetup.py创建了一个控制台的helloword.exe程序，如果你要创建一个图形用户界的程序，那么你只需要将mysetup.py中的console=["helloworld.py"]替换为windows=["myscript.py"]既可。

py2exe一次能够创建多个exe文件，你需要将这些脚本文件的列表传递给console或windows的关键字参数。如果你有几个相关联的脚本，那么这是很有用的。

运行下面个命令，将显示py2exe命令的所有命令行标记。
python mysetup.py py2exe --help

Python代码  

1. Global options:
2. --verbose (-v)  run verbosely (default)
3. --quiet (-q)    run quietly (turns verbosity off)
4. --dry-run (-n)  don‘t actually do anything
5. --help (-h)     show detailed help message
6. Options for ‘py2exe‘ command:
7. --optimize (-O)       optimization level: -O1 for "python -O", -O2 for
8. "python -OO", and -O0 to disable [default: -O0]
9. --dist-dir (-d)       directory to put final built distributions in (default
10. is dist)
11. --excludes (-e)       comma-separated list of modules to exclude
12. --dll-excludes        comma-separated list of DLLs to exclude
13. --ignores             comma-separated list of modules to ignore if they are
14. not found
15. --includes (-i)       comma-separated list of modules to include
16. --packages (-p)       comma-separated list of packages to include
17. --compressed (-c)     create a compressed zipfile
18. --xref (-x)           create and show a module cross reference
19. --bundle-files (-b)   bundle dlls in the zipfile or the exe. Valid levels
20. are 1, 2, or 3 (default)
21. --skip-archive        do not place Python bytecode files in an archive, put
22. them directly in the file system
23. --ascii (-a)          do not automatically include encodings and codecs
24. --custom-boot-script  Python file that will be run when setting up the
25. runtime environment
26. usage: setup_py2exe.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
27. or: setup_py2exe.py --help [cmd1 cmd2 ...]
28. or: setup_py2exe.py --help-commands
29. or: setup_py2exe.py cmd --help

四、指定额外的文件

一些应用程序在运行时需要额外的文件，诸如配置文件、字体、位图。
如果在安装脚本中用data_files可选项指定了那些额外的文件，那么py2exe能将这些文件拷贝到dist子目录中。data_files应包含一个元组(target-dir, files)列表，其中的files是这些额外的文件的列表。

示例如下：

PythonCode:  # mysetup.py

Python代码  

1. from distutils.core import setup
2. import glob
3. import py2exe
4. setup(console=["helloworld.py"],
5. data_files=[("bitmaps",
6. ["bm/large.gif", "bm/small.gif"]),
7. ("fonts",
8. glob.glob("fonts\\*.fnt"))],
9. )

说明：data_files选项将创建一个子目录dist\bitmaps，其中包含两个.gif文件；一个子目录dist\fonts，其中包含了所有的.fnt文件。

五、Windows NT services

你可以通过传递一个service关键字参数给setup函数来建造Windows NT services
,这个service参数的值必须是一个Python模块名(包含一service类)的列表。

示例如下：

PythonCode:  # mysetup.py

Python代码  

1. from distutils.core import setup
2. import py2exe
3. setup(service=["MyService"])

所建造的可执行的service是可以通过在其后跟一定的命令行参数标记来自行安装和卸载的。你可以通过在这个可执行的service(exe)后跟一-help参数来得到更多的帮助。

六、COM servers

你可以通过传递一个com_server 关键字参数给setup函数来建造Windows NT services
,这个service参数的值必须是一个Python模块名(包含一个或多个COM server 类)的列表。

示例如下：

PythonCode:  # mysetup.py

Python代码  

1. from distutils.core import setup
2. import py2exe
3. setup(com_server=["win32com.server.interp"])

默认情况下，DLL和EXE servers被建造，你不需要它们的话你可以简单的删除它们。

一个标准的py2exe setup文件编写

Python代码  

1. -*- coding: cp936 -*-
2. from distutils.core import setup
3. import py2exe
4. includes = ["encodings", "encodings.*"]
5. #要包含的其它库文件
6. options = {"py2exe":
7. {"compressed": 1, #压缩
8. "optimize": 2,
9. "ascii": 1,
10. "includes":includes,
11. "bundle_files": 1 #所有文件打包成一个exe文件 }
12. }
13. setup(
14. options = options,
15. zipfile=None,   #不生成library.zip文件
16. console=[{"script": "hello.py", "icon_resources": [(1, "hello.ico")] }]#源文件，程序图标
17. )

新 版本已经可以打包为一个文件了，以前都是一堆dll,pyd的。具体的变化其实只有一个地方。就是options里增加bundle_files项，值为 1表示pyd和dll文件会被打包到exe文件中，且不能从文件系统中加载python模块；值为2表示pyd和dll文件会被打包到exe文件中，但是 可以从文件系统中加载python模块。另外setup中使用zipfile=None可以不生成library.zip。

例如原来 的：

Python代码  

1. from distutils.core import setup
2. import py2exe
3. includes = ["encodings", "encodings.*"]
4. options = {"py2exe":
5. {   "compressed": 1,
6. "optimize": 2,
7. "includes": includes,
8. }
9. }
10. setup(
11. version = "0.1.0",
12. description = "search panda",
13. name = "search panda",
14. options = options,
15. windows=[{"script": "search.py", "icon_resources": [(1, "search.ico")] }],
16. )

只需要改为：

Python代码  

1. from distutils.core import setup
2. import py2exe
3. includes = ["encodings", "encodings.*"]
4. options = {"py2exe":
5. {   "compressed": 1,
6. "optimize": 2,
7. "includes": includes,
8. "bundle_files": 1
9. }
10. }
11. setup(
12. version = "0.1.0",
13. description = "search panda",
14. name = "search panda",
15. options = options,
16. zipfile=None,
17. windows=[{"script": "search.py", "icon_resources": [(1, "search.ico")] }],
18. )

比如，这里我打包以前的DelphiCode2HTML的

Python代码  

1. # -*- coding: gbk -*-
2. from distutils.core import setup
3. import py2exe
4. includes = ["encodings", "encodings.*"]
5. options = {"py2exe":
6. {"compressed": 1,
7. "optimize": 2,
8. "ascii": 1,
9. "includes":includes,
10. "bundle_files": 1}
11. }
12. setup(
13. options = options,
14. zipfile=None,
15. name = "HelloGuys.",
16. description = "this is a py2exe test",
17. windows=[{"script": "F:\我的程序\Python\CSDN Code Edit\Code2Html.py",
18. "icon_resources": [(1, "F:\书籍\我的图标\图标xp\Convert.ico")]
19. }]
20. )

下面列出他的一些 options

Py2exe extends Distutils setup keywords

In addition to the standard distutils setup keywords, the following py2exe keywords specify what and how to build.

The options dictionary of py2exe

The option keyword takes the following set of dictionary key: value pairs. The dictionary "key" names and the "value" types are listed in the table below.

Example:

Python代码  

1. setup(
2. windows=[‘trypyglet.py‘],
3. options={
4. "py2exe":{
5. "unbuffered": True,
6. "optimize": 2,
7. "excludes": ["email"]
8. }
9. }
10. )

For more information enter the following at the python command line:

Python代码  

1. >>> from distutils.core import setup
2. >>> help(setup)

注意 windows 的用法，他可以代替 console， 如果你要集成 wxpython 的时候，一定会用的 ！

更多请查看 http://www.py2exe.org/index.cgi/ListOfOptions

如果程序中含有email类，并且压缩时出现类似 “ImportError: No module named multipart ” 的错误，你需要如下的设置：

1. 尝试将Lib下的email包，复制到当前文件夹中

2. 把[‘emai‘] 放入includes中

3. 把[‘email‘]放入packages中

4. 继续运行py2exe

如：

Python代码  

1. from distutils.core import setup
2. import py2exe
3. includes = ["encodings", "encodings.*",‘email‘]
4. options = {"py2exe":
5. {   "compressed": 1,
6. "optimize": 2,
7. "includes": includes,
8. "bundle_files": 1,
9. "packages": [‘email‘],
10. "dll_excludes": ["MSVCP90.dll"]
11. }
12. }
13. setup(
14. version = "0.1.0",
15. description = "3th",
16. name = "For My Lover",
17. options = options,
18. zipfile=None,
19. windows=[{"script": "love.py", "icon_resources": [(1, "roses.ico")] }],
20. )