Python 打包和发布方法汇总

时间:2021-01-23 16:49:36

以下主要Python打包汇总,作为学习备份;

一、使用python内部基础工具包Distutils打包程序

  1. 在打包之前需要做的就是配置好安装脚本,一般为setup.py文件;

  示例(setup.py):

  from distutils.core import setup

  setup(name='Hello',

     version='1.0',

     description='example',

     author='haomiao',

     py_modules=['hello'])

  该配置文件,只使用了py_modules参数,单一的模块文件名hello.py,当然还有其他的属性、选项可设置;hello.py应与setup.py在同一目录下,分发的时候最好将该目录作为单独的一个目录文件,并将其所依赖的或需要的文件、资源均放在这个目录下或其子目录下,该目录就可以分发给其他开发人员或客户(一般的最终客户不会做这些安装的繁琐事情);

  此外,若有其他的资源文件或是其他的多个py文件,则可以增加packages等其他相关的参数指令。

  将该目录模块安装到python中;执行:python setup.py install ,此后将会复制相关文件至python安装路径下的Lib/site-packages下,

  如上示例将会在该路径下产生:hello.py hello.pyc Hell-1.0-pyx.x.egg-info文件;在使用的时候直接:import hello即可使用。

  2. 在1的基础上打包,使用sdist命令(用于源码发布的形式)

  执行:python setup.py sdist ,将产生两个目录build、dist以及MANIFEST列表文件,build下为中间文件可不用,dist下会打包成一个压缩文件,如:Hello-1.0.zip;事实上,该压缩文件内部包含之前的文件以及PKG-INFO的描述文件,这个时候该压缩文件就可以分发给用户;

  3. 在1的基础上打包,使用bdist命令(用于创建windows或linux的安装程序)

  执行:python setup.py bdist --formats=wininst , 将在dist下产生windows下的安装程序,如:Hello-1.0.win-amd64.exe(产生64位的安装程序,32位的python时会产生相应32位的安装程序Hello-1.0.win32.exe,产生linux的rpm程序,则将wininst改为rpm)。

  4. 在1的基础上使用扩展python(主要是由其他编程语言对python开发的某种模块的功能扩展,以下以C语言为例,比如一个扩展文件ext.c)

  修改1中的setup.py安装配置文件,如

  from distutils.core import setup,Extension

  setup(name='Hello',

     version='1.0',

     description='example',

     author='haomiao',

     ext_modules=[Extension('hello', ['ext.c', ‘ext.i’])])

  改用ex_modules参数,此外ext.c为C语言实现的功能,ext.i为头文件、导出函数、数据的描述文件,示例如下(ext.i):

  %module hello

  %{

  #include<string.h>

  %}

  extern in extFunc(int num);

  说明:以%表述模块名和包含头文件;下面为需要导出的函数、数据等。

  执行:python setup.py build_ext --inplace , 将产生build中间文件,以及hello.pyd, ext_wrap.c包装文件

  5. 使用py2exe创建可执行程序(用户不用安装python解释器)(作为Distutils的扩展)

  在使用前,需要安装pyp2exe,编写setup.py文件,如下:

  from distutils.core import setup

  import py2exe

  setup(console=['hello.py'])

  执行:python setup.py py2exe , 执行完成后,将产生build中间文件,dist目标文件,内部一般有:_hashlib.pyd bz2.pyd hello.exe library.zip pythonxx.dll select.pyd unicodedata.pyd基本上dist下所有文件应该被发布,除非你确认某些模块或文件不会被用到。

  说明:以上所有的方法为概括说明作为指导,具体可以参考相应工具的文档、demo等。