unpy2exe 项目技术文档

1. 安装指南

1.1 通过 PyPI 安装

你可以通过 PyPI 安装 unpy2exe，使用以下命令：

pip install unpy2exe

1.2 从源码安装

如果你想从源码安装 unpy2exe，首先需要确保你已经安装了以下依赖项：

• pefile
• six
• argparse（仅适用于 Python 2.7 以下版本）

你可以通过以下命令安装这些依赖项：

pip install -r requirements.txt

安装依赖项后，你可以从源码安装 unpy2exe。

2. 项目的使用说明

unpy2exe 是一个用于从 py2exe 生成的可执行文件中提取 .pyc 文件的工具。以下是使用 unpy2exe 的基本命令：

unpy2exe [-h] [-o OUTPUT_DIR] [-p PYTHON_VERSION] filename

参数说明

• filename: 必需参数，指定要提取的 py2exe 可执行文件。
• -o OUTPUT_DIR, --output-dir OUTPUT_DIR: 可选参数，指定输出目录，默认为当前目录。
• -p PYTHON_VERSION, --python-version PYTHON_VERSION: 可选参数，指定 .pyc 文件的 Python 版本。
• -v, --verbose: 可选参数，启用详细输出。

示例

假设你有一个名为 example.exe 的 py2exe 可执行文件，你可以使用以下命令提取 .pyc 文件：

unpy2exe example.exe -o output_dir -p 3.8

这将会把 example.exe 中的 .pyc 文件提取到 output_dir 目录中，并指定 Python 版本为 3.8。

3. 项目 API 使用文档

unpy2exe 提供了一个简单的命令行接口，没有复杂的 API。你可以通过命令行参数来控制提取过程。

主要功能

• 提取 .pyc 文件: 从 py2exe 生成的可执行文件中提取 .pyc 文件。
• 指定输出目录: 通过 -o 参数指定 .pyc 文件的输出目录。
• 指定 Python 版本: 通过 -p 参数指定 .pyc 文件的 Python 版本。
• 详细输出: 通过 -v 参数启用详细输出，便于调试。

4. 项目安装方式

4.1 通过 PyPI 安装

这是最简单的安装方式，适用于大多数用户。只需运行以下命令：

pip install unpy2exe

4.2 从源码安装

如果你需要从源码安装 unpy2exe，请按照以下步骤操作：

1. 克隆或下载 unpy2exe 的源码。

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 安装 unpy2exe：

   python setup.py install
   

注意事项

• 对于使用 Python 2.x 生成的 .exe 文件，你需要使用 Python 2.x 运行 unpy2exe；对于使用 Python 3.x 生成的 .exe 文件，你需要使用 Python 3.x 运行 unpy2exe。
• 为了能够运行提取的 .pyc 文件，你需要使用与生成 .exe 文件相同的 Python 版本，或者至少是相同的主版本。

总结

unpy2exe 是一个简单但非常有用的工具，能够帮助开发者从 py2exe 生成的可执行文件中提取 .pyc 文件。通过本文档，你应该能够轻松安装并使用 unpy2exe，并了解其基本功能和注意事项。