faunadb-go

README

FaunaDB Go Driver

A Go lang driver for FaunaDB.

Supported Go Versions

Currently, the driver is tested on:

• 1.5
• 1.6
• 1.7
• 1.8
• 1.9

Using the Driver

Installing

go get github.com/fauna/faunadb-go/faunadb

Importing

For better usage, we recommend that you import this driver with an alias import such as:

import f "github.com/fauna/faunadb-go/faunadb"

Basic Usage

package main

import (
	"fmt"

	f "github.com/fauna/faunadb-go/faunadb"
)

type User struct {
	Name string `fauna:"name"`
}

func main() {
	client := f.NewFaunaClient("your-secret-here")

	res, err := client.Query(f.Get(f.Ref("classes/users/42")))
	if err != nil {
		panic(err)
	}

	var user User

	if err := res.At(f.ObjKey("data")).Get(&user); err != nil {
		panic(err)
	}

	fmt.Println(user)
}

The tutorials in the FaunaDB documentation contain driver-specific examples.

For more information about FaunaDB query language, consult our query language reference documentation.

Specific reference documentation for the driver is hosted at GoDoc.

Contributing

GitHub pull requests are very welcome.

Driver Development

Run go get -t ./... in order to install project's dependencies.

Run tests with FAUNA_ROOT_KEY="your-cloud-secret" go test ./....

Alternatively, tests can be run via a Docker container with FAUNA_ROOT_KEY="your-cloud-secret" make docker-test (an alternate Debian-based Go image can be provided via RUNTIME_IMAGE).

LICENSE

Copyright 2017 Fauna, Inc.

Licensed under the Mozilla Public License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at

http://mozilla.org/MPL/2.0/

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.