GGql

A GraphQL implementation for a GraphQL API that is easy to use and understand while still providing good performance.

Features

• Simple binding of GraphQL schema elements to golang types and functions.
• Multiple resolver options including dynamic resolvers.
• High performance
• No external dependencies.

News

• The first release is out! Benchmarks look good, documentation is complete, and examples available.

Using

The examples provide the best explanation for how to use the package.

• Examples of each resolver approach.
  • Reflection Resolver Example
  • Interface Resolver Example
  • Root Resolver Example
  • WebSocket Subscription Example

Installation

go get github.com/uhn/ggql

To build and install the ggqlgen application:

go install ./...

Releases

See CHANGELOG.md

Benchmarks

Benchmarks are against graphql-go which is currently the most common golang GraphQL package. The ggql-i package is using the interface resolvers (Resolver and ListResolver) while the ggql framework is using reflection. For a more comprehensive comparison go to graphql-benchmarks.

Parameters

• Last updated: 2020-06-10
• OS: Linux (version: 5.7.1-050701-generic, arch: x86_64)
• CPU Cores: 12
• Connections: 1000
• Duration: 20 seconds
• Units:
  • Rates are in requests per second.
  • Latency is in milliseconds.
  • Verbosity is the number of non-blank lines of code excluding comments.

Rate

Latency

Verbosity

License

Unless otherwise noted, the GGQL source files are distributed under the Apache Version 2.0 license found in the LICENSE file.

More Information

• Overview of the package and how to use it.
• FAQ
• Go Docs