String Obfuscation

Compiletime string literal obfuscation for Rust.

Examples

The obfstr! macro returns a borrowed temporary and may not escape the statement it was used in:

assert_eq!(obfstr::obfstr!("Hello 🌍"), "Hello 🌍");

The obflocal! macro returns the ObfBuffer with the deobfuscated string and is more flexible but less ergonomic:

let str_buf = obfstr::obflocal!("Hello 🌍");
assert_eq!(str_buf.as_str(), "Hello 🌍");

The obfconst! macro returns the encrypted ObfString for use in constant expressions:

static GSTR: obfstr::ObfString<[u8; 10]> = obfstr::obfconst!("Hello 🌍");
assert_eq!(GSTR.deobfuscate(0).as_str(), "Hello 🌍");

The wide! macro provides compile time utf16 string literals:

let expected = &['W' as u16, 'i' as u16, 'd' as u16, 'e' as u16, 0];
assert_eq!(obfstr::wide!("Wide\0"), expected);

The random! macro provides compile time random values:

const RND: i32 = obfstr::random!(u8) as i32;
assert!(RND >= 0 && RND <= 255);

License

Licensed under MIT License, see license.txt.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.