Crate zalgo_codec

This is a crate implementing the zalgo encoding and decoding functions originally written in Python by Scott Conner.

Using the functions defined in this crate you can transform an ASCII string into a unicode string that is a single “character” wide. The encoding is reversible, but this string will be larger than the original in terms of bytes. The crate also provides functions to encode python code and wrap the result in a decoder that decodes and executes the encoded string. This way the file looks very different, but executes the same way as before. This lets you do the mother of all refactoring by converting your entire python program into a single line of code. Can not encode carriage returns, so files written on non-unix operating systems might not work. The file encoding functions will attempt to encode files anyway by ignoring carriage returns.

Explanation:
Characters U+0300–U+036F are the combining characters for unicode Latin. The fun thing about combining characters is that you can add as many of these characters as you like to the original character and it does not create any new symbols, it only adds symbols on top of the character. It’s supposed to be used in order to create characters such as á by taking a normal a and adding another character to give it the mark (U+301, in this case). Fun fact, Unicode doesn’t specify any limit on the number of these characters. Conveniently, this gives us 112 different characters we can map to, which nicely maps to the ASCII character range 0x20 -> 0x7F, aka all the non-control characters. The only issue is that we can’t have new lines in this system, so to fix that, we can simply map 0x7F (DEL) to 0x0A (LF). This can be represented as (CHARACTER - 11) % 133 - 21, and decoded with (CHARACTER + 22) % 133 + 10.
Original post.

Structs

UnencodableCharacterError

The error returned by the encoding functions if they encounter a character they can not encode. Contains a string that references which type of character and which line caused the error.

Functions

encode_file

Encodes the contents of the file and stores the result in another file. If carriage return characters are found it will print a message and attempt to encode the file anyway by ignoring them.

encode_python_file

Encodes the contents of the given file and stores the result wrapped in a decoder in another file. This file will still work the same as the original python code. If the source file contains carriage return characters this function will print a message and then attempt to encode the file anyway by ignoring them.

zalgo_decode

Takes in a string that was compressed by zalgo_encode and decompresses it to an ASCII string.

zalgo_encode

Takes in an ASCII string and “compresses” it to zalgo text using a reversible encoding scheme. The resulting string should only take up a single character space horizontally when displayed (though this can vary between platforms depending on how they deal with unicode). The resulting string will be larger than the original in terms of bytes, but it can be decompressed to recover the original string using zalgo_decode.

zalgo_encode_python

zalgo-encodes an ASCII string containing python code and wraps it in a decoder that decodes and executes it.