https://github.com/etix/xdgraph
Go helper for manipulating Dgraph gRPC responses
https://github.com/etix/xdgraph
dgraph golang-library graph-database grpc
Last synced: 2 months ago
JSON representation
Go helper for manipulating Dgraph gRPC responses
- Host: GitHub
- URL: https://github.com/etix/xdgraph
- Owner: etix
- License: apache-2.0
- Archived: true
- Created: 2017-02-15T15:43:37.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-07-11T17:12:13.000Z (over 8 years ago)
- Last Synced: 2024-06-20T06:24:48.345Z (almost 2 years ago)
- Topics: dgraph, golang-library, graph-database, grpc
- Language: Go
- Homepage: https://dgraph.io
- Size: 13.7 KB
- Stars: 8
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# xdgraph: a simple Go helper for manipulating Dgraph gRPC responses
### Installation
`go get github.com/etix/xdgraph`
### Usage
```go
package main
import (
"github.com/etix/xdgraph"
"..."
)
int main() {
// Set up the gRPC connection
conn, err := grpc.Dial("127.0.0.1:8080", grpc.WithInsecure())
if err != nil {
log.Fatal(err)
}
defer conn.Close()
// Initialize the Dgraph gRPC object
c := graph.NewDgraphClient(conn)
req := client.Req{}
req.SetQuery(``)
// Execute the query and fetch the response
resp, err := c.Run(context.Background(), req.Request())
if err != nil {
log.Fatal(err)
}
// Let's use xdgraph to manipulate the results!
xd := xdgraph.ReadResponse(resp)
// Get the UID of the "me" attribute
fmt.Println(xd.Attribute("me")..Property("_uid_").ToUid())
// Get the "name" property of the "me" attribute
fmt.Println(xd.Attribute("me").Property("name").ToString())
// Skipping the first attribute using First()
fmt.Println(xd.First().Property("sign").ToString())
// Check if a property is set (true/false)
fmt.Println(xd.First().Property("address").IsNil())
// Traverse multiple attributes
fmt.Println(xd.First().Attribute("follows").Property("name").ToString())
// Use different types
fmt.Println(xd.First().Attribute("follows").Property("birthdate").ToDate())
// Execute a function literal for each matched attribute
xd.First().Attribute("follows").Attribute("plays").Each(func(r xdgraph.Response) {
fmt.Println(r.Property("name").ToString())
})
// Get multiple properties at once
for _, sign := range xd.First().Attribute("follows").Properties("sign") {
fmt.Println(sign.ToString())
}
// Output the full graph in JSON
fmt.Println(xd.Json())
// Output a sub-graph in JSON
fmt.Println(xd.First().Attribute("follows").Json())
}
```
See the example folder for a complete working example.
### Supported property types
[See here](https://github.com/dgraph-io/dgraph/blob/master/query/graph/graphresponse.pb.go) for the list of supported types upstream.
| Type | |
| ----------- | -------------------------- |
| string | .ToString() |
| []byte | .ToBytes() |
| int64 | .ToInt() |
| bool | .ToBool() |
| float64 | .ToFloat() |
| geom | .ToGeo() |
| datetime | .ToDate() or .ToDateTime() |
| uid | .ToUid() |
### Note
Since the [Dgraph](https://github.com/dgraph-io/dgraph/) project is quite young, the APIs can change at any time.