marsupial

a rust wrapper for xkcp/k12, derived entirely from oconnor663/kangarootwelve_xkcp.rs

the only differences are:

• updated crate dependencies
• updated xkcp/k12
• the removal of k12sum
• changed branding
• benchmarks modified to use the criterion crate to allow benchmarking on stable rust
• doesn't need bindgen installed system-wide

usage

in order to use the crate, you need:

• a c compiler
• rust
• gnuplot (if you want plot generation when benchmarking)

then, just add a dependency upon the marsupial crate in Cargo.toml, and then you can use it like this:

use marsupial::Hasher;

// hash an input all at once
let hash1 = marsupial::hash(b"foobarbaz");

// hash an input incrementally
let mut hasher = Hasher::new();
hasher.update(b"foo");
hasher.update(b"bar");
hasher.update(b"baz");
let hash2 = hasher.finalize();
assert_eq!(hash1, hash2);

// extended output. `OutputReader` also implements `Read`
let mut hasher = Hasher::new();
hasher.update(b"foobarbaz");
let mut output_reader = hasher.finalize_xof();
let mut output = [0; 1000];
output_reader.squeeze(&mut output);
assert_eq!(&output[..32], hash1.as_bytes());

// emit the hash as hexadecimal
println!("{}", hash1.to_hex());

license

as is with kangarootwelve_xkcp.rs, all of the rust wrapping code is dedicated to the public domain via cc0. the vendored xkcp code is covered by a mixture of licenses