You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hugegraph.apache.org by ji...@apache.org on 2026/10/10 04:50:06 UTC
(hugegraph-ai) branch main updated: chore: prepare AI 1.8.0 release (#379)
This is an automated email from the ASF dual-hosted git repository.
imbajin pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/hugegraph-ai.git
The following commit(s) were added to refs/heads/main by this push:
new 7729a1e0 chore: prepare AI 1.8.0 release (#379)
7729a1e0 is described below
commit 7729a1e066a62a722668eec1e2810d114234778e
Author: imbajin <ji...@apache.org>
AuthorDate: Sat Oct 10 12:50:02 2026 +0800
chore: prepare AI 1.8.0 release (#379)
Prepare the AI, LLM and Python client packages for 1.8.0. Python source distributions now include workspace build metadata, and CI builds release packages from a Git source archive. ML remains at 1.7.0 and excluded from the Apache source archive; MCP and Vermeer keep their independent versions.
Disable release-script tracing before credentials are assigned, cancel superseded PR runs, correct uv setup/cache inputs, and run Ruff once on supported Python 3.11. Service tests cover Server 1.7.0 and the rolling latest image on Python 3.10/3.11. Logs record the resolved image ID and /versions response. Once the Server 1.8 image is released, advance the pinned baseline to 1.8.0 while retaining latest
---
.github/workflows/hugegraph-llm.yml | 28 ++++++++++++---
.github/workflows/hugegraph-python-client.yml | 26 +++++++++++---
.github/workflows/ruff.yml | 42 +++++++++++-----------
hugegraph-llm/pyproject.toml | 2 +-
hugegraph-python-client/README.md | 6 ++++
hugegraph-python-client/pyproject.toml | 2 +-
.../src/tests/api/test_graphs.py | 20 +++++++++--
pyproject.toml | 4 +--
scripts/apache-release.sh | 4 ++-
scripts/build_llm_image.sh | 2 +-
10 files changed, 100 insertions(+), 36 deletions(-)
diff --git a/.github/workflows/hugegraph-llm.yml b/.github/workflows/hugegraph-llm.yml
index f14bd567..e9339e36 100644
--- a/.github/workflows/hugegraph-llm.yml
+++ b/.github/workflows/hugegraph-llm.yml
@@ -26,6 +26,10 @@ on:
- 'release-*'
pull_request:
+concurrency:
+ group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.event.pull_request.number || github.run_id }}
+ cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
permissions:
contents: read
@@ -90,10 +94,11 @@ jobs:
fail-fast: false
matrix:
python-version: ["3.10", "3.11"]
+ server-version: ["1.7.0", "latest"]
services:
hugegraph:
- image: hugegraph/hugegraph:1.7.0
+ image: hugegraph/hugegraph:${{ matrix.server-version }}
env:
PASSWORD: admin
options: --health-cmd="curl -f http://localhost:8080/versions || exit 1" --health-interval=10s --health-timeout=5s --health-retries=8
@@ -105,6 +110,13 @@ jobs:
with:
persist-credentials: false
+ - name: Record HugeGraph baseline
+ env:
+ HUGEGRAPH_CONTAINER: ${{ job.services.hugegraph.id }}
+ run: |
+ docker inspect --format='Image: {{.Config.Image}}; ID: {{.Image}}' "$HUGEGRAPH_CONTAINER"
+ curl --fail --silent --show-error http://127.0.0.1:8080/versions | jq -e '.versions | {core, gremlin, api}'
+
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v6
with:
@@ -146,7 +158,7 @@ jobs:
if: failure()
run: |
docker ps -a
- container_id=$(docker ps -aq --filter ancestor=hugegraph/hugegraph:1.7.0 | head -n 1)
+ container_id="${{ job.services.hugegraph.id }}"
if [ -n "$container_id" ]; then
docker logs "$container_id"
fi
@@ -157,10 +169,11 @@ jobs:
fail-fast: false
matrix:
python-version: ["3.10", "3.11"]
+ server-version: ["1.7.0", "latest"]
services:
hugegraph:
- image: hugegraph/hugegraph:1.7.0
+ image: hugegraph/hugegraph:${{ matrix.server-version }}
env:
PASSWORD: admin
options: --health-cmd="curl -f http://localhost:8080/versions || exit 1" --health-interval=10s --health-timeout=5s --health-retries=8
@@ -172,6 +185,13 @@ jobs:
with:
persist-credentials: false
+ - name: Record HugeGraph baseline
+ env:
+ HUGEGRAPH_CONTAINER: ${{ job.services.hugegraph.id }}
+ run: |
+ docker inspect --format='Image: {{.Config.Image}}; ID: {{.Image}}' "$HUGEGRAPH_CONTAINER"
+ curl --fail --silent --show-error http://127.0.0.1:8080/versions | jq -e '.versions | {core, gremlin, api}'
+
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v6
with:
@@ -213,7 +233,7 @@ jobs:
if: failure()
run: |
docker ps -a
- container_id=$(docker ps -aq --filter ancestor=hugegraph/hugegraph:1.7.0 | head -n 1)
+ container_id="${{ job.services.hugegraph.id }}"
if [ -n "$container_id" ]; then
docker logs "$container_id"
fi
diff --git a/.github/workflows/hugegraph-python-client.yml b/.github/workflows/hugegraph-python-client.yml
index ab8915f3..3cc000a1 100644
--- a/.github/workflows/hugegraph-python-client.yml
+++ b/.github/workflows/hugegraph-python-client.yml
@@ -7,6 +7,10 @@ on:
- 'release-*'
pull_request:
+concurrency:
+ group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.event.pull_request.number || github.run_id }}
+ cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
permissions:
contents: read
@@ -43,7 +47,7 @@ jobs:
with:
path: |
~/.cache/uv
- key: ${{ runner.os }}-uv-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+ key: ${{ runner.os }}-uv-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml', 'uv.lock') }}
restore-keys: |
${{ runner.os }}-uv-${{ matrix.python-version }}-
@@ -51,6 +55,12 @@ jobs:
run: |
uv sync --extra python-client --extra dev
+ - name: Build release packages from a source archive
+ run: |
+ archive_dir=$(mktemp -d)
+ git archive HEAD | tar -x -C "$archive_dir"
+ uv build --all-packages "$archive_dir" --out-dir "$archive_dir/dist"
+
- name: Run unit and contract tests
run: |
uv run pytest hugegraph-python-client/src/tests -m "unit or contract" --cov=pyhugegraph --cov-fail-under=45 --cov-report=term --cov-report=xml:client-unit-contract.xml -v --tb=short --durations=20
@@ -68,10 +78,11 @@ jobs:
fail-fast: false
matrix:
python-version: ["3.10", "3.11"]
+ server-version: ["1.7.0", "latest"]
services:
hugegraph:
- image: hugegraph/hugegraph:1.7.0
+ image: hugegraph/hugegraph:${{ matrix.server-version }}
env:
PASSWORD: admin
options: --health-cmd="curl -f http://localhost:8080/versions || exit 1" --health-interval=10s --health-timeout=5s --health-retries=8
@@ -83,6 +94,13 @@ jobs:
with:
persist-credentials: false
+ - name: Record HugeGraph baseline
+ env:
+ HUGEGRAPH_CONTAINER: ${{ job.services.hugegraph.id }}
+ run: |
+ docker inspect --format='Image: {{.Config.Image}}; ID: {{.Image}}' "$HUGEGRAPH_CONTAINER"
+ curl --fail --silent --show-error http://127.0.0.1:8080/versions | jq -e '.versions | {core, gremlin, api}'
+
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v6
with:
@@ -100,7 +118,7 @@ jobs:
with:
path: |
~/.cache/uv
- key: ${{ runner.os }}-uv-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+ key: ${{ runner.os }}-uv-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml', 'uv.lock') }}
restore-keys: |
${{ runner.os }}-uv-${{ matrix.python-version }}-
@@ -122,7 +140,7 @@ jobs:
if: failure()
run: |
docker ps -a
- container_id=$(docker ps -aq --filter ancestor=hugegraph/hugegraph:1.7.0 | head -n 1)
+ container_id="${{ job.services.hugegraph.id }}"
if [ -n "$container_id" ]; then
docker logs "$container_id"
fi
diff --git a/.github/workflows/ruff.yml b/.github/workflows/ruff.yml
index 533ee420..f5311d91 100644
--- a/.github/workflows/ruff.yml
+++ b/.github/workflows/ruff.yml
@@ -7,39 +7,42 @@ on:
- "release-*"
pull_request:
+concurrency:
+ group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.event.pull_request.number || github.run_id }}
+ cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
permissions:
contents: read
+env:
+ UV_VERSION: "0.9.22"
+
jobs:
build:
runs-on: ubuntu-latest
- strategy:
- matrix:
- python-version: ["3.10", "3.11", "3.12"]
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v6
- - name: Setup Python ${{ matrix.python-version }}
- uses: actions/setup-python@v5
+ - name: Setup Python 3.11
+ uses: actions/setup-python@v6
with:
- python-version: ${{ matrix.python-version }}
+ python-version: "3.11"
- name: Install uv
run: |
- curl -LsSf https://astral.sh/uv/install.sh | sh
- echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+ curl -LsSf "https://astral.sh/uv/${UV_VERSION}/install.sh" | sh
+ echo "$HOME/.local/bin" >> "$GITHUB_PATH"
- name: Cache dependencies
id: cache-deps
- uses: actions/cache@v4
+ uses: actions/cache@v5
with:
path: |
~/.cache/uv
- ~/.cache/pip
- key: ${{ runner.os }}-uv-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+ key: ${{ runner.os }}-uv-3.11-${{ hashFiles('**/pyproject.toml', 'uv.lock') }}
restore-keys: |
- ${{ runner.os }}-uv-${{ matrix.python-version }}-
+ ${{ runner.os }}-uv-3.11-
- name: Install dev dependencies
run: |
@@ -60,26 +63,25 @@ jobs:
python-version: ["3.10", "3.11"] # hugegraph-llm requires <3.12
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v6
- name: Setup Python ${{ matrix.python-version }}
- uses: actions/setup-python@v5
+ uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
- name: Install uv
run: |
- curl -LsSf https://astral.sh/uv/install.sh | sh
- echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+ curl -LsSf "https://astral.sh/uv/${UV_VERSION}/install.sh" | sh
+ echo "$HOME/.local/bin" >> "$GITHUB_PATH"
- name: Cache dependencies
id: cache-deps
- uses: actions/cache@v4
+ uses: actions/cache@v5
with:
path: |
~/.cache/uv
- ~/.cache/pip
- key: ${{ runner.os }}-uv-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+ key: ${{ runner.os }}-uv-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml', 'uv.lock') }}
restore-keys: |
${{ runner.os }}-uv-${{ matrix.python-version }}-
diff --git a/hugegraph-llm/pyproject.toml b/hugegraph-llm/pyproject.toml
index 900e4389..c649e801 100644
--- a/hugegraph-llm/pyproject.toml
+++ b/hugegraph-llm/pyproject.toml
@@ -17,7 +17,7 @@
[project]
name = "hugegraph-llm"
-version = "1.7.0"
+version = "1.8.0"
description = "A tool for the implementation and research related to large language models."
authors = [
{ name = "Apache HugeGraph Contributors", email = "dev@hugegraph.apache.org" },
diff --git a/hugegraph-python-client/README.md b/hugegraph-python-client/README.md
index 4f065cc0..d7d5d697 100644
--- a/hugegraph-python-client/README.md
+++ b/hugegraph-python-client/README.md
@@ -80,6 +80,12 @@ print(res)
g.close()
```
+### Graph Configuration Export
+
+`client.graphs().get_graph_config()` returns the graph's local source configuration file as text.
+Graphs loaded without a local file origin (for example from metadata) return HTTP 415 with
+`Can't access the api in a node which started with non local file config.`; the client raises `ServerError`.
+
### Schema Management
The `hugegraph-python-client` provides comprehensive schema management capabilities.
diff --git a/hugegraph-python-client/pyproject.toml b/hugegraph-python-client/pyproject.toml
index 3d1d9335..9cc9134e 100644
--- a/hugegraph-python-client/pyproject.toml
+++ b/hugegraph-python-client/pyproject.toml
@@ -17,7 +17,7 @@
[project]
name = "hugegraph-python"
-version = "1.7.1"
+version = "1.8.0"
description = "A Python SDK for Apache HugeGraph Database."
authors = [
{ name = "Apache HugeGraph Contributors", email = "dev@hugegraph.apache.org" },
diff --git a/hugegraph-python-client/src/tests/api/test_graphs.py b/hugegraph-python-client/src/tests/api/test_graphs.py
index 54bf10b6..d63f5ba1 100644
--- a/hugegraph-python-client/src/tests/api/test_graphs.py
+++ b/hugegraph-python-client/src/tests/api/test_graphs.py
@@ -18,6 +18,8 @@
import unittest
import pytest
+from pyhugegraph.utils.exceptions import ServerError
+from requests import HTTPError
from ..client_utils import ClientUtils
@@ -60,5 +62,19 @@ class TestGraphsManager(unittest.TestCase):
self.assertTrue("backend" in graph_info)
def test_get_graph_config(self):
- graph_config = self.graphs.get_graph_config()
- self.assertIsNotNone(graph_config)
+ # GraphsAPI.getConf serves a local source file and explicitly rejects
+ # configurations without a file origin (for example metadata-loaded graphs).
+ try:
+ graph_config = self.graphs.get_graph_config()
+ except ServerError as exc:
+ self.assertIsInstance(exc.__cause__, HTTPError)
+ response = exc.__cause__.response
+ self.assertEqual(response.status_code, 415)
+ self.assertEqual(
+ response.json()["message"],
+ "Can't access the api in a node which started with non local file config.",
+ )
+ else:
+ self.assertIsInstance(graph_config, str)
+ self.assertIn("gremlin.graph", graph_config)
+ self.assertIn("backend", graph_config)
diff --git a/pyproject.toml b/pyproject.toml
index 8cfb2d37..b0c41150 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -17,7 +17,7 @@
[project]
name = "hugegraph-ai"
-version = "1.7.0"
+version = "1.8.0"
description = "A repository for AI-related projects for Apache HugeGraph."
authors = [
{ name = "Apache HugeGraph Contributors", email = "dev@hugegraph.apache.org" },
@@ -82,7 +82,7 @@ packages = [
]
[tool.hatch.build.targets.sdist]
-include = ["*/src", "README.md", "LICENSE", "NOTICE"]
+include = ["*/src", "*/pyproject.toml", "*/README.md", "*/LICENSE", "*/NOTICE", "README.md", "LICENSE", "NOTICE"]
[tool.uv.sources]
hugegraph-llm = { workspace = true }
diff --git a/scripts/apache-release.sh b/scripts/apache-release.sh
index e4664bd0..f3b3cc39 100755
--- a/scripts/apache-release.sh
+++ b/scripts/apache-release.sh
@@ -17,7 +17,9 @@
#
# if we don't want to exit after '|', remove "-o pipefail"
-set -exo pipefail
+# Do not trace commands: positional arguments can contain SVN credentials.
+set +x
+set -eo pipefail
GROUP="hugegraph"
# current repository name
diff --git a/scripts/build_llm_image.sh b/scripts/build_llm_image.sh
index 7425b3df..3f8c203b 100755
--- a/scripts/build_llm_image.sh
+++ b/scripts/build_llm_image.sh
@@ -18,7 +18,7 @@
set -e
-tag="1.7.0"
+tag="1.8.0"
script_dir=$(realpath "$(dirname "$0")")