package gqlclient

import "git.sr.ht/~emersion/gqlclient"

Index ¶

• type Client
• func New(endpoint string, hc *http.Client) *Client
• func (c *Client) Execute(ctx context.Context, op *Operation, data interface{}) error
• type Error
• func (err *Error) Error() string
• type ErrorLocation
• type Operation
• func NewOperation(query string) *Operation
• func (op *Operation) Var(k string, v interface{})
• type Upload
• func (Upload) MarshalJSON() ([]byte, error)

Examples ¶

• Client.Execute
• Client.Execute (Upload)
• Client.Execute (Vars)

Package Files ¶

client.go error.go upload.go

type Client ¶

type Client struct {
    // contains filtered or unexported fields
}

Client is a GraphQL HTTP client.

func New ¶

func New(endpoint string, hc *http.Client) *Client

New creates a new GraphQL client with the specified endpoint.

If hc is nil, http.DefaultClient is used.

func (*Client) Execute ¶

func (c *Client) Execute(ctx context.Context, op *Operation, data interface{}) error

Execute sends the operation to the GraphQL server.

The data returned by the server will be decoded into the data argument.

var ctx context.Context
var c *gqlclient.Client

op := gqlclient.NewOperation(`query {
		me {
			name
		}
	}`)

var data struct {
    Me struct {
        Name string
    }
}
if err := c.Execute(ctx, op, &data); err != nil {
    log.Fatal(err)
}

log.Print(data)

var ctx context.Context
var c *gqlclient.Client

op := gqlclient.NewOperation(`mutation ($file: Upload!) {
		send(file: $file)
	}`)

op.Var("file", gqlclient.Upload{
    Filename: "gopher.txt",
    MIMEType: "text/plain",
    Body:     strings.NewReader("Hello, 世界"),
})

if err := c.Execute(ctx, op, nil); err != nil {
    log.Fatal(err)
}

var ctx context.Context
var c *gqlclient.Client

op := gqlclient.NewOperation(`query ($name: String!) {
		user(username: $name) {
			age
		}
	}`)

op.Var("name", "emersion")

var data struct {
    User struct {
        Age int
    }
}
if err := c.Execute(ctx, op, &data); err != nil {
    log.Fatal(err)
}

log.Print(data)

type Error ¶

type Error struct {
    Message    string
    Locations  []ErrorLocation
    Path       []interface{}
    Extensions json.RawMessage
}

Error is a GraphQL error.

func (*Error) Error ¶

func (err *Error) Error() string

type ErrorLocation ¶

type ErrorLocation struct {
    Line, Column int
}

ErrorLocation describes an error location in a GraphQL document.

Line and column numbers start from 1.

type Operation ¶

type Operation struct {
    // contains filtered or unexported fields
}

Operation describes a GraphQL operation.

An operation is a query with variables.

func NewOperation ¶

func NewOperation(query string) *Operation

NewOperation creates a new GraphQL operation.

func (*Operation) Var ¶

func (op *Operation) Var(k string, v interface{})

Var defines a new variable.

If the variable is already defined, Var panics.

type Upload ¶

type Upload struct {
    Filename string
    MIMEType string
    Body     io.Reader
}

Upload is a file upload.

See the GraphQL multipart request specification for details: https://github.com/jaydenseric/graphql-multipart-request-spec

func (Upload) MarshalJSON ¶

func (Upload) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler.

Directories ¶