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.   
  4. setup(console=["helloworld.py"])   

 

 

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

 

请尝试下面的方法:

 

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

 

然后按下面的方法运行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.   
  7. Options for 'py2exe' command:  
  8.   --optimize (-O)       optimization level: -O1 for "python -O", -O2 for  
  9.                         "python -OO", and -O0 to disable [default: -O0]  
  10.   --dist-dir (-d)       directory to put final built distributions in (default  
  11.                         is dist)  
  12.   --excludes (-e)       comma-separated list of modules to exclude  
  13.   --dll-excludes        comma-separated list of DLLs to exclude  
  14.   --ignores             comma-separated list of modules to ignore if they are  
  15.                         not found  
  16.   --includes (-i)       comma-separated list of modules to include  
  17.   --packages (-p)       comma-separated list of packages to include  
  18.   --compressed (-c)     create a compressed zipfile  
  19.   --xref (-x)           create and show a module cross reference  
  20.   --bundle-files (-b)   bundle dlls in the zipfile or the exe. Valid levels  
  21.                         are 1, 2, or 3 (default)  
  22.   --skip-archive        do not place Python bytecode files in an archive, put  
  23.                         them directly in the file system  
  24.   --ascii (-a)          do not automatically include encodings and codecs  
  25.   --custom-boot-script  Python file that will be run when setting up the  
  26.                         runtime environment  
  27.   
  28. usage: setup_py2exe.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]  
  29.    or: setup_py2exe.py --help [cmd1 cmd2 ...]  
  30.    or: setup_py2exe.py --help-commands  
  31.    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.   
  5. setup(console=["helloworld.py"],  
  6.       data_files=[("bitmaps",  
  7.                    ["bm/large.gif", "bm/small.gif"]),  
  8.                   ("fonts",  
  9.                    glob.glob("fonts\\*.fnt"))],  
  10. )   

 

说明: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.   
  4. 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.   
  4. setup(com_server=["win32com.server.interp"])   

 

 

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

一个标准的py2exe setup文件编写

 

 

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

 

 

新 版本已经可以打包为一个文件了,以前都是一堆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.        
  19.     )   

 

 

 

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

 

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

 

 

下面列出他的一些 options

 

keyword

  description

data_files

  list of "data" files that you are going to need to run your executable such as .pngs, .jpgs 

 

 

Py2exe extends Distutils setup keywords

 

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

keyword

description

console 

list of scripts to convert into console exes 

windows 

list of scripts to convert into GUI exes 

service 

list of module names containing win32 service classes 

com_server 

list of module names containing com server classes 

ctypes_com_server 

list of module names containing com server classes 

zipfile 

name of shared zipfile to generate; may specify a subdirectory; defaults to 'library.zip'. If zipfile is set to None , the files will be bundled within the executable instead of 'library.zip'. 

options 

dictionary { "py2exe": { "opt1": val1, "opt2": val2, ... } } 

 

 

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. 

 

key

value

unbuffered 

if true, use unbuffered binary stdout and stderr 

optimize 

string or int of optimization level (0, 1, or 2) 0 = don’t optimize (generate .pyc) 1 = normal optimization (like python -O) 2 = extra optimization (like python -OO) See http://docs.python.org/distutils/apiref.html#module-distutils.util for more info. 

includes 

list of module names to include 

packages 

list of packages to include with subpackages 

ignores 

list of modules to ignore if they are not found 

excludes 

list of module names to exclude 

dll_excludes 

list of dlls to exclude 

dist_dir 

directory in which to build the final files 

typelibs 

list of gen_py generated typelibs to include 

compressed 

(boolean) create a compressed zipfile 

xref 

(boolean) create and show a module cross reference 

bundle_files 

bundle dlls in the zipfile or the exe. Valid values for bundle_files are: 3 = don't bundle (default) 2 = bundle everything but the Python interpreter 1 = bundle everything, including the Python interpreter 

skip_archive 

(boolean) do not place Python bytecode files in an archive, put them directly in the file system 

ascii 

(boolean) do not automatically include encodings and codecs 

custom-boot-script 

Python file that will be run when setting up the runtime environment 

 

 

 

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

你可能感兴趣的:(email)