tigergraph · chengbiao-jin · Mar 23, 2026 · Mar 27, 2026 · Mar 27, 2026 · Mar 31, 2026
@@ -5,6 +5,39 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.2] - 2026-04-03
+
+### New Features
+
+- **Schema Change Job APIs** — `createSchemaChangeJob()`, `getSchemaChangeJobs()`, `runSchemaChangeJob()`, `dropSchemaChangeJobs()` for managing schema change jobs via REST.
+- **`createGraph()` accepts vertex/edge types** — optional `vertexTypes` and `edgeTypes` parameters to include existing global types when creating a graph (e.g. `createGraph("g", vertexTypes=["Person"], edgeTypes=["Knows"])`). Pass `vertexTypes=["*"]` to include all global types.
+- **`force` parameter for `runSchemaChange()`** — allows forcing schema changes even when they would cause data loss. Also accepts `dict` (JSON format) for TigerGraph >= 4.0 and supports global schema changes.
+- **Graph scope control** — `useGraph(graphName)` and `useGlobal()` methods on the connection object, mirroring GSQL's `USE GRAPH` / `USE GLOBAL`. `useGlobal()` doubles as a context manager for temporary global scoping (`with conn.useGlobal(): ...`).
+- **GSQL reserved keyword helpers** — `getReservedKeywords()` and `isReservedKeyword(name)` static methods to query the canonical set of GSQL reserved keywords.
+- **Conda build support** — `build.sh` now supports `--conda-build`, `--conda-upload`, `--conda-all`, and `--conda-forge-test` for building and validating conda packages.
+- **`installQueries()` now supports a `wait` parameter** — controls whether the call blocks until installation completes. Defaults to `True` for sync and `False` for async connections.
+
+### Improved
+
+- **Token-based auth for GSQL endpoints** — GSQL endpoints (e.g. `installQueries`) now use API token or JWT when available, instead of always requiring username/password.
+- **Automatic token refresh on expiration** — tokens obtained via `getToken()` are automatically refreshed when the server returns a 401; user-provided tokens raise an error instead.
+
+### Fixed
+
+- **`installQueries()` polling robustness** — handles missing `message` key in server responses and times out after 1 hour instead of hanging indefinitely.
+- **`useGlobal()` context manager** — now correctly restores the graph name when used as a deferred context manager.
+- **`_refresh_auth_headers()` called earlier in `__init__`** — auth header cache is now built immediately after credentials are set.
+- **tgCloud auto-detection simplified** — removed the HTTP ping to `/api/ping`; detection now relies solely on the hostname containing `"tgcloud"`.
+- **`threading.local()` init ordering** — `self._local` and `self._restpp_failover_lock` are now created before `super().__init__()` in `pyTigerGraphBase`.
+- **Boolean query parameter conversion** — `upsertEdge()`, `upsertEdges()` (`vertexMustExist`), `getVersion()` (`verbose`), and `rebuildGraph()` (`force`) now convert boolean values to lowercase strings.
+- **`dropVertices()`** now correctly falls back to `self.graphname` when the `graph` parameter is `None`.
+- **`dropAllDataSources()`** now correctly uses `self.graphname` fallback for the 4.x REST API path.
+- **`getVectorIndexStatus()`** no longer produces a malformed URL when called without a graph name; now supports global scope (returns status for all graphs).
+- **`previewSampleData()`** now raises `TigerGraphException` when no graph name is available, instead of sending an empty graph name to the server.
+- **Docstring fixes** — corrected `timeout` parameter descriptions across vertex and edge query methods.
+
+---
+
 ## [2.0.1] - 2026-03-23
 
 ### Breaking Changes

@@ -1,26 +1,42 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+RECIPE_DIR="$(cd "$(dirname "$0")/pytigergraph-recipe/recipe" && pwd)"
+PYPI_PACKAGE="pytigergraph"
+CONDA_FORGE_PKG="pytigergraph"
+STAGED_RECIPES_DIR="${STAGED_RECIPES_DIR:-$(cd "$(dirname "$0")/../staged-recipes" 2>/dev/null && pwd || echo "")}"
+
 usage() {
     cat <<EOF
 Usage: $(basename "$0") [OPTIONS]
 
 Options:
-  -b, --build       Build the package only
-  -u, --upload      Upload the existing dist/ to PyPI only
-  -a, --all         Build then upload (default when no option is given)
-  -h, --help        Show this help message
+  -b,   --build           Build the PyPI package only
+  -u,   --upload          Upload the existing dist/ to PyPI only
+  -a,   --all             Build then upload to PyPI (default when no option is given)
+  -cb,  --conda-build       Build the conda package locally (validates the recipe)
+  -cu,  --conda-upload      Upload the built conda package to anaconda.org
+  -ca,  --conda-all         conda-build then conda-upload
+  -cft, --conda-forge-test  Full conda-forge CI simulation via staged-recipes/build-locally.py
+  -h,   --help              Show this help message
+
+Environment variables:
+  STAGED_RECIPES_DIR  Path to your conda-forge/staged-recipes clone (default: ../staged-recipes)
 
 Examples:
-  $(basename "$0")            # build + upload
-  $(basename "$0") --build    # build only
-  $(basename "$0") --upload   # upload only
-  $(basename "$0") --all      # build + upload (explicit)
+  $(basename "$0")                     # PyPI build + upload (default)
+  $(basename "$0") --build             # PyPI build only
+  $(basename "$0") --upload            # PyPI upload only
+  $(basename "$0") --conda-build       # validate conda recipe locally
+  $(basename "$0") --conda-forge-test  # simulate full conda-forge CI build
 EOF
 }
 
 DO_BUILD=false
 DO_UPLOAD=false
