A Go lang driver for FaunaDB.
Currently, the driver is tested on:
- 1.11
- 1.12
- 1.13
To get the latest version run:
go get github.com/fauna/faunadb-go/faunadb
Please note that our driver undergoes breaking changes from time to time, so depending on our master
branch is not recommended.
It is recommended to use one of the following methods instead:
To get a specific version when using gopkg.in
, use:
go get gopkg.in/fauna/faunadb-go.v2/faunadb
To get a specific version when using dep
, use:
dep ensure -add github.com/fauna/faunadb-go/[email protected]
For better usage, we recommend that you import this driver with an alias import.
To import a specific version when using gopkg.in
, use:
import f "gopkg.in/fauna/faunadb-go.v2/faunadb"
To import a specific version when using dep
or go get
, use:
import f "github.com/fauna/faunadb-go/faunadb"
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.RefCollection(f.Collection("user"), "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)
}
For more information about FaunaDB query language, consult our query language reference documentation.
Specific reference documentation for the driver is hosted at GoDoc.
GitHub pull requests are very welcome.
Run go get -t ./...
in order to install project's dependencies.
Run tests against FaunaDB Cloud by passing your root database key to the
test suite, as follows: FAUNA_ROOT_KEY="your-cloud-secret" go test ./...
.
If you have access to another running FaunaDB database, use the
FAUNA_ENDPOINT
environment variable to specify its URI.
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
).
Copyright 2018 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
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.