1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153
//! This crate lets you convert an ASCII text string into a single unicode grapheme cluster and back.
//! It also provides a procedural macro that lets you embed such a grapheme cluster and decode it into source code at compile time.
//! This lets you reach new lows in the field of self-documenting code.
//!
//! The encoded string will be ~2 times larger than the original in terms of bytes.
//!
//! A small program that lets you use the functions in the crate on text and files is included in the source repository and can be installed with
//! `cargo install zalgo-codec --features binary`.
//!
//! Additionally the crate provides a function to encode Python code and wrap the result in a decoder that
//! decodes and executes the encoded string, retaining the functionality of the original code.
//!
//! There are two ways of interacting with the codec.
//! The first one is to call the encoding and decoding functions directly,
//! and the second one is to use the [`ZalgoString`] wrapper type.
//!
//! # Example
//! The cursed character is the result of using [`zalgo_encode`] on the text `fn add(x: i32, y: i32) -> i32 {x + y}`.
//! ```
//! # use zalgo_codec::zalgo_embed;
//! // We can add that text to our code with the macro
//! zalgo_embed!("E͎͉͙͉̞͉͙͆̀́̈́̈́̈̀̓̒̌̀̀̓̒̉̀̍̀̓̒̀͛̀̋̀͘̚̚͘͝");
//!
//! // The `add` function is now available
//! assert_eq!(add(10, 20), 30);
//! ```
//!
//! # 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`.
pub use zalgo_codec_common::{
zalgo_decode, zalgo_encode, zalgo_string, zalgo_wrap_python, Error, ZalgoString,
};
#[cfg(feature = "macro")]
pub use zalgo_codec_macro::zalgo_embed;
#[cfg(test)]
mod tests {
use super::*;
use rand::{
distributions::{DistString, Distribution},
seq::SliceRandom,
Rng,
};
use std::str;
use unicode_segmentation::UnicodeSegmentation;
struct PrintableAsciiAndNewline;
impl Distribution<char> for PrintableAsciiAndNewline {
fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> char {
*b" !\"#$%&'()*,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVXYZ[\\]^_`abcdefghijklmnopqrstuvxyz{|}~\n".choose(rng).unwrap() as char
}
}
impl DistString for PrintableAsciiAndNewline {
fn append_string<R: Rng + ?Sized>(&self, rng: &mut R, string: &mut String, len: usize) {
string.reserve(len);
for _ in 0..len {
string.push(self.sample(rng));
}
}
}
#[cfg(feature = "macro")]
#[test]
fn test_embed_function() {
let code = "fn add(x: i32, y: i32) -> i32 {x + y}";
let encoded = zalgo_encode(code).unwrap();
assert_eq!(encoded, "E͎͉͙͉̞͉͙͆̀́̈́̈́̈̀̓̒̌̀̀̓̒̉̀̍̀̓̒̀͛̀̋̀͘̚̚͘͝");
zalgo_embed!("E͎͉͙͉̞͉͙͆̀́̈́̈́̈̀̓̒̌̀̀̓̒̉̀̍̀̓̒̀͛̀̋̀͘̚̚͘͝");
// Now the `add` function is available
assert_eq!(add(10, 20), 30)
}
#[cfg(feature = "macro")]
#[test]
fn test_embed_expression() {
let x = 20;
let y = -10;
let expr = "x + y";
let encoded = zalgo_encode(expr).unwrap();
println!("{}", encoded);
assert_eq!(encoded, "È͙̋̀͘");
// It works on expressions, too!
let z = zalgo_embed!("È͙̋̀͘");
assert_eq!(z, x + y);
}
#[test]
fn verify() {
const TEST_STRING_1: &str = "the greatest adventure is going to bed";
let out_string = str::from_utf8(b"E\xcd\x94\xcd\x88\xcd\x85\xcc\x80\xcd\x87\xcd\x92\xcd\x85\xcd\x81\xcd\x94\xcd\x85\xcd\x93\xcd\x94\xcc\x80\xcd\x81\xcd\x84\xcd\x96\xcd\x85\xcd\x8e\xcd\x94\xcd\x95\xcd\x92\xcd\x85\xcc\x80\xcd\x89\xcd\x93\xcc\x80\xcd\x87\xcd\x8f\xcd\x89\xcd\x8e\xcd\x87\xcc\x80\xcd\x94\xcd\x8f\xcc\x80\xcd\x82\xcd\x85\xcd\x84").unwrap();
assert_eq!(zalgo_encode(TEST_STRING_1).unwrap(), out_string);
const TEST_STRING_2: &str =
"I'll have you know I graduated top of my class in the Navy Seals";
assert_eq!(
zalgo_decode(&zalgo_encode(TEST_STRING_2).unwrap()).unwrap(),
TEST_STRING_2
);
const ASCII_CHAR_TABLE: &str = r##"ABCDEFGHIJKLMNOPQRSTUVXYZabcdefghijklmnopqrstuvxyz1234567890 !"#$%&'()*+,-\./:;<=>?@"##;
assert_eq!(
zalgo_decode(&zalgo_encode(ASCII_CHAR_TABLE).unwrap()).unwrap(),
ASCII_CHAR_TABLE
);
println!("Checking that randomly generated alphanumeric strings are encoded in a lossless fashion, and that they contain a single grapheme cluster");
for _ in 0..100 {
let s = PrintableAsciiAndNewline.sample_string(&mut rand::thread_rng(), 100);
let encoded = zalgo_encode(&s).unwrap();
assert_eq!(zalgo_decode(&encoded).unwrap(), s);
assert_eq!(encoded.as_str().graphemes(true).count(), 1)
}
}
#[test]
fn newlines() {
assert_eq!(&zalgo_encode("\n").unwrap(), "Eͯ",);
const TEST_STRING: &str = "The next sentence is true.\nThe previous sentence is false.";
assert_eq!(
zalgo_decode(&zalgo_encode(TEST_STRING).unwrap()).unwrap(),
TEST_STRING,
);
}
#[test]
fn check_errors() {
assert!(zalgo_encode("We got the Ä Ö Å, you aint got the Ä Ö Å").is_err());
assert!(zalgo_encode("\t").is_err());
assert!(zalgo_encode("\r").is_err());
assert!(zalgo_encode("\0").is_err());
}
}