Rename to useCommentsForDescriptions

Author: rideliner

src/main/kotlin/graphql/kickstart/tools/SchemaParserOptions.kt

@@ -33,7 +33,7 @@ data class SchemaParserOptions internal constructor(
     val typeDefinitionFactories: List<TypeDefinitionFactory>,
     val fieldVisibility: GraphqlFieldVisibility?,
     val includeUnusedTypes: Boolean,
-    val commentsAsFallbackDescription: Boolean
+    val useCommentsForDescriptions: Boolean
 ) {
     companion object {
         @JvmStatic
@@ -62,7 +62,7 @@ data class SchemaParserOptions internal constructor(
         private var typeDefinitionFactories: MutableList<TypeDefinitionFactory> = mutableListOf(RelayConnectionFactory())
         private var fieldVisibility: GraphqlFieldVisibility? = null
         private var includeUnusedTypes = false
-        private var commentsAsFallbackDescription = true
+        private var useCommentsForDescriptions = true
 
         fun contextClass(contextClass: Class<*>) = this.apply {
             this.contextClass = contextClass
@@ -140,8 +140,8 @@ data class SchemaParserOptions internal constructor(
             this.includeUnusedTypes = includeUnusedTypes
         }
 
-        fun commentsAsFallbackDescription(commentsAsFallbackDescription: Boolean) = this.apply {
-            this.commentsAsFallbackDescription = commentsAsFallbackDescription
+        fun useCommentsForDescriptions(useCommentsForDescriptions: Boolean) = this.apply {
+            this.useCommentsForDescriptions = useCommentsForDescriptions
         }
 
         @ExperimentalCoroutinesApi
@@ -184,7 +184,7 @@ data class SchemaParserOptions internal constructor(
                 typeDefinitionFactories,
                 fieldVisibility,
                 includeUnusedTypes,
-                commentsAsFallbackDescription
+                useCommentsForDescriptions
             )
         }
     }

src/main/kotlin/graphql/kickstart/tools/util/Utils.kt

@@ -53,9 +53,8 @@ internal val Class<*>.declaredNonProxyMethods: List<JavaMethod>
 internal fun getDocumentation(node: AbstractDescribedNode<*>, options: SchemaParserOptions): String? =
     when {
         node.description != null -> node.description.content
-        !options.commentsAsFallbackDescription -> null
-        node.comments == null -> null
-        node.comments.isEmpty() -> null
+        !options.useCommentsForDescriptions -> null
+        node.comments.isNullOrEmpty() -> null
         else -> node.comments.asSequence()
             .filter { !it.content.startsWith("#") }
             .joinToString("\n") { it.content.trimEnd() }

src/test/kotlin/graphql/kickstart/tools/SchemaParserTest.kt

@@ -575,7 +575,7 @@ class SchemaParserTest {
                 }
                 """)
             .resolvers(object : GraphQLQueryResolver {})
-            .options(SchemaParserOptions.newOptions().commentsAsFallbackDescription(false).allowUnimplementedResolvers(true).build())
+            .options(SchemaParserOptions.newOptions().useCommentsForDescriptions(false).allowUnimplementedResolvers(true).build())
             .build()
             .makeExecutableSchema()