fix: update Python version to 3.12 in workflows and documentation

tae898 · tae898 · commit 9355c259a731 · 2026-01-01T19:06:00.000+01:00
diff --git a/.github/workflows/deploy-python-docs.yml b/.github/workflows/deploy-python-docs.yml
@@ -70,7 +70,7 @@ jobs:
         if: github.event_name == 'workflow_dispatch' || steps.check-dev-version.outputs.is-dev != 'true'
         uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
         with:
-          python-version: '3.11'
+          python-version: '3.12'
           cache: 'pip'
 
       - name: Install dependencies
diff --git a/.github/workflows/release-python-packages.yml b/.github/workflows/release-python-packages.yml
@@ -20,7 +20,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       - name: Validate version compatibility
         id: validate
diff --git a/.github/workflows/test-python-bindings.yml b/.github/workflows/test-python-bindings.yml
@@ -129,6 +129,17 @@ jobs:
             runs-on: windows-2025
           - platform: windows/arm64
             runs-on: windows-11-arm
+        exclude:
+          # Windows ARM64: no 3.10 or 3.14 available on hosted runners
+          - platform: windows/arm64
+            python-version: '3.10'
+          - platform: windows/arm64
+            python-version: '3.14'
+          # macOS x86_64: torch wheels not available yet for 3.13/3.14
+          - platform: darwin/amd64
+            python-version: '3.13'
+          - platform: darwin/amd64
+            python-version: '3.14'
 
     steps:
       - name: Checkout code
diff --git a/.github/workflows/test-python-examples.yml b/.github/workflows/test-python-examples.yml
@@ -125,6 +125,17 @@ jobs:
             runs-on: windows-2025
           - platform: windows/arm64
             runs-on: windows-11-arm
+        exclude:
+          # Windows ARM64: no 3.10 or 3.14 available on hosted runners
+          - platform: windows/arm64
+            python-version: '3.10'
+          - platform: windows/arm64
+            python-version: '3.14'
+          # macOS x86_64: torch wheels not available yet for 3.13/3.14
+          - platform: darwin/amd64
+            python-version: '3.13'
+          - platform: darwin/amd64
+            python-version: '3.14'
 
     steps:
       - name: Checkout code
diff --git a/bindings/python/README.md b/bindings/python/README.md
@@ -30,7 +30,7 @@ pip install arcadedb-embedded
 
 **Requirements:**
 
-- **Python 3.10–3.14** (packaged/tested on CPython 3.11) - No Java installation required!
+- **Python 3.10–3.14** (packaged/tested on CPython 3.12) - No Java installation required!
 - **Supported Platforms**: Prebuilt wheels for **6 platforms**
   - Linux: x86_64, ARM64
   - macOS: Intel (x86_64), Apple Silicon (ARM64)
diff --git a/bindings/python/docs/development/contributing.md b/bindings/python/docs/development/contributing.md
@@ -25,7 +25,7 @@ pytest tests/
 
 **Required:**
 
-- Python 3.10–3.14 (dev baseline 3.11)
+- Python 3.10–3.14 (dev baseline 3.12)
 - Java 21+ (JDK or JRE)
 - Docker (for building distributions)
 - Git
diff --git a/bindings/python/docs/getting-started/distributions.md b/bindings/python/docs/getting-started/distributions.md
@@ -14,7 +14,7 @@ ArcadeDB Python provides a **self-contained embedded** package that runs the dat
 pip install arcadedb-embedded
 ```
 
-**Requirements:** Python 3.10–3.14 (packaged; primary testing on 3.11) - No Java installation needed!
+**Requirements:** Python 3.10–3.14 (packaged; primary testing on 3.12) - No Java installation needed!
 
 ## What's Inside
 
diff --git a/bindings/python/docs/getting-started/installation.md b/bindings/python/docs/getting-started/installation.md
@@ -10,7 +10,7 @@ pip install arcadedb-embedded
 
 **Requirements:**
 
-- **Python 3.10–3.14** (packaged; primary testing on 3.11) - No Java installation required!
+- **Python 3.10–3.14** (packaged; primary testing on 3.12) - No Java installation required!
 - **Supported Platforms**: Prebuilt wheels for **6 platforms**
   - Linux: x86_64, ARM64
   - macOS: Intel (x86_64), Apple Silicon (ARM64)
@@ -51,7 +51,7 @@ The `arcadedb-embedded` package (~209-215MB wheel, ~274-289MB installed) include
 ## Python Version
 
 - **Supported**: Python 3.10, 3.11, 3.12, 3.13, 3.14 (packaged classifiers)
-- **Recommended**: Python 3.11 or higher
+- **Recommended**: Python 3.12 or higher
 
 ## Dependencies
 
diff --git a/bindings/python/docs/index.md b/bindings/python/docs/index.md
@@ -2,7 +2,7 @@
 
 <div class="grid cards" markdown>
 
--   :material-rocket-launch:{ .lg .middle } __Production Ready__
+-   :material-rocket-launch:{ .lg .middle } **Production Ready**
 
     ---
 
@@ -11,23 +11,23 @@
     **Status**: ✅ Production Ready
     **Tests**: ✅ 204 + 7 Examples Passing
 
--   :fontawesome-brands-python:{ .lg .middle } __Pure Python API__
+-   :fontawesome-brands-python:{ .lg .middle } **Pure Python API**
 
     ---
 
     Pythonic interface to ArcadeDB's multi-model database
 
     [:octicons-arrow-right-24: Quick Start](getting-started/quickstart.md)
 
--   :material-graph:{ .lg .middle } __Multi-Model Database__
+-   :material-graph:{ .lg .middle } **Multi-Model Database**
 
     ---
 
     Graph, Document, Key/Value, Vector, Time Series in one database
 
     [:octicons-arrow-right-24: Learn More](guide/core/database.md)
 
--   :material-lightning-bolt:{ .lg .middle } __High Performance__
+-   :material-lightning-bolt:{ .lg .middle } **High Performance**
 
     ---
 
@@ -50,14 +50,15 @@ ArcadeDB is a next-generation multi-model database that supports:
 
 ## Why Python Bindings?
 
-These bindings provide native Python access to ArcadeDB's full capabilities with __two access methods__:
+These bindings provide native Python access to ArcadeDB's full capabilities with **two
+access methods**:
 
 ### Java API (Embedded Mode)
 
-- __Direct JVM Integration__: Run database directly in your Python process via JPype
-- __Best Performance__: No network overhead, direct method calls
-- __Use Cases__: Single-process applications, high-performance scenarios
-- __Example__:
+- **Direct JVM Integration**: Run database directly in your Python process via JPype
+- **Best Performance**: No network overhead, direct method calls
+- **Use Cases**: Single-process applications, high-performance scenarios
+- **Example**:
   ```python
   with db.transaction():
       vertex = db.new_vertex("Person")