+DO_CONDA_BUILD=false
+DO_CONDA_UPLOAD=false
+DO_CONDA_FORGE_TEST=false
 
 if [[ $# -eq 0 ]]; then
     DO_BUILD=true
@@ -29,20 +45,26 @@ fi
 
 while [[ $# -gt 0 ]]; do
     case "$1" in
-        -b|--build)  DO_BUILD=true ;;
-        -u|--upload) DO_UPLOAD=true ;;
-        -a|--all)    DO_BUILD=true; DO_UPLOAD=true ;;
-        -h|--help)   usage; exit 0 ;;
+        -b|--build)         DO_BUILD=true ;;
+        -u|--upload)        DO_UPLOAD=true ;;
+        -cb|--conda-build)  DO_CONDA_BUILD=true ;;
+        -cu|--conda-upload) DO_CONDA_UPLOAD=true ;;
+        -ca|--conda-all)    DO_CONDA_BUILD=true; DO_CONDA_UPLOAD=true ;;
+        -cft|--conda-forge-test) DO_CONDA_FORGE_TEST=true ;;
+        -a|--all)           DO_BUILD=true; DO_UPLOAD=true ;;
+        -h|--help)          usage; exit 0 ;;
         *) echo "Unknown option: $1" >&2; usage >&2; exit 1 ;;
     esac
     shift
 done
 
+# ── PyPI ────────────────────────────────────────────────────────────────────
+
 if $DO_BUILD; then
     echo "---- Removing old dist ----"
     rm -rf dist
 
-    echo "---- Building new package ----"
+    echo "---- Building PyPI package ----"
     python3 -m build
 fi
 
