pcode2code 项目使用教程

1. 项目目录结构及介绍

pcode2code 项目是一个基于 Python 的 VBA p-code 反编译工具。项目的目录结构如下：

• pcode2code/：项目主目录，包含所有的 Python 脚本和配置文件。
  • pcode2code.py：项目的主要脚本文件，用于执行 p-code 的反编译操作。
  • tests/：测试目录，包含用于验证项目功能的测试脚本。
  • LICENSE：项目许可证文件。
  • MANIFEST.in：项目打包文件列表。
  • README.md：项目说明文件。
  • setup.cfg：项目设置配置文件。
  • setup.py：项目安装脚本。

2. 项目的启动文件介绍

项目的启动文件是 pcode2code.py。这个文件包含了项目的主要功能，可以通过命令行接口（CLI）使用。当你运行以下命令时：

python pcode2code.py [选项] [输入文件]

该脚本会读取输入文件，执行反编译操作，并将结果输出到标准输出或指定的输出文件中。

以下是 pcode2code.py 支持的一些命令行选项：

• -h, --help：显示帮助信息。
• -v, --version：显示脚本版本。
• -n, --linenum：在输出中包含行号。
• -p, --pcodedump：指定输入文件是 pcodedmp 的转储文件。
• -o OUTFILE, --output OUTFILE：将结果保存到指定的输出文件。
• -d, --debug：开启调试模式。

3. 项目的配置文件介绍

项目的配置文件是 setup.cfg，它包含了项目的基本信息和安装时的配置。这个文件通常用于定义项目的元数据和依赖关系，例如：

[metadata]
name = pcode2code
version = 0.1.0
author = Big5-sec
author_email = [e-mail]
description = A VBA p-code decompiler
long_description = File: README.md
...
[options]
packages = find:
...

这个配置文件在安装项目时会自动读取，以确定如何安装和配置项目。

在开始使用 pcode2code 前，确保你已经安装了所有必需的依赖，并且按照 README.md 文件中的说明进行了正确的设置。