#items #slice #compatible #permute #permutation #permute-key #unpredictable

no-std libpermute

A no_std compatible library that provides a function to permute the items of a slice

2 stable releases

1.0.1 Nov 23, 2021
1.0.0 Nov 17, 2021

#2095 in Algorithms

MIT/Apache

14KB
134 lines

libpermute

Crates.io Documentation

libpermute is a no_std compatible library that provides a function to permute the items of a slice.

libpermute offers a few main features:

  1. Stability. The permutation algorithm won't be changed without a major version bump.

  2. Re-implementability. It should be relatively straightforward to re-implement the algorithm this library uses in another library or in another language.

  3. Strength. Given an unpredictable permute_key, the permutation should also be unpredictable - assuming that no one breaks the Sha-256 or ChaChar20 algorithms.

Example

use libpermute::permute;

fn main() {
    const KEY: &'static [u8] = &[0, 1, 2, 3, 4, 5, 6, 7];
    const INPUT: &str = "Hello World!";

    let mut buff = [0u8; INPUT.len()];
    buff.copy_from_slice(INPUT.as_bytes());

    permute(KEY, &mut buff);

    println!("RESULT: '{}'", std::str::from_utf8(&buff).unwrap());
}

No_std

No_std mode may be activated by disabling the "std" feature.

License

This project is licensed under either of

at your option.

Dependencies

~695KB
~14K SLoC