wsgraphql

README

An implementation of apollo graphql websocket protocol for graphql-go.

Inspired by graphqlws

Key features:

• Subscription support
• Callbacks at every stage of communication process for easy customization
• Supports both websockets and plain http queries, with http chunked response for plain http subscriptions
• Mutable context allowing to keep request-scoped connection/authentication data and operation-scoped state

Usage

Assuming gorilla websocket upgrader

import (
	"net/http"

	"github.com/eientei/wsgraphql/v1"
	"github.com/eientei/wsgraphql/v1/compat/gorillaws"
	"github.com/gorilla/websocket"
	"github.com/graphql-go/graphql"
)

schema, err := graphql.NewSchema(...)
if err != nil {
	panic(err)
}

srv, err := wsgraphql.NewServer(
	schema,
	nil,
	wsgraphql.WithUpgrader(gorillaws.Wrap(&websocket.Upgrader{
		Subprotocols: []string{wsgraphql.WebsocketSubprotocol},
	})),
)
if err != nil {
	panic(err)
}

http.Handle("/query", srv)

err = http.ListenAndServe(":8080", nil)
if err != nil {
	panic(err)
}

Examples

See /v1/examples

• minimal server setup
• simpleserver complete example with subscriptions, mutations and queries