fix: improve Docker build scripts and clean up example code

Author: tae898

bindings/python/Dockerfile.build

@@ -80,7 +80,7 @@ RUN echo "🗑️  Removing excluded JARs..." && \
 RUN echo "🔍 Analyzing JARs with jdeps..." && \
     JMODS_DIR="${JAVA_HOME}/jmods" && \
     if [ ! -d "$JMODS_DIR" ]; then JMODS_DIR="${JAVA_HOME}/lib/jmods"; fi && \
-    DETECTED_MODULES=$(find /build/jars -name "*.jar" | grep -v "jboss" | grep -v "wildfly" | grep -v "smallrye" | xargs jdeps --print-module-deps --ignore-missing-deps --multi-release 25 | tr ',' '\n' | sed 's/^ *//;s/ *$//' | grep -E '^[a-zA-Z0-9_.]+$' | sort -u | paste -sd "," -) && \
+    DETECTED_MODULES=$(find /build/jars -name "*.jar" | grep -v "jboss" | grep -v "wildfly" | grep -v "smallrye" | xargs jdeps --print-module-deps --ignore-missing-deps --multi-release 25 2>&1 | tr ',' '\n' | sed 's/^ *//;s/ *$//' | grep -E '^[a-zA-Z0-9_.]+$' | sort -u | paste -sd "," -) && \
     if [ -d "$JMODS_DIR" ]; then \
         AVAILABLE_MODULES=$(find "$JMODS_DIR" -name "*.jmod" -printf "%f\n" | sed 's/\.jmod$//' | sort -u | paste -sd "|" -) ; \
         FILTERED_MODULES=$(echo "${DETECTED_MODULES}" | tr ',' '\n' | sed '/^$/d' | grep -E "^(${AVAILABLE_MODULES})$" | sort -u | paste -sd "," -) ; \

bindings/python/build.sh

