support comments in args

graphqxl_synthesizer/src/synth_arguments.rs

@@ -1,17 +1,19 @@
+use crate::synth_description::DescriptionSynth;
 use crate::synth_directive::DirectiveSynth;
 use crate::synth_identifier::IdentifierSynth;
 use crate::synth_value_data::ValueDataSynth;
 use crate::synth_value_type::ValueTypeSynth;
 use crate::synths::{
-    ChainSynth, MultilineListSynth, OneLineListSynth, StringSynth, Synth, SynthContext,
+    ChainSynth, MultilineListSynth, OneLineListSynth, PairSynth, StringSynth, Synth, SynthContext,
 };
 use graphqxl_parser::{Argument, ArgumentDefaultValue};
 
 pub(crate) struct ArgumentsSynth(pub(crate) Vec<Argument>);
 
 impl Synth for ArgumentsSynth {
     fn synth(&self, context: &mut SynthContext) -> bool {
-        let inner_synths = self
+        let mut at_least_one_description = false;
+        let inner_synths: Vec<Box<dyn Synth>> = self
             .0
             .iter()
             .map(|argument| {
@@ -31,11 +33,21 @@ impl Synth for ArgumentsSynth {
                     v.push(Box::new(StringSynth::from(" ")));
                     v.push(Box::new(DirectiveSynth(directive.clone())));
                 }
-                ChainSynth(v)
+
+                if !argument.description.is_empty() {
+                    at_least_one_description = true;
+                    Box::new(PairSynth {
+                        first: DescriptionSynth::text(&argument.description),
+                        last: ChainSynth(v),
+                        line_jump_sep: true,
+                    })
+                } else {
+                    Box::new(ChainSynth(v)) as Box<dyn Synth>
+                }
             })
             .collect();
 
-        if self.0.len() > context.config.max_one_line_args {
+        if self.0.len() > context.config.max_one_line_args || at_least_one_description {
             MultilineListSynth::no_suffix(("(", inner_synths, ")")).synth(context);
         } else {
             OneLineListSynth::comma(("(", inner_synths, ")")).synth(context);

graphqxl_synthesizer/src/synths/synth_context.rs

@@ -94,6 +94,12 @@ pub(crate) trait Synth {
     }
 }
 
+impl Synth for Box<dyn Synth> {
+    fn synth(&self, context: &mut SynthContext) -> bool {
+        self.as_ref().synth(context)
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;

src/test/comments-in-args.graphqxl

@@ -0,0 +1,14 @@
+type Query {
+  "Comment on foo"
+  foo(
+    "Comment on bar"
+    bar: String
+    baz: Int
+    """
+    multiline comment
+
+    bar_baz
+    """
+    bar_baz: Boolean
+  ): [String!]!
+}

src/test/comments-in-args.graphqxl.result

@@ -0,0 +1,15 @@
+type Query {
+  "Comment on foo"
+  foo(
+    "Comment on bar"
+    bar: String
+    baz: Int
+    """
+    multiline comment
+
+    bar_baz
+    """
+    bar_baz: Boolean
+  ): [String!]!
+}
+