Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

PyMangler contains a pure-python "encryption" scheme that can be used to *obfuscate* and *disguise* data in situations where strong encryption is not available,and security is not necessarily top priority.

Project description

PyMangler for Python 3

PyMangler contains a pure-python3 "encryption" scheme that can be used to obfuscate and disguise data in situations where strong encryption is not available, and security is not necessarily top priority. It is fairly fast but large amounts of data takes time. Files can be encrypted if the file data is encoded to base64 before encrypting but it's too slow to be useful.

This was written as a "proof of concept" because I was wondering if I could come up with an encryption scheme that

A.) Didn't produce repeating patterns

B.) Could withstand a frequency analysis attack

Install

pip3 install PyMangler

Setup

The key file that comes with PyMangler will work, but you should generate a new key by running the keygen.py file. You should see the following text and a file named key will be generated:

Generating key...
Key generated.
Validating key for prosperity...
Key is valid.  Encryptor working successfully!

Key validation from the built in key generator should realistically never fail, but it's validated anyway.

PyMangler's encryption algorithm was designed to give a fairly flat distribution frequency, and repeating patterns in pre-encrypted text does not generate repeating patterns in the cipher-text unless you were to repeat the same characters an abnormal amount of times in the pre-encrypted text.

hello hello hello hello hello hello hello hello
̬ĮʀÀ
(ŬNJ–ɢʷMfDZċǚϺ-éȼ˭̕ȿïɐDžƹ{əʺ?ʙ?ΦΑțϾɚɛ͜ǙʡƽǛť

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
ΧϬʸΟϫ«™͚ǣϱȐ˩ȍ?3͜p̚ĺ̒bĘʇɅ͋Ƚďɏ͛ʬƥƏƼʌˢ͊ǝͅ#ȇƄƩŨ϶Ǖ³¾

Usage

from PyMangler.mangle import Encryptor

# The Encryptor class will generate a key to use
# on instantiation. Save your key file or else
# you won't be able to recover encrypted data.

e = Encryptor()
e.save_key_file(filepath='/Path/To/Key/File')
# once you save a key file you wouldn't want to 
# overwrite it so make sure you create a key
# generator or use the one provided.

# You can load the key file you saved.
e.load_key_file(filepath='/Path/To/Key/File')

# If you don't like PyManglers key contruction 
# methods you can use the make_key method to 
# create your own. Just pass a list of random
# characters and Encryptor will number each 
# character starting from 1.
e.make_key(['d', 'c', 'b', 'e', 'g', 'a', 'f'])

# if you want Encryptor to randomize your
# key for you, use make_randomized_key.
e.make_randomized_key(['a', 'b', 'c', 'd', 'e', 'f', 'g']) 

# Using either make_key or make_randomized_key
# will make Encryptor use your given characters

# Calling Encryptor.save_key_file will save your
# created key to a file that can be loaded later.

Project details


Download files

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

Files for PyMangler, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size PyMangler-0.0.2-py3-none-any.whl (5.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size PyMangler-0.0.2.tar.gz (4.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page