@@ -54,4 +76,118 @@ if $DO_UPLOAD; then
 
     echo "---- Uploading to PyPI ----"
     python3 -m twine upload dist/*
+
+    # Update conda recipe meta.yaml with the new version and sha256
+    PKG_VERSION=$(grep "^version" pyproject.toml | awk -F'"' '{print $2}')
+    TARBALL_URL="https://pypi.org/packages/source/p/$PYPI_PACKAGE/$PYPI_PACKAGE-$PKG_VERSION.tar.gz"
+
+    echo "---- Updating conda recipe to $PKG_VERSION ----"
+    # Wait briefly for PyPI to make the tarball available
+    for i in $(seq 1 30); do
+        HTTP_CODE=$(curl -sL -o /dev/null -w "%{http_code}" "$TARBALL_URL")
+        if [[ "$HTTP_CODE" == "200" ]]; then
+            break
+        fi
+        echo "  Waiting for PyPI tarball to become available... ($i/30)"
+        sleep 5
+    done
+    if [[ "$HTTP_CODE" != "200" ]]; then
+        echo "Warning: could not fetch tarball from PyPI. Update meta.yaml manually." >&2
+    else
+        NEW_SHA=$(curl -sL "$TARBALL_URL" | sha256sum | awk '{print $1}')
+        sed -i.bak "s|^  version:.*|  version: \"$PKG_VERSION\"|" "$RECIPE_DIR/meta.yaml"
+        sed -i.bak "s|^  url:.*|  url: $TARBALL_URL|" "$RECIPE_DIR/meta.yaml"
+        sed -i.bak "s|^  sha256:.*|  sha256: $NEW_SHA|" "$RECIPE_DIR/meta.yaml"
+        sed -i.bak "s|^  # sha256:.*|  sha256: $NEW_SHA|" "$RECIPE_DIR/meta.yaml"
+        rm -f "$RECIPE_DIR/meta.yaml.bak"
+        echo "  ✓ Updated meta.yaml: version=$PKG_VERSION sha256=$NEW_SHA"
+    fi
+fi
+
+# ── Conda ───────────────────────────────────────────────────────────────────
+
+if $DO_CONDA_BUILD; then
+    if ! command -v conda-build &>/dev/null; then
+        echo "Error: conda-build not found. Run: conda install conda-build" >&2
+        exit 1
+    fi
+
+    # Verify the required version is already published on PyPI before proceeding.
+    RECIPE_VERSION=$(grep "^  version:" "$RECIPE_DIR/meta.yaml" | awk '{print $2}' | tr -d '"')
+    echo "---- Checking PyPI for $PYPI_PACKAGE==$RECIPE_VERSION ----"
+    PYPI_VERSIONS=$(curl -sf "https://pypi.org/pypi/$PYPI_PACKAGE/json" | python3 -c "import sys,json; print('\n'.join(json.load(sys.stdin)['releases'].keys()))" 2>/dev/null || true)
+    if ! echo "$PYPI_VERSIONS" | grep -qx "$RECIPE_VERSION"; then
+        echo "  $PYPI_PACKAGE==$RECIPE_VERSION not found on PyPI. Running --all to build and publish first..."
+        rm -rf dist
+        python3 -m build
+        python3 -m twine upload dist/*
+        echo "  ✓ Published $PYPI_PACKAGE==$RECIPE_VERSION to PyPI"
+    else
+        echo "  ✓ Found $PYPI_PACKAGE==$RECIPE_VERSION on PyPI"
+    fi
+
+    # Compute sha256 of the tarball declared in the recipe and verify it matches.
+    TARBALL_URL=$(grep "url:" "$RECIPE_DIR/meta.yaml" | awk '{print $2}')
+    echo "---- Computing sha256 for $TARBALL_URL ----"
+    COMPUTED_SHA=$(curl -sL "$TARBALL_URL" | sha256sum | awk '{print $1}')
+    RECIPE_SHA=$(grep "sha256:" "$RECIPE_DIR/meta.yaml" | awk '{print $2}' || true)
+    if [[ -n "$RECIPE_SHA" && "$COMPUTED_SHA" != "$RECIPE_SHA" ]]; then
+        echo "Error: sha256 mismatch!" >&2
+        echo "  recipe : $RECIPE_SHA" >&2
+        echo "  actual : $COMPUTED_SHA" >&2
+        exit 1
+    fi
+    if [[ -z "$RECIPE_SHA" ]]; then
+        echo "Warning: no sha256 in recipe. For conda-forge submission add:"
+        echo "  sha256: $COMPUTED_SHA"
+    fi
+
+    echo "---- Building conda package ----"
+    conda build -c conda-forge "$RECIPE_DIR"
+fi
+
+if $DO_CONDA_UPLOAD; then
+    if ! command -v anaconda &>/dev/null; then
+        echo "Error: anaconda-client not found. Run: conda install anaconda-client" >&2
+        exit 1
+    fi
+
+    CONDA_PKG=$(conda build -c conda-forge "$RECIPE_DIR" --output)
+    if [[ ! -f "$CONDA_PKG" ]]; then
+        echo "Error: conda package not found at $CONDA_PKG. Run --conda-build first." >&2
+        exit 1
+    fi
+
+    echo "---- Uploading conda package to anaconda.org ----"
+    anaconda upload --user tigergraph "$CONDA_PKG"
+fi
+
+if $DO_CONDA_FORGE_TEST; then
+    if [[ -z "$STAGED_RECIPES_DIR" || ! -f "$STAGED_RECIPES_DIR/build-locally.py" ]]; then
+        echo "Error: staged-recipes not found at '${STAGED_RECIPES_DIR}'." >&2
+        echo "Clone it with: git clone https://github.com/conda-forge/staged-recipes.git ../staged-recipes" >&2
+        echo "Or set: export STAGED_RECIPES_DIR=/path/to/staged-recipes" >&2
+        exit 1
+    fi
+    if [[ ! -f "$STAGED_RECIPES_DIR/recipes/$CONDA_FORGE_PKG/meta.yaml" ]]; then
+        echo "Error: recipe not found at $STAGED_RECIPES_DIR/recipes/$CONDA_FORGE_PKG/meta.yaml" >&2
+        echo "Copy your recipe: cp $RECIPE_DIR/meta.yaml $STAGED_RECIPES_DIR/recipes/$CONDA_FORGE_PKG/meta.yaml" >&2
+        exit 1
+    fi
+    # Detect the local platform config for build-locally.py
+    _OS="$(uname -s)"
+    _ARCH="$(uname -m)"
+    if [[ "$_OS" == "Darwin" && "$_ARCH" == "arm64" ]]; then
+        _CONFIG="osx_arm64"
+    elif [[ "$_OS" == "Darwin" ]]; then
+        _CONFIG="osx64"
+    elif [[ "$_OS" == "Linux" && "$_ARCH" == "aarch64" ]]; then
+        _CONFIG="linux_aarch64"
+    else
+        _CONFIG="linux64"
+    fi
+    echo "---- Running conda-forge CI simulation (config: $_CONFIG) ----"
+    echo "Note: build-locally.py builds ALL recipes in staged-recipes/recipes/"
+    cd "$STAGED_RECIPES_DIR"
+    python build-locally.py "$_CONFIG"
 fi
@@ -7,7 +7,7 @@
 try:
     __version__ = _pkg_version("pyTigerGraph")
 except PackageNotFoundError:
-    __version__ = "2.0.1"
+    __version__ = "2.0.2"
 
 __license__ = "Apache 2"