refact: merge tools into toolchains

.gitignore

@@ -24,6 +24,7 @@ build
 
 ### IntelliJ IDEA ###
 .idea
+.idea/
 *.iws
 *.iml
 *.ipr
@@ -73,3 +74,23 @@ yarn-error.log*
 *.swp
 *.log
 *.pyc
+
+# maven ignore
+output/
+*.war
+*.zip
+*.tar
+*.tar.gz
+tree.txt
+
+# eclipse ignore
+.settings/
+
+# temp ignore
+*.cache
+*.diff
+*.patch
+*.tmp
+
+# system ignore
+Thumbs.db

hugegraph-tools/.gitattributes

@@ -0,0 +1 @@
+* text=auto !eol

hugegraph-tools/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,97 @@
+name: Bug report (反馈 Bug)
+description: Create a bug report to help HugeGraph improve
+title: '[Bug] describe the main problem'
+labels:
+  - bug
+
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        ### Note (特别注意) : 
+
+        > 1. 请先**搜索**现有的[Server-Issues](https://github.com/hugegraph/hugegraph/issues) 与
+        [Tools-Issues](https://github.com/hugegraph/hugegraph-tools/issues) 中没有与您相同
+        / 相关的问题 (请勿重复提交)
+
+        > 2. 我们需要尽可能**详细**的信息来**复现**问题, 越详细的信息 (包括**日志 / 截图 / 配置**等)
+        会**越快**被响应和处理
+
+        > 3. Issue 标题请保持原有模板分类(例如:`[Bug]`), 长段描述之间可以增加`空行`或使用`序号`标记, 保持排版清晰
+
+        > 4. 请在对应的模块提交 issue, 缺乏有效信息 / 长时间 (> 14 天) 没有回复的 issue 可能会被 **关闭**
+        (更新时会再开启)
+  
+  - type: dropdown
+    attributes:
+      label: Bug Type (问题类型)
+      options:
+        - exception / error (异常报错)
+        - data inconsistency (备份 / 迁移后不合预期)
+        - logic (逻辑设计问题)
+        - others (please edit later)
+
+  - type: checkboxes
+    attributes:
+      label: Before submit
+      options:
+        - label: 我已经确认现有的 [Server-Issues](https://github.com/hugegraph/hugegraph/issues) 与 [Tools-Issues](https://github.com/hugegraph/hugegraph-tools/issues) 中没有相同 / 重复问题
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Environment (环境信息)
+      description: |
+        > server version could get from [rest-api](https://hugegraph.github.io/hugegraph-doc/clients/restful-api/other.html) (http://localhost:8080/versions)
+      value: |
+        - Server Version: v0.11.x
+        - Tools Version: v1.x
+        - Data Size:  xx vertices, xx edges <!-- (like 1000W 点, 9000W 边) -->
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected & Actual behavior (期望与实际表现)
+      description: |
+        > we can refer [How to create a minimal reproducible Example](https://stackoverflow.com/help/minimal-reproducible-example) (如何提供最简的可复现用例)
+        > if possible, please provide screenshots or GIF (请提供清晰的截图, 动图录屏更佳)
+      placeholder: |        
+        type the main problem here 
+        
+        ```java
+        // Exception / Error info (尽可能详细的日志 + 完整异常栈)
+
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Vertex/Edge example (问题点 / 边数据举例)
+      description: |
+        > 如果问题与具体的点 / 边数据相关, 请提供完整的`原始数据 + REST-API 查询结果`
+      placeholder: |
+        // Origin data
+        tom  18  boy  HK
+
+        // JSON of Vertex / Edge
+        {
+          "vertex": { "id": "xxx" }
+        }
+      render: javascript
+
+  - type: textarea
+    attributes:
+      label: Schema [VertexLabel, EdgeLabel, IndexLabel] (元数据结构)
+      description: |
+        > 如果问题与具体的点类型 / 边类型 / 索引类型相关, 请提供完整的 `Schema 返回 JSON 结果`
+      placeholder: |
+        // Query URL
+        GET http://localhost:8080/graphs/hugegraph/schema/vertexlabels
+
+        // JSON of GraphSchema
+        {
+          "vertex": { "id": "xxx" }
+        }
+      render: javascript

hugegraph-tools/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,10 @@
+blank_issues_enabled: false
+
+# 设置提 issue 前的参考文档
+contact_links:
+  - name: HugeGraph Tools Doc
+    url: https://hugegraph.github.io/hugegraph-doc/quickstart/hugegraph-tools.html
+    about: Please search question here before opening a new issue
+  - name: HugeGraph API Doc
+    url: https://hugegraph.github.io/hugegraph-doc/clients/hugegraph-api.html
+    about: Please search usage here before opening a new issue

hugegraph-tools/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,15 @@
+name: Feature request (新需求 / 功能)
+description: Give an idea for HugeGraph
+title: '[Feature] describe the new feature'
+labels:
+  - feature
+
+body:
+  - type: textarea
+    attributes:
+      label: Feature Description (功能描述)
+      description: |
+        > 请简要描述新功能 / 需求的使用场景或上下文, 最好能给个具体的例子说明
+      placeholder: type the feature description here 
+    validations:
+      required: true

hugegraph-tools/.github/ISSUE_TEMPLATE/question_ask.yml

@@ -0,0 +1,97 @@
+name: Ask question (提问)
+description: Question about usage or configs in HugeGraph
+title: '[Question] describe your problem'
+
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        ### Note (特别注意) : 
+
+        > 1. 请先**搜索**现有的[Server-Issues](https://github.com/hugegraph/hugegraph/issues) 与
+        [Tools-Issues](https://github.com/hugegraph/hugegraph-tools/issues) 中没有与您相同
+        / 相关的问题 (请勿重复提交)
+
+        > 2. 我们需要尽可能**详细**的信息来**复现**问题, 越详细的信息 (包括**日志 / 截图 / 配置**等)
+        会**越快**被响应和处理
+
+        > 3. Issue 标题请保持原有模板分类(例如:`[Bug]`), 长段描述之间可以增加`空行`或使用`序号`标记, 保持排版清晰
+
+        > 4. 请在对应的模块提交 issue, 缺乏有效信息 / 长时间 (> 14 天) 没有回复的 issue 可能会被 **关闭**
+        (更新时会再开启)
+  
+  - type: dropdown
+    attributes:
+      label: Problem Type (问题类型)
+      options:
+        - exception / error (异常报错)
+        - data inconsistency (备份 / 迁移后不合预期)
+        - logic (逻辑设计问题)
+        - configs (配置项 / 文档相关)
+        - performence (性能优化)
+        - others (please edit later)
+
+  - type: checkboxes
+    attributes:
+      label: Before submit
+      options:
+        - label: 我已经确认现有的 [Server-Issues](https://github.com/hugegraph/hugegraph/issues) 与 [Tools-Issues](https://github.com/hugegraph/hugegraph-tools/issues) 中没有相同 / 重复问题
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Environment (环境信息)
+      description: |
+        > server version could get from [rest-api](https://hugegraph.github.io/hugegraph-doc/clients/restful-api/other.html) (http://localhost:8080/versions)
+      value: |
+        - Server Version: v0.11.x
+        - Tools Version: v1.x
+        - Data Size:  xx vertices, xx edges <!-- (like 1000W 点, 9000W 边) -->
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Your Question (问题描述)
+      description: |
+        > 图使用 / 配置相关问题，请优先参考 [REST-API 文档](https://hugegraph.github.io/hugegraph-doc/clients/hugegraph-api.html), 以及 [Server 配置文档](https://hugegraph.github.io/hugegraph-doc/config/config-option.html)
+        > if possible, please provide screenshots or GIF (请提供清晰的截图, 动图录屏更佳)
+      placeholder: |        
+        type the main problem here 
+        
+        ```java
+        // Exception / Error info (尽可能详细的日志 + 完整异常栈)
+
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Vertex/Edge example (问题点 / 边数据举例)
+      description: |
+        > 如果问题与具体的点 / 边数据相关, 请提供完整的`原始数据 + REST-API 查询结果`
+      placeholder: |
+        // Origin data
+        tom  18  boy  HK
+
+        // JSON of Vertex / Edge
+        {
+          "vertex": { "id": "xxx" }
+        }
+      render: javascript
+
+  - type: textarea
+    attributes:
+      label: Schema [VertexLabel, EdgeLabel, IndexLabel] (元数据结构)
+      description: |
+        > 如果问题与具体的点类型 / 边类型 / 索引类型相关, 请提供完整的 `Schema 返回 JSON 结果`
+      placeholder: |
+        // Query URL
+        GET http://localhost:8080/graphs/hugegraph/schema/vertexlabels
+
+        // JSON of GraphSchema
+        {
+          "vertex": { "id": "xxx" }
+        }
+      render: javascript

hugegraph-tools/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: hugegraph-tools ci
+on:
+  push:
+    branches:
+      - master
+      - /^release-.*$/
+      - /^test-.*$/
+  pull_request:
+    branches:
+      - master
+      - /^release-.*$/
+      - /^test-.*$/
+jobs:
+  build:
+    runs-on: ubuntu-20.04
+    env:
+      TRAVIS_DIR: assembly/travis
+      COMMIT_ID: 1d031c5905cbef008dd5fb468576b0e6a9445181
+    steps:
+      - name: Install JDK 8
+        uses: actions/setup-java@v2
+        with:
+          java-version: '8'
+          distribution: 'zulu'
+      - name: Cache Maven packages
+        uses: actions/cache@v2
+        with:
+          path: ~/.m2
+          key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+          restore-keys: ${{ runner.os }}-m2
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 2
+      - name: Compile
+        run: |
+          mvn compile -Dmaven.javadoc.skip=true
+      - name: Prepare env and service
+        run: |
+          $TRAVIS_DIR/install-hugegraph-from-source.sh $COMMIT_ID
+      - name: Run test
+        run: |
+          mvn test -Dtest=FuncTestSuite
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v1
+        with:
+          file: target/jacoco.xml

hugegraph-tools/.github/workflows/stale.yml

@@ -0,0 +1,36 @@
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: "0 21 * * *"
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+    - uses: actions/stale@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'Due to the lack of activity, the current issue is marked as stale and will be closed after 20 days, any update will remove the stale label'
+        stale-pr-message: 'Due to the lack of activity, the current pr is marked as stale and will be closed after 180 days, any update will remove the stale label'
+        stale-issue-label: 'inactive'
+        stale-pr-label: 'inactive'
+        exempt-issue-labels: 'feature,bug,enhancement,improvement,wontfix,todo'
+
+        days-before-issue-stale: 15
+        days-before-issue-close: 20
+        days-before-pr-stale: 30
+        days-before-pr-close: 180
+        operations-per-run: 10
+        start-date: '2018-12-01T00:00:00Z'
+
+        exempt-all-assignees: true
+        remove-stale-when-updated: true
+        exempt-all-pr-milestones: true
+        delete-branch: false
+        enable-statistics: true

hugegraph-tools/.travis.yml

@@ -0,0 +1,27 @@
+language: java
+
+jdk:
+  - openjdk8
+
+sudo: required
+
+branches:
+  only:
+  - master
+  - /^release-.*$/
+  - /^test-.*$/
+
+install: mvn compile -Dmaven.javadoc.skip=true | grep -v "Downloading\|Downloaded"
+
+before_script:
+  - $TRAVIS_DIR/install-hugegraph.sh $TRAVIS_BRANCH | grep -v "Downloading\|Downloaded"
+
+script:
+  - mvn test -Dtest=FuncTestSuite
+
+after_success:
+  - bash <(curl -s https://codecov.io/bash)
+
+env:
+  global:
+  - TRAVIS_DIR=assembly/travis

hugegraph-tools/README.md

@@ -0,0 +1,17 @@
+# HugeGraph-Tools
+
+HugeGraph-Tools is a customizable command line utility for deploying, managing and backing up/restoring graphs from HugeGraph database.
+
+## Main Functions
+
+- Deploy and clear HugeGraph-Server and HugeGraph-Studio automatically.
+- Manage graphs and query with Gremlin from multiple HugeGraph databases essily.
+- Backup/restore graph schema and graph data from/to HugeGraph databases conveniently, also support backup periodically
+
+## Learn More
+
+The [project homepage](https://hugegraph.github.io/hugegraph-doc/quickstart/hugegraph-tools.html) contains more information about HugeGraph-Tools. 
+
+## License
+
+HugeGraph-Tools is licensed under Apache 2.0 License.