feature(client): support go client for hugegraph

.github/workflows/client-go-ci.yml

@@ -0,0 +1,66 @@
+name: "hugegraph-client-go-ci"
+
+on:
+  push:
+    branches:
+      - master
+      - feature-go-client
+      - /^release-.*$/
+      - /^feature-.*$/
+    paths:
+      - hugegraph-client-go/**
+      - hugegraph-dist/**
+      - .github/workflows/**
+      - pom.xml
+  pull_request:
+    paths:
+      - hugegraph-client-go/**
+      - hugegraph-dist/**
+      - .github/workflows/**
+      - pom.xml
+
+jobs:
+  client-go-ci:
+    runs-on: ubuntu-20.04
+    env:
+      TRAVIS_DIR: hugegraph-client/assembly/travis
+      COMMIT_ID: be6ee386b9939dc6bd6fcbdf2274b8acc3a0a314
+    strategy:
+      fail-fast: false
+      matrix:
+        JAVA_VERSION: ['8']
+    steps:
+      - name: Install JDK 8
+        uses: actions/setup-java@v3
+        with:
+          java-version: ${{ matrix.JAVA_VERSION }}
+          distribution: 'zulu'
+
+      - name: Cache Maven packages
+        uses: actions/cache@v3
+        with:
+          path: ~/.m2
+          key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+          restore-keys: ${{ runner.os }}-m2
+
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 2
+
+      - name: Prepare env and service
+        run: |
+          $TRAVIS_DIR/install-hugegraph-from-source.sh $COMMIT_ID
+
+      - name: Init Go env
+        uses: actions/setup-go@v2.1.3
+        with: { go-version: '1.x' }
+
+      - name: Go test
+        run: |
+          go version  
+          sudo swapoff -a
+          sudo sysctl -w vm.swappiness=1
+          sudo sysctl -w fs.file-max=262144
+          sudo sysctl -w vm.max_map_count=262144
+          cd hugegraph-client-go && make test

hugegraph-client-go/Makefile

@@ -0,0 +1,58 @@
+# init project path
+HOMEDIR := $(shell pwd)
+OUTDIR  := $(HOMEDIR)/output
+
+# 设置编译时所需要的 go 环境
+export GOENV = $(HOMEDIR)/go.env
+
+GO      := go
+GOMOD   := $(GO) mod
+GOBUILD := $(GO) build
+GOTEST  := $(GO) test -race -timeout 30s -gcflags="-N -l"
+GOPKGS  := $$($(GO) list ./...| grep -vE "vendor")
+
+# test cover files
+COVPROF := $(HOMEDIR)/covprof.out  # coverage profile
+COVFUNC := $(HOMEDIR)/covfunc.txt  # coverage profile information for each function
+COVHTML := $(HOMEDIR)/covhtml.html # HTML representation of coverage profile
+
+# make, make all
+all: prepare compile package
+
+set-env:
+	$(GO) env 
+
+
+#make prepare, download dependencies
+prepare: gomod
+
+gomod: set-env
+	$(GOMOD) download -x || $(GOMOD) download -x
+
+#make compile
+compile: build
+
+build:
+	$(GOBUILD) -o $(HOMEDIR)/go-hugegraph
+
+# make test, test your code
+test: prepare test-case
+test-case:
+	$(GOTEST) -v -cover $(GOPKGS)
+
+# make package
+package: package-bin
+package-bin:
+	rm -rf $(OUTDIR)
+	mkdir -p $(OUTDIR)
+	mv go-hugegraph  $(OUTDIR)/
+
+# make clean
+clean:
+	$(GO) clean
+	rm -rf $(OUTDIR)
+	rm -rf $(HOMEDIR)/go-hugegraph
+	rm -rf $(GOPATH)/pkg/darwin_amd64
+
+# avoid filename conflict and speed up build
+.PHONY: all prepare compile test package clean build 

hugegraph-client-go/README.en.md

@@ -0,0 +1,36 @@
+# hugegraph
+
+#### Description
+基于Go语言的hugegraph client SDK工具
+
+#### Software Architecture
+Software architecture description
+
+#### Installation
+
+1.  xxxx
+2.  xxxx
+3.  xxxx
+
+#### Instructions
+
+1.  xxxx
+2.  xxxx
+3.  xxxx
+
+#### Contribution
+
+1.  Fork the repository
+2.  Create Feat_xxx branch
+3.  Commit your code
+4.  Create Pull Request
+
+
+#### Gitee Feature
+
+1.  You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md
+2.  Gitee blog [blog.gitee.com](https://blog.gitee.com)
+3.  Explore open source project [https://gitee.com/explore](https://gitee.com/explore)
+4.  The most valuable open source project [GVP](https://gitee.com/gvp)
+5.  The manual of Gitee [https://gitee.com/help](https://gitee.com/help)
+6.  The most popular members  [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

hugegraph-client-go/README.md

@@ -0,0 +1,93 @@
+# go-hugegraph
+
+#### 介绍
+基于Go语言的hugegraph client SDK工具
+
+#### 软件架构
+软件架构说明
+
+
+#### 安装教程
+```shell
+go get github.com/go-hugegraph
+```
+
+#### 实现API
+
+
+|API|说明|
+|--|--|
+|schema|获取模型schema|
+|version|获取版本信息|
+
+
+#### 使用说明
+
+##### 1.初始化客户端
+```go
+package main
+
+import "github.com/izliang/hugegraph"
+import "github.com/izliang/hugegraph/hgtransport"
+
+func main() {
+
+	clinet,err := hugegraph.NewClient(hugegraph.Config{
+		Host:  "127.0.0.1",
+		Port:  8888,
+		Graph: "hugegraph",
+		Logger: &hgtransport.ColorLogger{
+			Output:             os.Stdout,
+			EnableRequestBody:  true,
+			EnableResponseBody: true,
+		},
+	})
+
+	if err != nil {
+		log.Fatalf("Error creating the client: %s\n", err)
+	}
+}
+```
+##### 2.获取hugegraph版本
+- 1.使用SDK获取版本信息
+```go
+func getVersion() {
+
+    client := initClient()
+
+    res, err := client.Version()
+    if err != nil {
+    log.Fatalf("Error getting the response: %s\n", err)
+    }
+    defer res.Body.Close()
+
+    fmt.Println(res.Versions)
+
+    fmt.Println(res.Versions.Version)
+}
+
+```
+- 2.结果集响应体
+```go
+type VersionResponse struct {
+	Versions   struct {
+		Version string `json:"version"`
+		Core    string `json:"core"`
+		Gremlin string `json:"gremlin"`
+		API     string `json:"api"`
+	} `json:"versions"`
+}
+
+```
+2.  xxxx
+3.  xxxx
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码
+4.  新建 Pull Request
+
+
+#### 特技

hugegraph-client-go/go.mod

@@ -0,0 +1,4 @@
+module hugegraph.apache.org/client-go
+
+go 1.18
+

hugegraph-client-go/go.sum

@@ -0,0 +1,16 @@
+github.com/chzyer/logex v1.1.10/go.mod h1:+Ywpsq7O8HXn0nuIou7OrIPyXbp3wmkHB+jjWRnGsAI=
+github.com/chzyer/logex v1.2.1/go.mod h1:JLbx6lG2kDbNRFnfkgvh4eRJRPX1QCoOIWomwysCBrQ=
+github.com/chzyer/readline v0.0.0-20180603132655-2972be24d48e/go.mod h1:nSuG5e5PlCu98SY8svDHJxuZscDgtXS6KTTbou5AhLI=
+github.com/chzyer/readline v1.5.1 h1:upd/6fQk4src78LMRzh5vItIt361/o4uq553V8B5sGI=
+github.com/chzyer/readline v1.5.1/go.mod h1:Eh+b79XXUwfKfcPLepksvw2tcLE/Ct21YObkaSkeBlk=
+github.com/chzyer/test v0.0.0-20180213035817-a1ea475d72b1/go.mod h1:Q3SI9o4m/ZMnBNeIyt5eFwwo7qiLfzFZmjNmxjkiQlU=
+github.com/chzyer/test v1.0.0/go.mod h1:2JlltgoNkt4TW/z9V/IzDdFaMTM2JPIi26O1pF38GC8=
+github.com/google/pprof v0.0.0-20211214055906-6f57359322fd h1:1FjCyPC+syAzJ5/2S8fqdZK1R22vvA0J7JZKcuOIQ7Y=
+github.com/google/pprof v0.0.0-20211214055906-6f57359322fd/go.mod h1:KgnwoLYCZ8IQu3XUZ8Nc/bM9CCZFOyjUNOSygVozoDg=
+github.com/ianlancetaylor/demangle v0.0.0-20210905161508-09a460cdf81d/go.mod h1:aYm2/VgdVmcIU8iMfdMvDMsRAQjcfZSKFby6HOFvi/w=
+github.com/ianlancetaylor/demangle v0.0.0-20211126204342-3ad08eb09c01 h1:+0qIm4/XbPn2PYkj6QM6CX/FJN5DGvFOaMkSyB1xuh8=
+github.com/ianlancetaylor/demangle v0.0.0-20211126204342-3ad08eb09c01/go.mod h1:aYm2/VgdVmcIU8iMfdMvDMsRAQjcfZSKFby6HOFvi/w=
+golang.org/x/sys v0.0.0-20211007075335-d3039528d8ac/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220310020820-b874c991c1a5/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0 h1:MVltZSvRTcU2ljQOhs94SXPftV6DCNnZViHeQps87pQ=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=

hugegraph-client-go/hgapi/hgapi.go

@@ -0,0 +1,45 @@
+package hgapi
+
+import (
+	"net/http"
+	"strconv"
+	"time"
+
+	"hugegraph.apache.org/client-go/internal/version"
+)
+
+// VERSION returns the package version as a string.
+//
+const VERSION = version.Client
+
+// Transport defines the interface for an API client.
+//
+type Transport interface {
+	Perform(*http.Request) (*http.Response, error)
+}
+
+// BoolPtr returns a pointer to v.
+//
+// It is used as a convenience function for converting a bool value
+// into a pointer when passing the value to a function or struct field
+// which expects a pointer.
+//
+func BoolPtr(v bool) *bool { return &v }
+
+// IntPtr returns a pointer to v.
+//
+// It is used as a convenience function for converting an int value
+// into a pointer when passing the value to a function or struct field
+// which expects a pointer.
+//
+func IntPtr(v int) *int { return &v }
+
+// formatDuration converts duration to a string in the format
+// accepted by Elasticsearch.
+//
+func formatDuration(d time.Duration) string {
+	if d < time.Millisecond {
+		return strconv.FormatInt(int64(d), 10) + "nanos"
+	}
+	return strconv.FormatInt(int64(d)/int64(time.Millisecond), 10) + "ms"
+}