Python pex：打包 Python 可执行文件

在本文中，我们将介绍 Python pex 工具，以及如何使用它来打包 Python 可执行文件。Python pex 是一个非常有用的工具，它可以将 Python 项目及其依赖项打包成一个独立的可执行文件，使得在不同的环境中轻松部署和运行 Python 应用程序。

阅读更多：Python 教程

什么是 Python pex？

Python pex（Python EXecutable）是一个命令行工具，它能够创建独立的 Python 可执行文件，其中包含了应用程序的代码和其所有依赖的第三方库。打包成 pex 文件后，就可以将应用程序在不同的机器上运行，而无需事先安装 Python 或者其依赖库。这使得部署和分发 Python 应用程序变得更加简单和可靠。

与传统的 Python 打包工具相比，如 pyinstaller 或者 cx_Freeze，Python pex 的一个重要特点是它能够很好地处理依赖关系。它会自动下载和包含应用程序所需的依赖库，确保打包后的可执行文件可以在目标环境中顺利运行。

如何使用 Python pex

使用 Python pex 非常简单，首先需要在本地安装 pex 工具，可以通过 pip 来安装：

pip install pex

安装完成后，就可以使用 pex 命令来打包 Python 可执行文件了。下面我们通过一个简单的示例来演示如何使用 Python pex：

假设我们有一个 Python 项目，项目结构如下：

myapp/
  |-- main.py
  |-- requirements.txt

在 main.py 文件中，我们有一个简单的 Python 程序：

def hello():
    print("Hello, pex!")

if __name__ == "__main__":
    hello()

在 requirements.txt 文件中，我们列出了项目的依赖库：

requests==2.25.1

现在，我们可以使用 pex 命令来打包这个项目：

pex --disable-cache -o myapp.pex -m main -r requirements.txt .

上述命令中的参数解释如下：
– --disable-cache：禁用缓存，以确保 pex 文件可以在不同机器上运行；
– -o myapp.pex：指定输出文件名为 myapp.pex；
– -m main：指定入口模块为 main.py；
– -r requirements.txt：指定依赖库列表文件；
– .：指定当前目录为工作目录。

运行上述命令后，会生成一个名为 myapp.pex 的可执行文件。现在，我们可以将这个文件复制到其他机器上运行，而无需单独安装 Python 或者项目依赖。

Python pex 的高级用法

除了基本的打包操作，Python pex 还提供了一些高级用法和选项，以满足不同的需求。下面列举了一些常用的高级用法：

指定入口点

在上述示例中，我们使用了 -m main 参数来指定入口模块为 main.py。实际上，我们也可以使用其他方式来指定入口点，比如指定一个函数作为入口点：

pex --disable-cache -o myapp.pex -c myapp:hello -r requirements.txt .

上述命令中，-c myapp:hello 参数指定了入口点为 myapp 模块的 hello 函数。

指定 Python 解释器版本

通过 -p 参数，我们可以指定打包后的 pex 文件运行的 Python 解释器版本。例如，指定 Python 3.8 版本：

pex --disable-cache -o myapp.pex -m main -r requirements.txt -p /usr/bin/python3.8 .

引入自定义代码

如果我们需要在打包后的 pex 文件中引入一些自定义的代码，可以使用 -e 或者 --entry-point 参数：

pex --disable-cache -o myapp.pex -m main -r requirements.txt -e custom_code.py .

上述命令中，-e custom_code.py 参数指定了引入名为 custom_code.py 的自定义代码文件。

总结

本文介绍了 Python pex 工具及其用法，以及如何打包 Python 可执行文件。Python pex 提供了一个方便的方式来将 Python 项目及其依赖项打包成一个独立的可执行文件，使得部署和分发变得更加简单和可靠。通过简单的命令行操作，我们可以轻松地创建一个包含应用程序代码和依赖库的 pex 文件，并在不同的环境中运行。同时，Python pex 还提供了许多高级用法和选项，可以根据实际需求进行定制。无论是开发还是部署，Python pex 都是一个强大而实用的工具。

如果你想要了解更多关于 Python pex 的用法和选项，请参考官方文档：https://pex.readthedocs.io。