PyArmor’s Documentation

Version:PyArmor 5.1 Homepage:http://pyarmor.dashingsoft.com/ Contact:jondy.zhao@gmail.com Authors:Jondy Zhao Copyright:This document has been placed in the public domain.

PyArmor is a command line tool used to obfuscate python scripts, bind obfuscated scripts to fixed machine or expire obfuscated scripts. It protects Python scripts by the following ways:

• Obfuscate code object to protect constants and literal strings.
• Obfuscate co_code of each function (code object) in runtime.
• Clear f_locals of frame as soon as code object completed execution.
• Verify the license file of obfuscated scripts while running it.

PyArmor supports Python 2.6, 2.7 and Python 3.

PyArmor is tested against Windows, Mac OS X, and Linux.

PyArmor has been used successfully with FreeBSD and embedded platform such as Raspberry Pi, Banana Pi, Orange Pi, TS-4600 / TS-7600 etc. but is not fullly tested against them.

Contents:

• Installation
  • Verifying the installation
  • Installed commands
• Using PyArmor
  • Obfuscating Python Scripts
  • Distributing Obfuscated Scripts
  • Generating License For Obfuscated Scripts
  • Extending License Type
  • Packing Obfuscated Scripts
• Runtime Module pytransform
  • Contents
  • Examples
• The Security of PyArmor
  • Cross Protection for _pytransform
• Understanding Obfuscated Scripts
  • Global Capsule
  • Obfuscated Scripts
  • Bootstrap Code
  • Runtime Files
  • The license.lic
  • Running Obfuscated Scripts
  • Key Points to Use Obfuscated Scripts
  • Two types of license.lic
• How PyArmor Does It
  • How to Obfuscate Python Scripts
  • How to Run Obfuscated Script
  • Special Handling of Entry Script
• How To Pack Obfuscated Scripts
  • Work with PyInstaller
  • Work with py2exe
  • Work with cx_Freeze 5
• Using Project
  • Managing Obfuscated Scripts With Project
  • Obfuscating Scripts With Different Modes
  • Project Configuration File
• The Differences of Obfuscated Scripts
• Advanced Topics
  • Obfuscating Python Scripts In Different Modes
  • Restrict Mode
• Man Page
  • obfuscate
  • licenses
  • pack
  • hdinfo
• When Things Go Wrong
  • Segment fault
  • Could not find _pytransform
  • The license.lic generated doesn’t work
  • NameError: name ‘__pyarmor__’ is not defined
  • Marshal loads failed when running xxx.py
  • _pytransform can not be loaded twice
  • Check restrict mode failed
• License
  • Purchase

Indices and tables

• Index
• Module Index
• Search Page