Refactor Python bindings for ArcadeDB: Enhance exporter, importer, and vector search functionalities

- Updated `export_database` to utilize JPype for Java class imports and improved CSV export handling.
- Introduced `_AsyncRuntimeSettings` class to manage async settings in `importer.py`, ensuring runtime settings are restored after failures.
- Enhanced `jvm.py` to extract runtime resources from wheel files, improving resource management.
- Improved `convert_java_to_python` and `convert_python_to_java` functions for better type handling and caching of Java types.
- Refactored vector search methods in `vector.py` to streamline neighbor finding and result processing.
- Added tests for async executor closure and import document error handling to ensure robustness.
- Updated `sync-upstream.sh` to reflect changes in build script paths.

Author: tae898

.github/workflows/release-python-packages.yml

@@ -36,7 +36,7 @@ jobs:
           echo "📌 Tag base version: $TAG_BASE"
 
           # Get version from pom.xml
-          POM_VERSION=$(python3 extract_version.py --format=docker)
+          POM_VERSION=$(python3 scripts/extract_version.py --format=docker)
           echo "📌 pom.xml version: $POM_VERSION"
 
           # Extract base version from pom.xml (remove -SNAPSHOT, etc.)

.github/workflows/test-python-bindings.yml

@@ -52,7 +52,7 @@ jobs:
           cd bindings/python
 
           # Detect ArcadeDB version from pom.xml (Docker format: X.Y.Z-SNAPSHOT)
-          ARCADEDB_TAG=$(python3 extract_version.py --format=docker)
+          ARCADEDB_TAG=$(python3 scripts/extract_version.py --format=docker)
           echo "📌 ArcadeDB version: $ARCADEDB_TAG"
 
           # Download JARs from official Docker image
@@ -210,7 +210,7 @@ jobs:
         run: |
           cd bindings/python
           echo "🔨 Building arcadedb-embedded for ${{ matrix.platform }} with Python ${{ matrix.python-version }}..."
-          ./build.sh ${{ matrix.platform }} ${{ matrix.python-version }}
+          ./scripts/build.sh ${{ matrix.platform }} ${{ matrix.python-version }}
 
       - name: Extract wheel for additional testing
         shell: bash

.github/workflows/test-python-examples.yml

@@ -69,7 +69,7 @@ jobs:
           cd bindings/python
 
           # Detect ArcadeDB version from pom.xml (Docker format: X.Y.Z-SNAPSHOT)
-          ARCADEDB_TAG=$(python3 extract_version.py --format=docker)
+          ARCADEDB_TAG=$(python3 scripts/extract_version.py --format=docker)
           echo "📌 ArcadeDB version: $ARCADEDB_TAG"
 
           # Download JARs from official Docker image
@@ -213,7 +213,7 @@ jobs:
         run: |
           cd bindings/python
           echo "🔨 Building arcadedb-embedded for ${{ matrix.platform }} with Python ${{ matrix.python-version }}..."
-          ./build.sh ${{ matrix.platform }} ${{ matrix.python-version }}
+          ./scripts/build.sh ${{ matrix.platform }} ${{ matrix.python-version }}
 
       # Note: Java is NOT required - arcadedb-embedded has bundled JRE!
 

bindings/python/.gitignore

@@ -45,6 +45,7 @@ notebooks/
 
 # local built jars
 local-jars/
+.runtime-cache/
 
 # test databases
 my_test_databases/

bindings/python/Dockerfile.build

@@ -166,14 +166,14 @@ COPY --from=jre-builder /build/jre /build/jre/
 COPY bindings/python/src ./src
 COPY bindings/python/tests ./tests
 COPY bindings/python/setup.py .
-COPY bindings/python/setup_jars.py .
-COPY bindings/python/extract_version.py .
-COPY bindings/python/write_version.py .
+COPY bindings/python/scripts/setup_jars.py ./scripts/
+COPY bindings/python/scripts/extract_version.py ./scripts/
+COPY bindings/python/scripts/write_version.py ./scripts/
 COPY bindings/python/jar_exclusions.txt .
 COPY bindings/python/pyproject.toml ./
 COPY bindings/python/README.md ./
 
-# Also copy repository pom.xml so extract_version.py can read it
+# Also copy repository pom.xml so scripts/extract_version.py can read it
 COPY ../../pom.xml /arcadedb/pom.xml
 
 # Install Python build dependencies
@@ -190,8 +190,8 @@ ARG TARGET_PLATFORM
 RUN echo "📌 Package name: ${PACKAGE_NAME}" && \
     echo "📌 Docker tag used: ${ARCADEDB_TAG}" && \
     echo "📌 Target platform: ${TARGET_PLATFORM}" && \
-    python3 write_version.py /arcadedb/pom.xml && \
-    python3 setup_jars.py && \
+    python3 scripts/write_version.py /arcadedb/pom.xml && \
+    python3 scripts/setup_jars.py && \
     echo "📦 JAR files and JRE copied"
 
 # Build the wheel
@@ -201,7 +201,7 @@ RUN if [ -n "${BUILD_VERSION}" ]; then \
         export ARCADEDB_VERSION="${BUILD_VERSION}"; \
         echo "📌 Using provided version: ${ARCADEDB_VERSION}"; \
     else \
-        export ARCADEDB_VERSION=$(python3 extract_version.py --format=pep440 /arcadedb/pom.xml); \
+        export ARCADEDB_VERSION=$(python3 scripts/extract_version.py --format=pep440 /arcadedb/pom.xml); \
         echo "📦 Extracted version from pom.xml: ${ARCADEDB_VERSION}"; \
     fi && \
     echo "📦 Python package version: ${ARCADEDB_VERSION}" && \