graphql README

The project's README from github.com/graphql-go/graphql. As one markdown file: README.md.

graphql CircleCI Go Reference Coverage Status Join the chat at https://gitter.im/graphql-go/graphql

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

Supports: queries, mutations & subscriptions.

Documentation

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

Contribute Back

Friendly reminder links are available in case you would like to contribute back into our commitment with Go and open-source.

Author PayPal Link
Hafiz Ismail Not available yet.
Chris Ramón https://www.paypal.com/donate/?hosted_button_id=WHUQQYEMTRQBJ

Getting Started

To install the library, run:

go get github.com/graphql-go/graphql

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/graphql-go/graphql"
)

func main() {
	// Schema
	fields := graphql.Fields{
		"hello": &graphql.Field{
			Type: graphql.String,
			Resolve: func(p graphql.ResolveParams) (interface{}, 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

graphql (graphql-go/graphql)

Searching Database…

10.1K ·GitHub
Graphql
Что это?Реализация GraphQL на Go, следующая официальной эталонной реализации graphql-js, с поддержкой запросов, мутаций и подписок.
Это библиотека для импорта в свой сервер или отдельный GraphQL-сервер?Это библиотека Go, которую вы импортируете в своё приложение для построения и выполнения GraphQL-схем и резолверов; раздача по HTTP обеспечивается отдельным сопутствующим пакетом вроде graphql-go-handler.
Как это запустить?Установите пакет, определите схему с полями и методом Resolve, затем выполните GraphQL-запрос к этой схеме и выведите JSON-результат; каталог examples/ и graphqltest.go показывают более полные примеры.
Нужно ли что-то кроме инструментария Go для использования?Нет, базовой библиотеке нужен только сам Go; если нужны обработка HTTP, совместимость с Relay или батчинг, добавьте отдельные пакеты вроде graphql-go-handler, graphql-relay-go или dataloader.
Включает ли базовый пакет HTTP-сервер из коробки?Нет, graphql-go только строит и выполняет схемы в памяти; раздача по HTTP, поддержка Relay и загрузка данных оставлены отдельным сторонним библиотекам.
Поддерживается ли пагинация в стиле Relay из коробки?Не напрямую в базовом пакете, но сопутствующая библиотека graphql-relay-go помогает построить сервер graphql-go, совместимый с react-relay.
Что добавляет пакет dataloader?Это отдельная реализация на Go паттерна DataLoader от Facebook, используемая для батчинга и кэширования вызовов резолверов в паре с graphql-go.
Где посмотреть более полные примеры использования?Помимо базового фрагмента hello-world в README, каталог examples/ и graphqltest.go в репозитории содержат более сложные примеры схем и резолверов.
What are similar projects?echo, gqlgen, chi, node-restify, guzzle, mux, martini, fiber
Which topics is it in?subscriptions, relay, middleware, graphql, http, json, backend, go, api, server, library, developer-tools
Creator
graphql-go
Size
3.6 MB
Stars
10.1K
Updated
CommitJun 23Releasev0.8.1Apr 10
Age
11y
Commits · 90 Days