Document macros, store owned content in builders, implement Debug

crates/rome_formatter/src/arguments.rs

@@ -1,5 +1,5 @@
 use super::{Buffer, Format, Formatter};
-use crate::FormatResult;
+use crate::{FormatOptions, FormatResult, Formatted};
 use std::ffi::c_void;
 use std::marker::PhantomData;
 
@@ -97,16 +97,25 @@ impl<O> Format<O> for Arguments<'_, O> {
     }
 }
 
+impl<Context> std::fmt::Debug for Arguments<'_, Context>
+where
+    Context: Default + FormatOptions,
+{
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        match crate::format!(Context::default(), [self]) {
+            Ok(formatted) => Formatted::fmt(&formatted, f),
+            Err(err) => std::write!(f, "Err({err})"),
+        }
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use crate::prelude::*;
     use crate::{format_args, write, FormatState, VecBuffer};
 
     #[test]
     fn test_nesting() {
-        std::format_args!("test {}", "a");
-        // Format_arguments not very useful, but I guess the same as normal format_args
-
         let mut context = FormatState::new(());
         let mut buffer = VecBuffer::new(&mut context);
 
@@ -117,7 +126,7 @@ mod tests {
                 space_token(),
                 token("a"),
                 space_token(),
-                group_elements(&format_args!(token("("), token(")")))
+                group_elements(format_args!(token("("), token(")")))
             ]
         )
         .unwrap();