Python zipapp打包教程(超级详细)

经过复杂的开发、调试之后,终于得到一个 Python 程序,这个程序或许精巧,或许有些古拙,但它是我们心血的结晶,我们当然希望将这个程序发布出来。

Python 提供了一个 zipapp 模块,通过该模块可以将一个 Python 模块(可能包含很多个源程序)打包成一个 Python 应用,甚至发布成一个 Windows 的可执行程序。

生成可执行的Python档案包

zipapp 是一个可以直接运行的模块,该模块用于将单个 Python 文件或整个目录下的所有文件打包成可执行的档案包。

zipapp 模块的命令行语法如下:

python -m zipapp source [options]

在上面命令中,source 参数代表要打包的 Python 源程序或目录,该参数既可以是单个的 Python 文件,也可以是文件夹。如果 source 参数是文件夹,那么 zipapp 模块会打包该文件夹中的所有 Python 文件。

该命令的 options 支持如下选项:
  • -o <output>,--output=<output>:应选项指定输出档案包的文件名。如果不指定该选项,所生成的档案包的文件名默认为 source 参数值,并加上 .pyz 后缀。
  • -p <interpreter>,--python=<interpreter>:改选项用于指定 Python 解释器。
  • -m <mainfn>,--main=<mainfn>:该选项用于指定 Python 程序的入口函数。该选项应该为 pkg.mod:fn 形式,其中 pkg.mod 是一个档案包中的包或模块,fn 是指定模块中的函数。如果不指定该选项,则默认从模块中的 __main__.py 文件开始执行。
  • -c,--compress:从 Python 3.7 开始支持该选项。该选项用于指定是否对档案包进行压缩来减小文件的大小,默认是不压缩。
  • --info:该选项用于在诊断时显示档案包中的解释器。
  • -h,--help:该选项用于显示 zipapp 模块的帮助信息。

下面在某目录下建立一个 app 子目录,该子目录用于包含多个 Python 程序。首先在该目录下开发一个 say_hello.py 程序:
def say_hello(name):
    return name + ",您好!"
然后在该目录下开发一个 app.py 程序来使用 say_hello 模块:
from say_hello import *

def main():
    print('程序开始执行')
    print(say_hello('孙悟空'))
在命令行工具中进入该目录(app 目录的父目录),然后执行如下命令:

python -m zipapp app -o first.pyz -m "app:main"

上面命令指定将当前目录下的 app 子目录下的所有 Python 源文件打包成一个档案包,并通过 -o 选项指定所生成的档案包的文件名为 first.pyz;-m 选项指定使用 app.py 模块中的 main 函数作为程序入口。

运行上面命令,将会生成一个 first.pyz 文件。接下来可以使用 python 命令来运行 first.pyz 文件:

python first.pyz
程序开始执行
孙悟空,您好!

通过命令行工具在 app 目录的父目录下执行如下命令:

python -m zipapp app -m "app:main"

上面命令没有指定 -o 选项,这意味着该命令将会使用默认的输出文件名:source 参数值加 .pyz 后缀。运行上面命令,将会在当前目录下生成一个 app.pyz 文件。

zipapp创建独立应用

通过上面介绍的方式打包得到的档案包中只有当前项目的 Python 文件,如果 Python 应用还需要使用第三方模块和包(比如前面介绍的需要连接 MySQL 的应用),那么仅打包该应用的 Python 程序是不够的。

为了创建能独立启动的应用(自带依赖模块和包),需要执行两步操作:
  1. 将应用依赖的模块和包下载到应用目录中。
  2. 使用 zipapp 将应用和依赖模块一起打包成档案包。

下面在 app 所在目录下再创建一个 dbapp 子目录,该子目录将会作为本应用的目录。接下来在 dbapp 目录下新建一个 __main__.py 文件作为程序入口,这样程序在打包档案包时就不需要指定程序入口了。

下面是 __main__.py 文件的代码:
from exec_select import *

# 执行query_db()函数
query_db()
其中,exec_select.py 文件需要自己添加,包含代码如下:
# 导入访问MySQL的模块
import mysql.connector

def query_db():
    # ①、连接数据库
    conn = conn = mysql.connector.connect(user='root', password='32147',
        host='localhost', port='3306',
        database='python', use_unicode=True)
    # ②、获取游标
    c = conn.cursor()
    # ③、调用执行select语句查询数据
    c.execute('select * from user_tb where user_id > %s', (2,))
    # 通过游标的description属性获取列信息
    for col in (c.description):
        print(col[0], end='\t')
    print('\n--------------------------------')
    # 直接使用for循环来遍历游标中的结果集
    for row in c:
        print(row)
        print(row[1] + '-->' + row[2])
    # ④、关闭游标
    c.close()
    # ⑤、关闭连接
    conn.close()
最后按照如下步骤将 dbapp 子目录下的应用打包成独立应用:
  1. 通过命令行工具在dbapp当前所在目录执行如下命令:

    python -m pip install -r requirements.txt --target dbapp

    上面命令实际上就是使用 pip 模块来安装模块,其中 python -m pip install 表示要安装模块。--target 选项指定将模块安装到指定目录下,此处指定将依赖模块安装到 dbapp 子目录下。-r 选项指定要安装哪些模块,此处使用 requirements.txt 文件列出要安装的模块和包。-r 选项支持两个值:
    • 直接指定要安装的模块或包。
    • 使用清单文件指定要安装的模块和包。

    当应用依赖的模块较多时,建议使用清单文件来列出所依赖的模块。

    如果直接运行上面命令,pip 模块会提示找不到 requirements.txt 文件,因此需要在当前目录下添加一个 requirements.txt 文件,并在该文件中增加如下一行。

    mysql-connector-python

    如果项目需要依赖多个模块,则可以在 requirements.txt 文件中定义多行,每行定义一个模块。

    重新运行上面命令,将可以看到 pip 开始下载 mysql-connector-python 模块,下载完成后将可以在 dbapp 子目录下看到大量有关 mysql-connector-python 模块的文件。
  2. 如果 pip 在 dbapp 子目录下生成了 .dist-info 目录,则建议删除该目录。
  3. 使用 zipapp 模块执行打包操作。由于本例的 dbapp 子目录下包含了 __main__.py 文件,该文件将会作为程序入口,因此打包时不需要指定 -m 选项。使用如下命令来打包:

    python -m zipapp dbapp

    与上一节所使用的命令相比,该命令没有使用 -m 边项来指定程序入口,该程序将会使用档案包中的 __main__.py 文件作为程序入口。运行上面命令,将会得到一个大约为 18MB 的档案包。因为该档案包自包含了 mysql-connector-python 模块,所以比较大。

在创建了独立应用之后,只要目标机器上安装了合适版本的 Python 解释器,即可运行该独立应用。我们可以先使用如下命令卸载在 Python 目录下安装的 mysql-connector-python 模块:

pip uninstall mysql-connector-python

此时在本机的 Python 目录下不再包含 mysql-connector-python 模块,但 dbapp.pyz 程序依然可以正常运行,因为它自包含了 mysql-connector-python 模块。