tmpl-resolver 0.0.14

A lightweight template resolution engine with conditional logic support
Documentation
pub(crate) use bincode::config::standard as bincode_std_cfg;
use tap::Pipe;

use crate::{TemplateResolver, error::ResolverResult};

impl TemplateResolver {
  /// Decodes binary data into TemplateResolver using bincode's optimized
  /// deserialization.
  ///
  /// ## Input
  ///
  /// - `slice` - Binary input slice containing serialized TemplateResolver data
  ///
  /// ## Output
  ///
  /// - A tuple of (deserialized TemplateResolver, amount of bytes read) on
  ///   success
  /// - Error details if deserialization fails
  ///
  /// See also: [bincode::serde::decode_from_slice]
  pub fn decode_bin_from_slice(slice: &[u8]) -> ResolverResult<(Self, usize)> {
    bincode::serde::decode_from_slice(slice, bincode_std_cfg())?.pipe(Ok)
  }

  /// Encodes the Self(TemplateResolver) into a binary format stored in a
  /// [`Vec<u8>`].
  ///
  /// ## Example
  ///
  /// ```
  /// use tmpl_resolver::TemplateResolver;
  ///
  /// let res: TemplateResolver =
  ///   [("🐱", "喵 ฅ(°ω°ฅ)"), ("hello", "{🐱}")].try_into()?;
  ///
  /// let _data = res.encode_bin_to_vec()?;
  ///
  /// # Ok::<(), tmpl_resolver::error::ResolverError>(())
  /// ```
  ///
  /// See also: [bincode::serde::encode_to_vec]
  pub fn encode_bin_to_vec(&self) -> ResolverResult<alloc::vec::Vec<u8>> {
    bincode::serde::encode_to_vec(self, bincode_std_cfg())?.pipe(Ok)
  }
}

#[cfg(test)]
mod tests {
  use super::*;

  /// - release: 1.542µs
  /// - debug: 7.375µs
  #[test]
  #[ignore]
  #[cfg(feature = "std")]
  fn bench_encode_bin() -> ResolverResult<()> {
    use testutils::simple_benchmark;

    // use tmpl_resolver::TemplateResolver;
    use crate::TemplateResolver;
    let res: TemplateResolver =
      [("🐱", "喵 ฅ(°ω°ฅ)"), ("hello", "{🐱}")].try_into()?;

    simple_benchmark(|| res.encode_bin_to_vec());

    let _data = res.encode_bin_to_vec()?;

    // println!("{}", data.capacity());
    // dbg!(data);

    Ok(())
  }
}