Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/expediagroup/graphql-kotlin
Libraries for running GraphQL in Kotlin
https://github.com/expediagroup/graphql-kotlin
federation graphql graphql-client graphql-java graphql-plugin graphql-server kotlin oss-portal-featured schema-generator
Last synced: 25 days ago
JSON representation
Libraries for running GraphQL in Kotlin
- Host: GitHub
- URL: https://github.com/expediagroup/graphql-kotlin
- Owner: ExpediaGroup
- License: apache-2.0
- Created: 2018-09-13T22:41:30.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-27T20:09:41.000Z (2 months ago)
- Last Synced: 2024-09-29T09:25:18.716Z (about 1 month ago)
- Topics: federation, graphql, graphql-client, graphql-java, graphql-plugin, graphql-server, kotlin, oss-portal-featured, schema-generator
- Language: Kotlin
- Homepage: https://opensource.expediagroup.com/graphql-kotlin/
- Size: 93.2 MB
- Stars: 1,734
- Watchers: 32
- Forks: 345
- Open Issues: 65
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# GraphQL Kotlin
[](https://github.com/ExpediaGroup/graphql-kotlin/actions?query=workflow%3A%22Continuous+Integration%22)
[](https://github.com/ExpediaGroup/graphql-kotlin/actions?query=workflow%3A%22Publish+Latest+Docs%22)
[](https://github.com/ExpediaGroup/graphql-kotlin/discussions)
[](https://kotlinlang.slack.com/messages/graphql-kotlin/)
GraphQL Kotlin is a collection of libraries, built on top of [graphql-java](https://www.graphql-java.com/), that simplify running GraphQL clients and servers in Kotlin.
Visit our [documentation site](https://expediagroup.github.io/graphql-kotlin) for more details.
## 📦 Modules
* [clients](/clients) - Lightweight GraphQL Kotlin HTTP clients based on Ktor HTTP client and Spring WebClient
* [examples](/examples) - Example apps that use graphql-kotlin libraries to test and demonstrate usages
* [executions](/executions) - Custom instrumentations for a GraphQL operation
* [generator](/generator) - Code-First schema generator and extensions to build Apollo Federation schemas
* [plugins](/plugins) - Gradle and Maven plugins
* [servers](/servers) - Common and library specific modules for running a GraphQL server
## ⌨️ Usage
While all the individual modules of `graphql-kotlin` are published as stand-alone libraries, the most common use cases are running a server and generating a type-safe client.
### Server Example
A basic example of how you can run a GraphQL server can be found on our [server documentation section](https://expediagroup.github.io/graphql-kotlin/docs/server/graphql-server).
### Client Example
A basic setup of a GraphQL client can be found on our [client documentation section](https://expediagroup.github.io/graphql-kotlin/docs/client/client-overview).
## 📋 Documentation
More examples and documentation are available on our [documentation site](https://expediagroup.github.io/graphql-kotlin) hosted in GitHub Pages.
We also have the [examples](/examples) module which can be run locally for testing and shows example code using the libraries.
If you have a question about something you can not find in our documentation, the individual module `README`s, or [javadocs](https://www.javadoc.io/doc/com.expediagroup/graphql-kotlin-schema-generator), feel free to contribute to the docs or [start a discussion](https://github.com/ExpediaGroup/graphql-kotlin/discussions) and tag it with the question label.
If you would like to contribute to our documentation see the [website](/website) directory for more information.
## 🗞 Blog Posts and Videos
The [Blogs & Videos page](https://expediagroup.github.io/graphql-kotlin/docs/blogs-and-videos) in the GraphQL Kotlin documentation links to blog posts, release announcements, conference talks about the library, and general talks about GraphQL at Expedia Group.
## 👥 Contact
This project is part of Expedia Group Open Source but also maintained by a dedicated team
* Expedia Group OSS
* https://expediagroup.github.io
* GraphQL Kotlin Committers
* Github team: `@ExpediaGroup/graphql-kotlin-committers`
If you have a specific question about the library or code, please [start a discussion](https://github.com/ExpediaGroup/graphql-kotlin/discussions) for the community.
We also have a public channel, ([#graphql-kotlin](https://app.slack.com/client/T09229ZC6/CQLNT7B29)), open on the Kotlin Slack instance ([kotlinlang.slack.com](https://kotlinlang.slack.com)).
See the info [here on how to join this slack instance](https://slack.kotlinlang.org/).
## ✏️ Contributing
To get started, please fork the repo and checkout a new branch. You can then build the library locally with Gradle
```shell script
./gradlew clean build
```
See more info in [CONTRIBUTING.md](CONTRIBUTING.md).
After you have your local branch set up, take a look at our [open issues](https://github.com/ExpediaGroup/graphql-kotlin/issues) to see where you can contribute.
## 🛡️ Security
For more info on how to contact the team for security issues or the supported versions that receive security updates, see [SECURITY.md](./.github/SECURITY.md)
## ⚖️ License
This library is licensed under the [Apache License, Version 2.0](LICENSE)