2 unstable releases

0.2.0 Jul 13, 2024
0.1.0 Jun 8, 2024

#20 in #mechanism

MIT license

185KB
3K SLoC

Module :: format_tools

experimental rust-status docs.rs Open in Gitpod discord

Collection of mechanisms for formatting and serialization into string.

Basic use-case

Using the to_string_with_fallback macro to convert values to strings with a primary and fallback formatting method.

fn main()
{
  // Import necessary traits and the macro from the `format_tools` crate.
  use core::fmt;
  use format_tools::
  {
    WithDebug,
    WithDisplay,
    to_string_with_fallback,
  };

  // Define a struct that implements both Debug and Display traits.
  struct Both;

  // Implement the Debug trait for the Both struct.
  impl fmt::Debug for Both
  {
    fn fmt( &self, f : &mut fmt::Formatter< '_ > ) -> fmt::Result
    {
      write!( f, "This is debug" )
    }
  }

  // Implement the Display trait for the Both struct.
  impl fmt::Display for Both
  {
    fn fmt( &self, f : &mut fmt::Formatter< '_ > ) -> fmt::Result
    {
      write!( f, "This is display" )
    }
  }

  // Define a struct that implements only the Debug trait.
  struct OnlyDebug;

  // Implement the Debug trait for the OnlyDebug struct.
  impl fmt::Debug for OnlyDebug
  {
    fn fmt( &self, f : &mut fmt::Formatter< '_ > ) -> fmt::Result
    {
      write!( f, "This is debug" )
    }
  }

  // Example usage: Using Both which implements both Debug and Display.
  let src = Both;
  // Convert the struct to a string using `to_string_with_fallback` macro.
  // The primary formatting method WithDisplay is used.
  let got = to_string_with_fallback!( WithDisplay, WithDebug, &src );
  let exp = "This is display".to_string();
  // Assert that the result matches the expected value.
  assert_eq!( got, exp );

  // Example usage: Using OnlyDebug which implements only Debug.
  let src = OnlyDebug;
  // Convert the struct to a string using `to_string_with_fallback` macro.
  // The primary formatting method WithDisplay is not available, so the fallback WithDebug is used.
  let got = to_string_with_fallback!( WithDisplay, WithDebug, &src );
  let exp = "This is debug".to_string();
  // Assert that the result matches the expected value.
  assert_eq!( got, exp );

}

To add to your project

cargo add format_tools

Try out from the repository

git clone https://github.com/Wandalen/wTools
cd wTools
cd examples/foramt_tools_trivial
cargo run

Dependencies

~2MB
~42K SLoC