FIX #25 Add more documentation and a test for nested types (#28)

src/main/scala/rocks/muki/graphql/codegen/ApolloSourceGenerator.scala

@@ -37,7 +37,9 @@ case class ApolloSourceGenerator(fileName: String,
       val typeName = Term.Name(
         operation.name.getOrElse(throw new IllegalArgumentException(
           "Anonymous operations are not support")))
-      // TODO input variables can be recursive. Generate case classes along
+
+      // input variables require "input types", which are generated separately and are
+      // available for all operations provided by the given document.
       val inputParams = generateFieldParams(operation.variables, List.empty)
       val dataParams =
         generateFieldParams(operation.selection.fields, List.empty)

src/test/resources/apollo/blog/AddArticle.graphql

@@ -0,0 +1,6 @@
+mutation addArticle($content: ArticleContent!) {
+  addArticle(content: $content) {
+    id
+    title
+  }
+}

src/test/resources/apollo/blog/AddArticle.scala

@@ -0,0 +1,18 @@
+import com.example.GraphQLQuery
+import sangria.macros._
+object AddArticle {
+  object addArticle extends GraphQLQuery {
+    val Document = graphql"""mutation addArticle($$content: ArticleContent!) {
+  addArticle(content: $$content) {
+    id
+    title
+  }
+}"""
+    case class Variables(content: ArticleContent)
+    case class Data(addArticle: AddArticle)
+    case class AddArticle(id: ID, title: String)
+  }
+  case class ArticleAuthor(id: ID)
+  case class ArticleContent(title: String, body: String, tags: Option[List[String]], author: ArticleAuthor)
+  type ID = String
+}

src/test/resources/apollo/blog/schema.graphql

@@ -67,8 +67,13 @@ type Mutation {
   publishArticle(id: ID!): Article!
 }
 
+input ArticleAuthor {
+  id: ID!
+}
+
 input ArticleContent {
   title: String!
   body: String!
   tags: [String!]
+  author: ArticleAuthor!
 }