@@ -67,10 +68,10 @@ These bindings provide native Python access to ArcadeDB's full capabilities with
 
 ### HTTP API (Server Mode)
 
-- __Remote Access__: HTTP REST endpoints when server is running
-- __Multi-Language__: Any language can connect via HTTP
-- __Use Cases__: Multi-process applications, web services, remote access
-- __Example__:
+- **Remote Access**: HTTP REST endpoints when server is running
+- **Multi-Language**: Any language can connect via HTTP
+- **Use Cases**: Multi-process applications, web services, remote access
+- **Example**:
   ```python
   import requests
   from requests.auth import HTTPBasicAuth
@@ -83,13 +84,13 @@ These bindings provide native Python access to ArcadeDB's full capabilities with
   )
   ```
 
-Both APIs can be used __simultaneously__ on the same server instance.
+Both APIs can be used **simultaneously** on the same server instance.
 
 ## Additional Features
 
-- __Multiple Query Languages__: SQL, Cypher, Gremlin, MongoDB syntax
-- __ACID Transactions__: Full transactional guarantees
-- __Type Safety__: Pythonic API with proper error handling
+- **Multiple Query Languages**: SQL, Cypher, Gremlin, MongoDB syntax
+- **ACID Transactions**: Full transactional guarantees
+- **Type Safety**: Pythonic API with proper error handling
 
 ## Features
 
@@ -139,7 +140,8 @@ with arcadedb.create_database("/tmp/mydb") as db:
 
 ## Package Coverage
 
-These bindings provide **comprehensive coverage** of ArcadeDB's Java API, focusing on features most relevant to Python developers:
+These bindings provide **comprehensive coverage** of ArcadeDB's Java API, focusing on
+features most relevant to Python developers:
 
 | Module | Coverage | Description |
 |--------|----------|-------------|
@@ -176,27 +178,27 @@ import arcadedb_embedded as arcadedb
 
 <div class="grid cards" markdown>
 
--   :material-download:{ .lg .middle } [__Install__](getting-started/installation.md)
+-   :material-download:{ .lg .middle } [**Install**](getting-started/installation.md)
 
     Installation instructions
 
--   :material-run-fast:{ .lg .middle } [__Quick Start__](getting-started/quickstart.md)
+-   :material-run-fast:{ .lg .middle } [**Quick Start**](getting-started/quickstart.md)
 
     Get up and running in 5 minutes
 
--   :material-book-open-variant:{ .lg .middle } [__User Guide__](guide/core/database.md)
+-   :material-book-open-variant:{ .lg .middle } [**User Guide**](guide/core/database.md)
 
     Comprehensive guide to all features
 
--   :material-api:{ .lg .middle } [__API Reference__](api/database.md)
+-   :material-api:{ .lg .middle } [**API Reference**](api/database.md)
 
     Detailed API documentation
 
 </div>
 
 ## Requirements
 
-- **Python**: 3.10–3.14 (packaged; primary testing on 3.11)
+- **Python**: 3.10–3.14 (packaged; primary testing on 3.12)
 - **OS**: Linux, macOS, or Windows (x86_64 or ARM64)
 
 !!! note "Self-Contained"
diff --git a/bindings/python/docs/java-api-coverage.md b/bindings/python/docs/java-api-coverage.md
diff --git a/bindings/python/examples/benchmark-vector/run_with_memory_monitor.sh b/bindings/python/examples/benchmark-vector/run_with_memory_monitor.sh
diff --git a/bindings/python/examples/run_with_memory_monitor.sh b/bindings/python/examples/run_with_memory_monitor.sh
