//! Conversion formats use super::*; use std::{ ops::Deref, borrow::Borrow, fmt, error, }; use regex::{ Regex, }; const BASE64_VALIDATE_RE_STR: &'static str = r#"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"#; lazy_static!{ static ref BASE64_CONV_TABLE: smallmap::Map = smallmap![ {'/' => 'ł'}, {'+' => 'þ'}, {'=' => 'ø'}, ]; static ref BASE64_CONV_TABLE_REV: smallmap::Map = BASE64_CONV_TABLE.clone().reverse(); static ref BASE64_VALIDATE_REGEX: Regex = Regex::new(BASE64_VALIDATE_RE_STR).expect("Failed to compile base64 validation regex"); } #[derive(Debug)] pub struct Base64Error(T); impl error::Error for Base64Error where T: AsRef + fmt::Debug{} impl fmt::Display for Base64Error where T: AsRef { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!(f, "invalid base64: {:?}", self.0.as_ref()) } } /// A string of modified base64, appropriate for URL paths etc. #[derive(Debug, Clone, PartialEq, Eq, Hash, PartialOrd, Ord, Serialize, Deserialize)] pub struct ModifiedBase64String(String); impl fmt::Display for ModifiedBase64String { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!(f, "{}", self.0) } } impl ModifiedBase64String { fn from_base64_unchecked(string: &str) -> Self { Self(conv_str(&BASE64_CONV_TABLE, string).collect()) } /// Consume into a normal base64 string pub fn into_base64(self) -> String { conv_char_iter(&BASE64_CONV_TABLE_REV, self.0.chars()).collect() } /// Try to convert a base64 string into a modified base64 string pub fn try_from_base64>(base64: T) -> Result> { let string = base64.as_ref(); if BASE64_VALIDATE_REGEX.is_match(string) { Ok(Self::from_base64_unchecked(string)) } else { Err(Base64Error(base64)) } } /// As a string slice #[inline(always)] pub fn as_str(&self) -> &str { self.0.as_str() } /// Encode from a slice pub fn encode(slice: impl AsRef<[u8]>) -> Self { Self::from_base64_unchecked(base64::encode(slice.as_ref()).as_str()) } /// Consume into decoded bytes, write those bytes into the provided buffer pub fn decode(self, output: &mut Vec) { base64::decode_config_buf(self.into_base64(), base64::STANDARD, output).expect("modified base64 string contained invalid formatted data") } /// Consume into decoded bytes, return those bytes as a new `Vec` pub fn decode_new(self) -> Vec { base64::decode(self.into_base64()).expect("modified base64 string contained invalid formatted data") } } impl Deref for ModifiedBase64String { type Target = str; #[inline] fn deref(&self) -> &Self::Target { self.as_str() } } impl AsRef for ModifiedBase64String { #[inline] fn as_ref(&self) -> &str { self.as_str() } } /// Convert this string with a specified char map. Returns a `char` yielding iterator. #[inline] pub fn conv_str<'a, 'b>(table: &'b smallmap::Map, string: &'a (impl AsRef + ?Sized)) -> CharSubstituteIter<'b, std::str::Chars<'a>> where 'b: 'a { conv_char_iter(table, string.as_ref().chars()) } /// Convert this iterator of chars with this char swapping map #[inline] pub fn conv_char_iter(table: &smallmap::Map, iter: I) -> CharSubstituteIter where I: IntoIterator, T: From + smallmap::Collapse, char: Borrow { iter.replace_chars(table) }