graphql GoDoc Build Status Go Report Card
Low-level GraphQL client for Go.
- Simple, familiar API
- Respects
context.Contexttimeouts and cancellation - Build and execute any kind of GraphQL request
- Use strong Go types for response data
- Use variables and upload files
- Simple error handling
Make sure you have a working Go environment. To install graphql, simply run:
$ go get github.com/machinebox/graphql
import "context" // create a client (safe to share across requests) client := graphql.NewClient("https://machinebox.io/graphql") // make a request req := graphql.NewRequest(` query ($key: String!) { items (id:$key) { field1 field2 field3 } } `) // set any variables req.Var("key", "value") // set header fields req.Header.Set("Cache-Control", "no-cache") // define a Context for the request ctx := context.Background() // run it and capture the response var respData ResponseStruct if err := client.Run(ctx, req, &respData); err != nil { log.Fatal(err) }
By default, the package will send a JSON body. To enable the sending of files, you can opt to
use multipart form data instead using the UseMultipartForm option when you create your Client:
client := graphql.NewClient("https://machinebox.io/graphql", graphql.UseMultipartForm())
For more information, read the godoc package documentation or the blog post.
Thanks to Chris Broadfoot for design help.