Crate base91[−][src]
Expand description
Joachim Henke’s basE91 encoding implementation for Rust.
Also supports xml-friendly base91 implementation by r-lyeh, which supports quoting and is JSON, XML and TSV friendly.
Library features
- no_std
- Encode/Decode iterators
- Canonical (Joachim Hanke) implementation
- Alternative XML, JSON and TSV friendly (r-lyeh) implementation
Examples
Using helpers
let source = "This is a random binary string";
let encode_as_vec: Vec<u8> = base91::slice_encode(source.as_bytes());
let decode_as_vec: Vec<u8> = base91::slice_decode(&encode_as_vec);
assert_eq!(
"nX,<:WRT%yxtYQ:mbr4JB*H[LR/@Qj{o0aU=Z",
String::from_utf8_lossy(&encode_as_vec)
);
assert_eq!(
"This is a random binary string",
String::from_utf8_lossy(&decode_as_vec)
);Using Iterators
let source = "This is a random binary string";
let as_vec: Vec<u8> = base91::EncodeIterator::new(source.bytes()).collect();
let as_str: String = base91::EncodeIterator::new(source.bytes()).as_char_iter().collect();
assert_eq!(
"nX,<:WRT%yxtYQ:mbr4JB*H[LR/@Qj{o0aU=Z",
String::from_utf8_lossy(&as_vec)
);
assert_eq!(
"nX,<:WRT%yxtYQ:mbr4JB*H[LR/@Qj{o0aU=Z",
as_str
);Using Xml Friendly or another specific variation
Warning!
If you disable the feature canonical and enable the feature xml-friendly, then
base91::EncodeIterator and base91::DecodeIterator will silently use XmlFriendly variant.
In turn, all the helper functions use the iterators internally (slice_encode and slice_decode).
use base91::iter::{EncodeGenericIterator, DecodeGenericIterator};
use base91::codemap::XmlFriendly;
let source = "This is a random binary string";
let encode_as_vec: Vec<u8> = EncodeGenericIterator::<XmlFriendly, _>::new(source.bytes()).collect();
let decode_as_vec: Vec<u8> = DecodeGenericIterator::<XmlFriendly, _>::new(encode_as_vec.iter().copied()).collect();
assert_eq!(
"nX,-:WRT%yxtYQ:mbr4JB*H[LR/@Qj{o0aU=Z",
String::from_utf8_lossy(&encode_as_vec)
);
assert_eq!(
"This is a random binary string",
String::from_utf8_lossy(&decode_as_vec)
);