graphql

An implementation of GraphQL in Go. Follows the official reference implementation graphql-js.

Supports: queries, mutations & subscriptions.

Fork

This is a fork of graphql-go/graphql. This fork contains a set of changes:

• it requires go 1.22
• null value support
• arguments in introspection queries are statically ordered (their order won't change on every request)
• numbers are limited to the JavaScript number space
• serialisation to nil and serialisation errors for scalar values

Documentation

godoc: https://pkg.go.dev/github.com/fraym/graphql-go

Getting Started

To install the library, run:

go get github.com/fraym/graphql-go

The following is a simple example which defines a schema with a single hello string-type field and a Resolve method which returns the string world. A GraphQL query is performed against this schema with the resulting output printed in JSON format.

package main

import (
	"encoding/json"
	"fmt"
	"log"

	"github.com/fraym/graphql-go"
)

func main() {
	// Schema
	fields := graphql.Fields{
		"hello": &graphql.Field{
			Type: graphql.String,
			Resolve: func(p graphql.ResolveParams) (any, error) {
				return "world", nil
			},
		},
	}
	rootQuery := graphql.ObjectConfig{Name: "RootQuery", Fields: fields}
	schemaConfig := graphql.SchemaConfig{Query: graphql.NewObject(rootQuery)}
	schema, err := graphql.NewSchema(schemaConfig)
	if err != nil {
		log.Fatalf("failed to create new schema, error: %v", err)
	}

	// Query
	query := `
		{
			hello
		}
	`
	params := graphql.Params{Schema: schema, RequestString: query}
	r := graphql.Do(params)
	if len(r.Errors) > 0 {
		log.Fatalf("failed to execute graphql operation, errors: %+v", r.Errors)
	}
	rJSON, _ := json.Marshal(r)
	fmt.Printf("%s \n", rJSON) // {"data":{"hello":"world"}}
}

For more complex examples, refer to the examples/ directory and graphql_test.go.

Third Party Libraries

Name	Author	Description
graphql-go-handler	Hafiz Ismail	Middleware to handle GraphQL queries through HTTP requests.
graphql-relay-go	Hafiz Ismail	Lib to construct a graphql-go server supporting react-relay.
golang-relay-starter-kit	Hafiz Ismail	Barebones starting point for a Relay application with Golang GraphQL server.
dataloader	Nick Randall	DataLoader implementation in Go.

Blog Posts

• Golang + GraphQL + Relay