Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/uhn/ggql
GraphQL implementation for golang.
https://github.com/uhn/ggql
easy-to-use fast golang graphql
Last synced: about 1 month ago
JSON representation
GraphQL implementation for golang.
- Host: GitHub
- URL: https://github.com/uhn/ggql
- Owner: UHN
- License: apache-2.0
- Created: 2020-06-09T21:52:51.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-03-28T00:23:11.000Z (over 2 years ago)
- Last Synced: 2024-09-30T10:42:47.154Z (about 1 month ago)
- Topics: easy-to-use, fast, golang, graphql
- Language: Go
- Size: 382 KB
- Stars: 54
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# GGql 
A GraphQL implementation for a GraphQL API that is easy to use and
understand while still providing good performance.
[![License][License-Image]][License-Url] [![Build Status][Actions-Image]][Actions-Url] [![ReportCard][ReportCard-Image]][ReportCard-Url] [![go.dev reference][Godoc-Image]][Godoc-Url] [![Coverage][Coverage-Image]][Coverage-Url] [![FOSSA Status][Fossa-Image]][Fossa-Url]
## 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](examples/README.md) of each resolver approach.
- [Reflection Resolver Example](examples/reflection/README.md)
- [Interface Resolver Example](examples/interface/README.md)
- [Root Resolver Example](examples/root/README.md)
- [WebSocket Subscription Example](examples/websocket/README.md)
## Installation
```
go get github.com/uhn/ggql
```
To build and install the `ggqlgen` application:
```
go install ./...
```
## Releases
See [CHANGELOG.md](CHANGELOG.md)
## Benchmarks
Benchmarks are against
[graphql-go](https://github.com/graphql-go/graphql) 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](https://github.com/the-benchmarker/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
| Language | Framework(version) | Rate | Median Latency | Average Latency | 90th % | 99th % | Std Dev | Verbosity |
| -------- | ------------------ | ----:| ------------:| ---------------:| ------:| ------:| -------:| ---------:|
| go (1.14) | [ggql-i](https://github.com/uhn/ggql) (1.0.0) | **205058** | 0.062 | 0.060 | 0.068 | 0.088 | 0.02 | 253 |
| go (1.14) | [ggql](https://github.com/uhn/ggql) (1.0.0) | **201986** | 0.062 | 0.057 | 0.066 | 0.073 | 0.02 | 176 |
| go (1.14) | [graphql-go](https://github.com/graphql-go/graphql) (0.7.9) | **32843** | 0.078 | 0.075 | 0.086 | 0.102 | 0.03 | 378 |
### Latency
| Language | Framework(version) | Rate | Median Latency | Average Latency | 90th % | 99th % | Std Dev | Verbosity |
| -------- | ------------------ | ----:| ------------:| ---------------:| ------:| ------:| -------:| ---------:|
| go (1.14) | [ggql-i](https://github.com/uhn/ggql) (1.0.0) | 205058 | **0.062** | 0.060 | 0.068 | 0.088 | 0.02 | 253 |
| go (1.14) | [ggql](https://github.com/uhn/ggql) (1.0.0) | 201986 | **0.062** | 0.057 | 0.066 | 0.073 | 0.02 | 176 |
| go (1.14) | [graphql-go](https://github.com/graphql-go/graphql) (0.7.9) | 32843 | **0.078** | 0.075 | 0.086 | 0.102 | 0.03 | 378 |
### Verbosity
| Language | Framework(version) | Rate | Median Latency | Average Latency | 90th % | 99th % | Std Dev | Verbosity |
| -------- | ------------------ | ----:| ------------:| ---------------:| ------:| ------:| -------:| ---------:|
| go (1.14) | [ggql](https://github.com/uhn/ggql) (1.0.0) | 201986 | 0.062 | 0.057 | 0.066 | 0.073 | 0.02 | **176** |
| go (1.14) | [ggql-i](https://github.com/uhn/ggql) (1.0.0) | 205058 | 0.062 | 0.060 | 0.068 | 0.088 | 0.02 | **253** |
| go (1.14) | [graphql-go](https://github.com/graphql-go/graphql) (0.7.9) | 32843 | 0.078 | 0.075 | 0.086 | 0.102 | 0.03 | **378** |
## 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](overview.md) of the package and how to use it.
- [FAQ](faq.md)
- [Go Docs](https://uhn.github.io/ggql)
[License-Url]: https://www.apache.org/licenses/LICENSE-2.0
[License-Image]: https://img.shields.io/badge/License-Apache2-blue.svg
[ReportCard-Url]: https://goreportcard.com/report/uhn/ggql
[ReportCard-Image]: https://goreportcard.com/badge/github.com/uhn/ggql
[Fossa-Url]: https://app.fossa.io/projects/git%2Bgithub.com%2FUHN%2Fggql?ref=badge_shield
[Fossa-Image]: https://app.fossa.io/api/projects/git%2Bgithub.com%2Fuhn%2Fggql.svg?type=shield
[Coverage-Url]: https://coveralls.io/github/UHN/ggql?branch=master
[Coverage-Image]: https://coveralls.io/repos/github/UHN/ggql/badge.svg?branch=master
[Godoc-Image]: https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square
[Godoc-Url]: https://pkg.go.dev/mod/github.com/uhn/[email protected]
[Actions-Image]: https://github.com/uhn/ggql/actions/workflows/CI.yml/badge.svg
[Actions-Url]: https://github.com/uhn/ggql/actions