An obfuscator for Robot Framework code
Robot Framework Obfuscator
The Robot Framework obfuscator is a command line tool which can obfuscate Robot Framework code.
pip can be used to install the obfuscator:
pip install https://github.com/robocorp/robotframework-obfuscator/archive/master.zip
Note that dependencies must also be installed:
pip install robotframework
pip install robotframework-lsp
It depends on
Robot Framework 4+ and
After installing it, it's possible to run the obfuscator with:
python -m robotframework_obfuscator --dest <dest-dir> <dir-to-obfuscate>
<dest-dir> is the directory where the obfuscated sources should be put and
<dir-to-obfuscate> is the directory with the sources to obfuscate.
Note that all files from the
<dir-to-obfuscate> will be copied to the
.resource files will be obfuscated.
If some keyword should not be obfuscated, it's possible to use the
--skip-keyword option to make a call such as:
python -m robotframework_obfuscator --dest <dest-dir> --skip-keyword MyKeyword --skip-keyword AnotherKeyword <dir-to-obfuscate>
If some variable should not be obfuscated, it's possible to use the
--skip-var option to make a call such as:
python -m robotframework_obfuscator --dest <dest-dir> --skip-var my_var --skip-var AnotherVar <dir-to-obfuscate>
Both keyword names and variable names will be obfuscated. If a given keyword or variable name was referenced in a different way (read from a file, environment variable, etc.), it's possible that the program may fail to execute afterwards, thus, it's suggested that the obfuscated version of the program is run to verify that the behavior is still the same.
Note that keyword names passed to
Run Keyword (or other run variants of the
BuiltIn library) are properly translated, but if the target code has
a some direct call to run a keyword, it may fail.
It's possible to overcome this by not obfuscating a specific keyword name
Also note that if some variable is passed as a parameter to Robot Framework
(or through some variables file), it's possible to use the
to skip translating those variables.
Note that the obfuscator may make your program run slower as in many cases an additional keyword evaluation may be needed for each keyword run -- in general, as a rule of thumb, code that need to be fast, should be in Python, so, it shouldn't make much difference, but if the related code has too much logic leveraged in Robot Framework itself, it may make a difference.
This obfuscator is currently in alpha mode. Please run your program with the obfuscated version to make sure that the behavior is still the same.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for robotframework-obfuscator-0.0.1.tar.gz
Hashes for robotframework_obfuscator-0.0.1-py2.py3-none-any.whl