feat: expand platform support to include Windows x86_64 in CI/CD workflows and documentation

Author: tae898

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

@@ -81,7 +81,7 @@ jobs:
     secrets: inherit
 
   publish:
-    name: Publish arcadedb-embedded to PyPI (3 platforms)
+    name: Publish arcadedb-embedded to PyPI (4 platforms)
     needs: [validate-version, test, test-examples]
     runs-on: ubuntu-latest
     continue-on-error: true  # Don't block GitHub Release if PyPI upload fails (size limit)
@@ -102,15 +102,15 @@ jobs:
           echo "📦 Wheels for PyPI (current platforms):"
           ls dist/*.whl
 
-          # Count wheels (should be 15: 3 platforms x 5 Python versions)
+          # Count wheels (should be 20: 4 platforms x 5 Python versions)
           WHEEL_COUNT=$(ls dist/*.whl | wc -l)
-          echo "📊 Wheel count: $WHEEL_COUNT (expected: 15)"
+          echo "📊 Wheel count: $WHEEL_COUNT (expected: 20)"
 
           echo ""
-          echo "ℹ️  Current PyPI platforms: linux x86_64, linux arm64, macOS Apple Silicon"
+          echo "ℹ️  Current PyPI platforms: linux x86_64, linux arm64, macOS Apple Silicon, windows x86_64"
 
-          if [ "$WHEEL_COUNT" -ne 15 ]; then
-            echo "❌ Expected 15 wheels (3 platforms x 5 Python versions), got $WHEEL_COUNT"
+          if [ "$WHEEL_COUNT" -ne 20 ]; then
+            echo "❌ Expected 20 wheels (4 platforms x 5 Python versions), got $WHEEL_COUNT"
             exit 1
           fi
 
@@ -140,8 +140,8 @@ jobs:
               PLATFORM="darwin/arm64"
             # elif [[ "$WHEEL_NAME" == *"macosx"*"x86_64"* ]]; then
             #   PLATFORM="darwin/amd64"
-            # elif [[ "$WHEEL_NAME" == *"win_amd64"* ]]; then
-            #   PLATFORM="windows/amd64"
+            elif [[ "$WHEEL_NAME" == *"win_amd64"* ]]; then
+              PLATFORM="windows/amd64"
             else
               PLATFORM="unknown"
             fi

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

@@ -122,23 +122,23 @@ jobs:
       fail-fast: false
       matrix:
         python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
-        # Temporarily limit to three platforms (skip macOS x86_64 and all Windows)
+        # Temporarily limit to four platforms (skip macOS x86_64, Windows ARM64)
         # platform: ['linux/amd64', 'linux/arm64', 'darwin/amd64', 'darwin/arm64', 'windows/amd64', 'windows/arm64']
-        platform: ['linux/amd64', 'linux/arm64', 'darwin/arm64']
+        platform: ['linux/amd64', 'linux/arm64', 'darwin/arm64', 'windows/amd64']
         include:
           - platform: linux/amd64
             runs-on: ubuntu-24.04
           - platform: linux/arm64
             runs-on: ubuntu-24.04-arm
           - platform: darwin/arm64
             runs-on: macos-15
+          - platform: windows/amd64
+            runs-on: windows-2025
           # - platform: darwin/amd64
           #   runs-on: macos-15-intel
-          # - platform: windows/amd64
-          #   runs-on: windows-2025
           # - platform: windows/arm64
           #   runs-on: windows-11-arm
-          # macOS x86_64 and all Windows temporarily disabled
+          # macOS x86_64 and Windows ARM64 temporarily disabled
 
     steps:
       - name: Checkout code
@@ -180,7 +180,7 @@ jobs:
         run: |
           uv pip install --system build wheel setuptools
 
-      # Windows currently disabled, no symlink needed
+      # Windows currently enabled, no symlink needed
       # - name: Create python3 symlink (Windows only)
       #   if: matrix.platform == 'windows/amd64' || matrix.platform == 'windows/arm64'
       #   shell: bash

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

@@ -18,11 +18,6 @@ on:
     workflows: ["Release"]
     types: [completed]
 
-  # Run after release workflow completes
-  workflow_run:
-    workflows: ["Release"]
-    types: [completed]
-
   # Allow being called by other workflows (e.g., release workflow)
   workflow_call:
     inputs:
@@ -50,9 +45,6 @@ env:
 permissions:
   contents: read
 
-permissions:
-  contents: read
-
 jobs:
   # First job: Download ArcadeDB JARs (platform-agnostic)
   download-jars:
@@ -139,23 +131,23 @@ jobs:
       fail-fast: false
       matrix:
         python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
-        # Temporarily limit to three platforms (skip macOS x86_64, all Windows)
+        # Temporarily limit to four platforms (skip macOS x86_64, Windows ARM64)
         # platform: ['linux/amd64', 'linux/arm64', 'darwin/amd64', 'darwin/arm64', 'windows/amd64', 'windows/arm64']
-        platform: ['linux/amd64', 'linux/arm64', 'darwin/arm64']
+        platform: ['linux/amd64', 'linux/arm64', 'darwin/arm64', 'windows/amd64']
         include:
           - platform: linux/amd64
             runs-on: ubuntu-24.04
           - platform: linux/arm64
             runs-on: ubuntu-24.04-arm
           - platform: darwin/arm64
             runs-on: macos-15
+          - platform: windows/amd64
+            runs-on: windows-2025
           # - platform: darwin/amd64
           #   runs-on: macos-15-intel
-          # - platform: windows/amd64
-          #   runs-on: windows-2025
           # - platform: windows/arm64
           #   runs-on: windows-11-arm
-          # macOS x86_64 and all Windows temporarily disabled
+          # macOS x86_64 and Windows ARM64 temporarily disabled
 
     steps:
       - name: Checkout code
@@ -194,7 +186,7 @@ jobs:
         run: |
           uv pip install --system build wheel setuptools
 
-      # Windows currently disabled, no symlink needed
+      # Windows currently enabled, no symlink needed
       # - name: Create python3 symlink (Windows only)
       #   if: matrix.platform == 'windows/amd64' || matrix.platform == 'windows/arm64'
       #   shell: bash
@@ -270,7 +262,7 @@ jobs:
           # macOS doesn't have timeout command by default, use coreutils
           brew install coreutils
 
-      # Windows currently disabled, no env override needed
+      # Windows currently enabled, no env override needed
       # - name: Set UTF-8 encoding (Windows only)
       #   if: matrix.platform == 'windows/amd64' || matrix.platform == 'windows/arm64'
       #   shell: bash
@@ -494,7 +486,7 @@ jobs:
             echo "" >> $GITHUB_STEP_SUMMARY
             echo "All examples ran successfully across all enabled platforms." >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY
-            echo "**Platforms tested**: linux/amd64, linux/arm64, darwin/arm64" >> $GITHUB_STEP_SUMMARY
+            echo "**Platforms tested**: linux/amd64, linux/arm64, darwin/arm64, windows/amd64" >> $GITHUB_STEP_SUMMARY
           else
             echo "❌ **Some platforms failed example testing**" >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY

README.md

@@ -15,7 +15,7 @@ Native Python bindings for ArcadeDB (forked from the official Java project).
 ## ✨ What this repo provides
 
 - Native Python bindings for ArcadeDB with a bundled JRE (no local Java required).
-- Wheels for Linux x86_64, Linux ARM64, and macOS Apple Silicon.
+- Wheels for Linux x86_64, Linux ARM64, macOS Apple Silicon, and Windows x86_64.
 - Embedded usage (in-process) with optional server mode.
 - Tests and examples validated in CI across supported platforms.
 

bindings/python/README.md

@@ -2,7 +2,7 @@
 
 Native Python bindings for ArcadeDB - the multi-model database that supports Graph, Document, Key/Value, Search Engine, Time Series, and Vector models.
 
-**Status**: ✅ Production Ready | **Tests**: 258 Passing | **Platforms**: 3 Supported
+**Status**: ✅ Production Ready | **Tests**: 258 Passing | **Platforms**: 4 Supported
 
 ---
 
@@ -23,9 +23,10 @@ uv pip install arcadedb-embedded
 **Requirements:**
 
 - **Python 3.10–3.14** (packaged/tested on CPython 3.12) - No Java installation required!
-- **Supported Platforms**: Prebuilt wheels for **3 platforms**
+- **Supported Platforms**: Prebuilt wheels for **4 platforms**
   - Linux: x86_64, ARM64
   - macOS: Apple Silicon (ARM64)
+  - Windows: x86_64
 
 ### 5-Minute Example
 
@@ -59,7 +60,7 @@ with arcadedb.create_database("./mydb") as db:
 ## ✨ Features
 
 - ☕ **No Java Installation Required**: Bundled JRE (~249MB uncompressed)
-- 🌍 **3 Platforms Supported**: Linux (x86_64, ARM64), macOS (ARM64)
+- 🌍 **4 Platforms Supported**: Linux (x86_64, ARM64), macOS (ARM64), Windows (x86_64)
 - 🚀 **Embedded Mode**: Direct database access in Python process (no network)
 - 🌐 **Server Mode**: Optional HTTP server with Studio web interface
 - 📦 **Self-contained**: All dependencies bundled (~116MB wheel)
@@ -91,7 +92,7 @@ Import: `import arcadedb_embedded as arcadedb`
 
 ## 🧪 Testing
 
-**Status**: 258 tests + example scripts passing on all 3 platforms
+**Status**: 258 tests + example scripts passing on all 4 platforms
 
 ```bash
 # Run all tests
@@ -107,7 +108,7 @@ See [testing documentation](https://docs.humem.ai/arcadedb/latest/development/te
 
 ## 🔧 Building from Source (Advanced)
 
-Linux uses Docker. macOS uses a native Java 25+ JDK with jlink.
+Linux uses Docker. macOS and Windows use a native Java 25+ JDK with jlink.
 
 ```bash
 cd bindings/python/

bindings/python/build.sh

@@ -44,6 +44,7 @@ print_usage() {
     echo "  linux/amd64    Linux x86_64 (Docker build)"
     echo "  linux/arm64    Linux ARM64 (Docker build, native ARM64 runner)"
     echo "  darwin/arm64   macOS ARM64 Apple Silicon (native build on macOS)"
+    echo "  windows/amd64  Windows x86_64 (native build on Windows)"
     echo ""
     echo "PYTHON_VERSION:"
     echo "  Python version for wheel (default: 3.12)"
@@ -75,7 +76,7 @@ print_usage() {
     echo "Package features:"
     echo "  ✅ Bundled platform-specific JRE (no Java required)"
     echo "  ✅ Optimized JAR selection (see jar_exclusions.txt)"
-    echo "  ✅ Multi-platform support (3 platforms)"
+    echo "  ✅ Multi-platform support (4 platforms)"
     echo "  📦 Size: ~215MB (compressed), ~289MB (installed)"
     echo ""
 }

bindings/python/build_and_install_locally.sh

@@ -36,6 +36,7 @@ cp "${HEADLESS_LIB_DIR}"/*.jar "${LOCAL_JARS_DIR}/"
 log "Copied $(ls -1 "${LOCAL_JARS_DIR}" | wc -l) JARs into local stash"
 
 # 3) Build the Python wheel (defaults to linux/amd64 + Python 3.12) using staged JARs
+#    For Windows or macOS, run this script on that OS and update the platform accordingly.
 log "Building Python wheel with local JARs..."
 cd "${PY_BINDINGS_DIR}"
 ./build.sh linux/amd64 3.12 "${LOCAL_JARS_DIR}"

bindings/python/docs/development/build-architecture.md

@@ -4,9 +4,9 @@ This document describes the build architecture for creating platform-specific Py
 
 ## Overview
 
-**Goal:** Distribute a single `arcadedb-embedded` package that works on 3 platforms with **zero Java installation required**.
+**Goal:** Distribute a single `arcadedb-embedded` package that works on 4 platforms with **zero Java installation required**.
 
-**Achievement:** 3 platform-specific wheels (~63–115MB compressed) with bundled platform-specific JRE, built and tested on GitHub Actions using native runners.
+**Achievement:** 4 platform-specific wheels (~63–115MB compressed) with bundled platform-specific JRE, built and tested on GitHub Actions using native runners.
 
 ## Supported Platforms
 
@@ -15,6 +15,7 @@ This document describes the build architecture for creating platform-specific Py
 | **linux/amd64** | 115.2M | 249.0M | `ubuntu-24.04` | Docker native | Most common Linux platform |
 | **linux/arm64** | 114.1M | 249.6M | `ubuntu-24.04-arm` | Docker native | ARM64 servers, Raspberry Pi |
 | **darwin/arm64** | 63.1M | 55.1M | `macos-15` | Native build | Apple Silicon Macs (2020+) |
+| **windows/amd64** | ~115M | ~249M | `windows-2025` | Native build | Windows x86_64 |
 
 **All supported platforms:**
 
@@ -39,6 +40,11 @@ We use a **hybrid build approach** to create platform-specific wheels:
     - Native `jlink` creates correct JRE for the platform
     - Pre-filtered JARs from artifact (eliminates glob issues)
 
+3. **Windows platform:** Native builds
+  - Uses platform-specific GitHub Actions runner
+  - Native `jlink` creates correct JRE for the platform
+  - Pre-filtered JARs from artifact (eliminates glob issues)
+
 **Critical:** All wheels are **platform-specific** (not `py3-none-any`). This is achieved by:
 
 1. **setup.py with BinaryDistribution class**: Overrides default behavior
@@ -107,7 +113,7 @@ jobs:
     needs: download-jars
     strategy:
       matrix:
-        platform: [linux/amd64, linux/arm64, darwin/arm64]
+        platform: [linux/amd64, linux/arm64, darwin/arm64, windows/amd64]
     # Builds platform-specific wheel, runs tests
 ```
 
@@ -147,6 +153,15 @@ jobs:
     - Builds wheel with `python -m build`
 3. Run tests on native platform
 
+#### Windows Platform (Native)
+
+1. Download pre-filtered JARs artifact
+2. Run `build-native.sh`:
+  - Uses system Java (GitHub runner provides Java 25)
+  - Runs `jlink` natively → platform-specific JRE
+  - Builds wheel with `python -m build`
+3. Run tests on native platform
+
 ## JAR Exclusion System
 
 ### Single Source of Truth: `jar_exclusions.txt`
@@ -321,7 +336,7 @@ bindings/python/
     - Uploads artifact for native builds
 
 2. **test job matrix** (lines 91-364)
-    - Builds 3 platforms
+  - Builds 4 platforms
     - Platform-specific steps (native runners, artifact download, tests)
 
 3. **Test parsing** (lines 200-237)