graphql-introspection

Kotlin Multi-platform GraphQL introspection models and utilities.

With a GraphQL API, it's common to have a schema.json file, which is a JSON representation of a GraphQL Schema, so that Kotlin code can be generated, as the apollo-android library does.

Sometimes we need to access this schema.json file for processing or our own code generators. This library provides a Kotlin type representation of the schema.json file which can easily be obtained from the JSON String using the kotlinx serialization library.

Obtaining an IntrospectionSchema object from a JSON String

```kotlin val schema = IntrospectionSchema.fromJsonString(jsonString)

schema.types.forEach { ... } ```

Convenient GraphQL Introspection Query

This can be used to query a GraphQL API and obtain the result whose data field can be used as an IntrospectionSchemaData object. kotlin val query = IntrospectionQuery.getIntrospectionQueryString()

Processing Schema Types

Note: This requires the graphql-introspection-processor dependency. ```kotlin class MyTypeProcessor : IntrospectionSchemaTypeProcessor {

fun process(type: Type, typeMap: Map<String, Type>): Unit { ... }

}

val processor = TypeProcessor(MyTypeProcessor())

processor.process(schema) ```

Obtaining an IntrospectionSchema object from Files

Note: This requires the graphql-introspection-input-jvm dependency and only works for the JVM. kotlin val sdlSchema = IntrospectionSchema.fromSdlFiles(sdlFilesList) val jsonSchema = IntrospectionSchema.fromJsonFile(jsonFile)

Using the Gradle Plugin

The graphql-introspection-plugin-gradle module provides a Gradle Plugin for converting a list of GraphQL SDL files into a schema.json file.

To use the Gradle Plugin, setup the extension: ```groovy apply plugin: "com.chrynan.graphql.introspection.sdl"

graphqlSchemaSdlToJson { schemaSdlInputDirectory = "${project.rootDir.path}/path/to/sdl/files" schemaJsonOutputDirectory = "${project.projectDir}/src/commonMain/graphql" } ```

Then run the Gradle Task: ./gradlew convertGraphqlSchemaSdlToJson

Building

The library is provided through Bintray. Checkout the releases page to get the latest version.

Repository

groovy repositories { maven { url = uri("https://dl.bintray.com/chrynan/chrynan") } }

Dependencies

The library uses the new Kotlin 1.4.0 setup, so you can simply specify the common dependency for the commonMain source set.

graphql-introspection-core

groovy commonMain { dependencies { implementation "com.chrynan.graphql.introspection:graphql-introspection-core:$VERSION" } }

graphql-introspection-processor

groovy commonMain { dependencies { implementation "com.chrynan.graphql.introspection:graphql-introspection-processor:$VERSION" } }

graphql-introspection-input-jvm

Note: That this dependency is only available for the JVM target. This is because it uses the JVM File classes. groovy jvmMain { dependencies { implementation "com.chrynan.graphql.introspection:graphql-introspection-input-jvm:$VERSION" } }

Gradle Plugin

Add the plugin to the buildscript classpath: groovy buildscript { repositories { maven { url = uri("https://dl.bintray.com/chrynan/chrynan") } } dependencies { classpath "com.chrynan.graphql.introspection:graphql-introspection-plugin-gradle:0.1.0" } } Apply the plugin: groovy apply plugin: "com.chrynan.graphql.introspection.sdl"

License

``` Copyright 2020 chRyNaN

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ```