Skip to main content

AST based Obfuscator for Python

Project description

build status pypi python versions twitter twitter


An AST based Python obfuscator that robustly mangles names and other obfuscations of Python code

Current limitations:

  • DOES NOT SUPPORT: Annotations, evals, templated strings, imports of the form import xxx.yyy
  • Very little configuration currently and instead takes a cautious approach in determining what identifiers to mangle. Globals, kwargs, class namespace identifiers, and others are not obfuscated but type of obfuscations should be use selected in the future.
  • It is only tested with Python v3.5 and might not work with other AST versions
  • Scoping for comprehensions are kind of hacky (and basically follows Python 2 comprehension scope leaking methodology)


pip install bobskater


bobskater provides a few mechanisms for direct use.

  • obfuscateString("") obfuscates a string of source code.
  • obfuscateFile('') will obfuscate an entire file and overwrite the original

Both take keyword arguments for configuration:

  • removeDocstrings will remove docstrings by replacing them with pass statements (to handle even cases where a function has only a docstring). Defaults to True
  • obfuscateNames will obfuscate all names except globally scoped variables, kwargs, builtins, and identifiers in a class namespace. Defaults to True

There are no other obfuscations performed than the two mentioned above currently in bobskater


from bobskater import obfuscateString

myFileContents = open('', 'r').read()

#Will obfuscate myFileContents and return it into output. Names will not be mangled, only docstrings will be removed
output = obfuscateString(myFileContents, obfuscateNames=False)



pytest - Runs all the tests


Refer to the python docs on packaging for clarification. Make sure you've updated, and have installed twine, setuptools, and wheel python3 sdist bdist_wheel - Create a source distribution and a binary wheel distribution into dist/ twine upload dist/bobskater-x.x.x* - Upload all dist/ files to PyPI of a given version Make sure to tag the commit you released

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bobskater-0.2.1.tar.gz (9.6 kB view hashes)

Uploaded source

Built Distribution

bobskater-0.2.1-py3-none-any.whl (11.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page