robotframework-obfuscator 0.0.1

Robot Framework Obfuscator

Robot Framework混淆器是一个命令行工具，它可以混淆Robot Framework代码。

安装

可以使用pip安装混淆器

pip install https://github.com/robocorp/robotframework-obfuscator/archive/master.zip

注意，必须也安装依赖项

pip install robotframework pip install robotframework-lsp

依赖项

它依赖于Python 3.8+，Robot Framework 4+和robotframework-lsp 0.29+。

使用方法

安装后，可以使用以下命令运行混淆器：

python -m robotframework_obfuscator --dest <目标目录> <混淆目录>

其中，<目标目录>是混淆后的源代码应放置的目录，而<混淆目录>是需要混淆的源代码所在的目录。

注意，<混淆目录>中的所有文件将被复制到<目标目录>，但只有.robot和.resource文件将被混淆。

如果某些关键字不应被混淆，可以使用--skip-keyword选项进行调用，例如：

python -m robotframework_obfuscator --dest <目标目录> --skip-keyword MyKeyword --skip-keyword AnotherKeyword <混淆目录>

如果某些变量不应被混淆，可以使用--skip-var选项进行调用，例如：

python -m robotframework_obfuscator --dest <目标目录> --skip-var my_var --skip-var AnotherVar <混淆目录>

注意事项

关键字名称和变量名称都将被混淆。如果某个关键字或变量名称以不同的方式被引用（从文件中读取、环境变量等），程序在混淆后可能无法执行，因此建议运行混淆后的程序以验证行为是否仍然相同。

注意，传递给Run Keyword（或来自BuiltIn库的Run的其他运行变体）的关键字名称将正确转换，但如果目标代码有直接调用执行关键字的部分，可能会失败。

可以通过使用--skip-keyword选项不混淆特定的关键字名称来克服这个问题。

此外，如果某些变量作为参数传递给Robot Framework（或通过某些变量文件），可以使用--skip-var选项跳过翻译这些变量。

注意

注意，混淆器可能会使程序运行变慢，因为许多情况下需要为每个关键字运行进行额外的关键字评估 - 一般而言，作为经验法则，需要快速运行的代码应放在Python中，因此不应有很大差异，但如果相关的代码在Robot Framework本身中有太多逻辑，可能会有所不同。

重要

此混淆器目前处于alpha测试阶段。请使用混淆后的版本运行程序，以确保行为仍然相同。