@@ -54,22 +54,6 @@ print_usage() {
     echo "  Directory containing ArcadeDB JARs to embed"
     echo "  If omitted, JARs are pulled from arcadedata/arcadedb:<version>"
     echo ""
-    echo "PYTHON_VERSION:"
-    echo "  Python version for wheel (default: 3.12)"
-    echo "  Examples: 3.10, 3.11, 3.12, 3.13, 3.14"
-    echo ""
-    echo "JAR_LIB_DIR (optional):"
-    echo "  Directory containing ArcadeDB JARs to embed"
-    echo "  If omitted, JARs are pulled from arcadedata/arcadedb:<version>"
-    echo ""
-    echo "PYTHON_VERSION:"
-    echo "  Python version for wheel (default: 3.12)"
-    echo "  Examples: 3.10, 3.11, 3.12, 3.13, 3.14"
-    echo ""
-    echo "JAR_LIB_DIR (optional):"
-    echo "  Directory containing ArcadeDB JARs to embed"
-    echo "  If omitted, JARs are pulled from arcadedata/arcadedb:<version>"
-    echo ""
     echo "Build Methods:"
     echo "  Native: macOS builds natively on its platform"
     echo "  Docker: Linux uses Docker for manylinux compliance"
@@ -149,7 +133,6 @@ echo ""
 LOCAL_JARS_DIR="$SCRIPT_DIR/local-jars/lib"
 USE_LOCAL_JARS_ARG=""
 LOCAL_JARS_HASH_ARG=""
-DOCKER_CACHE_ARGS=""
 JAR_SOURCE_DESC="ArcadeDB image"
 mkdir -p "$LOCAL_JARS_DIR"
 
@@ -181,7 +164,6 @@ if [[ -n "$JAR_LIB_DIR" ]]; then
     USE_LOCAL_JARS_ARG="--build-arg USE_LOCAL_JARS=1"
     LOCAL_JARS_HASH=$(find "$LOCAL_JARS_DIR" -maxdepth 1 -name "*.jar" -type f -print0 | sort -z | xargs -0 sha256sum | sha256sum | awk '{print $1}')
     LOCAL_JARS_HASH_ARG="--build-arg LOCAL_JARS_HASH=${LOCAL_JARS_HASH}"
-    DOCKER_CACHE_ARGS="--no-cache"
 else
     echo -e "${CYAN}📦 Using JARs from ArcadeDB image (no JAR_LIB_DIR provided)${NC}"
 fi
@@ -283,7 +265,6 @@ else
     echo -e "${CYAN}📦 Building Docker image...${NC}"
 
     docker build \
-        $DOCKER_CACHE_ARGS \
         --pull \
         --platform "$DOCKER_PLATFORM" \
         --build-arg PYTHON_VERSION="$PYTHON_VERSION" \
@@ -302,7 +283,6 @@ else
     # Run tests
     echo -e "${CYAN}🧪 Running tests in Docker...${NC}"
     docker build \
-        $DOCKER_CACHE_ARGS \
         --platform "$DOCKER_PLATFORM" \
         --build-arg PYTHON_VERSION="$PYTHON_VERSION" \
         --build-arg PACKAGE_NAME="$PACKAGE_NAME" \
@@ -336,23 +316,26 @@ else
 
     if [[ -n "$JAR_LIB_DIR" ]]; then
         echo -e "${CYAN}🔎 Verifying embedded local integration JAR...${NC}"
-        python3 - << 'PY'
+        ARCADEDB_VERSION="$DOCKER_TAG" python3 - << 'PY'
 import hashlib
+import os
 import sys
 import zipfile
 from pathlib import Path
 
+ARCADEDB_VERSION = os.environ["ARCADEDB_VERSION"]
 wheel = sorted(Path("dist").glob("arcadedb_embedded-*.whl"))[-1]
-local_jar = Path("local-jars/lib/arcadedb-integration-26.4.1-SNAPSHOT.jar")
+local_jar_name = f"arcadedb-integration-{ARCADEDB_VERSION}.jar"
+local_jar = Path(f"local-jars/lib/{local_jar_name}")
 
 if not local_jar.exists():
     print(f"❌ Local integration JAR not found: {local_jar}", file=sys.stderr)
     sys.exit(1)
 
 with zipfile.ZipFile(wheel) as zf:
-    matches = [name for name in zf.namelist() if name.endswith("arcadedb-integration-26.4.1-SNAPSHOT.jar")]
+    matches = [name for name in zf.namelist() if name.endswith(local_jar_name)]
     if not matches:
-        print("❌ Embedded integration JAR not found in wheel", file=sys.stderr)
+        print(f"❌ Embedded integration JAR ({local_jar_name}) not found in wheel", file=sys.stderr)
         sys.exit(1)
     wheel_bytes = zf.read(matches[0])
 

bindings/python/examples/02_social_network_graph.py

@@ -828,167 +828,6 @@ def demonstrate_gremlin_queries(db):
             print(f"      🌐 {name} from {city}")
         print(f"      ⏱️  Time: {time.time() - query_start:.3f}s")
 
-        print(f"  ⏱️  OpenCypher section: {time.time() - section_start:.3f}s")
-        print("\n  💡 OpenCypher features demonstrated:")
-        print("      • Pattern matching with MATCH")
-        print("      • Filtering with WHERE")
-        print("      • DISTINCT for deduplication")
-        print("      • Aggregations with count()")
-        print("      • Variable-length paths with repeat()")
-        print("      • Sorting with order()")
-
-    except Exception as e:
-        print(f"    ❌ Error in Gremlin queries: {e}")
-        print("    💡 Note: Gremlin support depends on your ArcadeDB build")
-        import traceback
-
-        traceback.print_exc()
-
-
-def demonstrate_gremlin_queries(db):
-    """Demonstrate graph queries using Gremlin traversal language"""
-    print("\n  🎯 Gremlin Queries (matching Cypher functionality):")
-
-    section_start = time.time()
-
-    try:
-        # 1. Find all friends of Alice using Gremlin
-        print("\n    1️⃣ Find all friends of Alice (Gremlin):")
-        query_start = time.time()
-        result = db.query(
-            "gremlin",
-            """
-            g.V().hasLabel('Person').has('name', 'Alice Johnson')
-                .out('FRIEND_OF')
-                .project('name', 'city')
-                .by('name')
-                .by('city')
-                .order().by(select('name'))
-        """,
-        )
-
-        for row in result:
-            name = row.get("name")
-            city = row.get("city")
-            print(f"      👥 {name} from {city}")
-        print(f"      ⏱️  Time: {time.time() - query_start:.3f}s")
-
-        # 2. Find friends of friends using Gremlin
-        print("\n    2️⃣ Find friends of friends of Alice (Gremlin):")
-        query_start = time.time()
-        result = db.query(
-            "gremlin",
-            """
-            g.V().hasLabel('Person').has('name', 'Alice Johnson')
-                .out('FRIEND_OF').as('friend')
-                .out('FRIEND_OF').as('fof')
-                .where(values('name').is(neq('Alice Johnson')))
-                .select('fof', 'friend')
-                .by('name')
-                .by('name')
-                .order().by(select('fof'))
-        """,
-        )
-
-        for row in result:
-            name = row.get("fof")
-            through = row.get("friend")
-            print(f"      🔗 {name} (through {through})")
-        print(f"      ⏱️  Time: {time.time() - query_start:.3f}s")
-
-        # 3. Find mutual friends using Gremlin
-        print("\n    3️⃣ Find mutual friends between Alice and Bob (Gremlin):")
-        query_start = time.time()
-        result = db.query(
-            "gremlin",
-            """
-            g.V().hasLabel('Person').has('name', 'Alice Johnson')
-                .out('FRIEND_OF').as('mutual')
-                .in('FRIEND_OF').has('name', 'Bob Smith')
-                .select('mutual')
-                .values('name')
-                .order()
-        """,
-        )
-
-        mutual_friends = list(result)
-        if mutual_friends:
-            for row in mutual_friends:
-                print(f"      🤝 {row.get('result')}")
-        else:
-            print("      ℹ️  No mutual friends found")
-        print(f"      ⏱️  Time: {time.time() - query_start:.3f}s")
-
-        # 4. Find close friendships using Gremlin
-        print("\n    4️⃣ Find close friendships (Gremlin):")
-        query_start = time.time()
-        result = db.query(
-            "gremlin",
-            """
-            g.V().hasLabel('Person').as('p1')
-                .outE('FRIEND_OF').has('closeness', 'close').as('edge')
-                .inV().as('p2')
-                .select('p1', 'p2', 'edge')
-                .by('name')
-                .by('name')
-                .by('since')
-                .order().by(select('edge'))
-        """,
-        )
-
-        for row in result:
-            person1 = row.get("p1")
-            person2 = row.get("p2")
-            since = row.get("edge")
-            print(f"      💙 {person1} → {person2} (since {since})")
-        print(f"      ⏱️  Time: {time.time() - query_start:.3f}s")
-
-        # 5. Count friends per person using Gremlin
-        print("\n    5️⃣ Count friends per person (Gremlin aggregation):")
-        query_start = time.time()
-        result = db.query(
-            "gremlin",
-            """
-            g.V().hasLabel('Person')
-                .project('name', 'friend_count')
-                .by('name')
-                .by(out('FRIEND_OF').count())
-                .order()
-                .by(select('friend_count'), desc)
-                .by(select('name'))
-        """,
-        )
-
-        for row in result:
-            name = row.get("name")
-            count = row.get("friend_count")
-            print(f"      • {name}: {count} friends")
-        print(f"      ⏱️  Time: {time.time() - query_start:.3f}s")
-
-        # 6. Find variable length paths using Gremlin
-        print("\n    6️⃣ Find connections within 3 steps from Alice (Gremlin):")
-        query_start = time.time()
-        result = db.query(
-            "gremlin",
-            """
-            g.V().hasLabel('Person').has('name', 'Alice Johnson')
-                .repeat(out('FRIEND_OF').simplePath())
-                .times(3).emit()
-                .where(values('name').is(neq('Alice Johnson')))
-                .dedup()
-                .project('name', 'city')
-                .by('name')
-                .by('city')
-                .order().by(select('name'))
-        """,
-        )
-
-        for row in result:
-            name = row.get("name")
-            city = row.get("city")
-            print(f"      🌐 {name} from {city}")
-        print(f"      ⏱️  Time: {time.time() - query_start:.3f}s")
-
         print(f"  ⏱️  OpenCypher section: {time.time() - section_start:.3f}s")
         print("\n  💡 OpenCypher features demonstrated:")
         print("      • Pattern matching with MATCH")