docs: Replace hardcoded gRPC references with jar_exclusions.txt

- Update workflow files to reference jar_exclusions.txt instead of specific exclusions
- Update build scripts and Dockerfile to use generic exclusion language
- Update all documentation files to point to jar_exclusions.txt
- Makes documentation more maintainable when exclusions change
- Files updated: test workflow, Dockerfile.build, setup_jars.py, build.sh, README.md, distributions.md, troubleshooting.md, contributing.md

Author: tae898

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

@@ -264,7 +264,7 @@ jobs:
           fi
 
           echo "- **Platform**: ${{ matrix.platform }}" >> $GITHUB_STEP_SUMMARY
-          echo "- **Features**: All ArcadeDB features except gRPC wire protocol" >> $GITHUB_STEP_SUMMARY
+          echo "- **Features**: All ArcadeDB features (some JARs excluded, see jar_exclusions.txt)" >> $GITHUB_STEP_SUMMARY
 
       - name: Upload test results
         if: always()

bindings/python/Dockerfile.build

@@ -1,6 +1,6 @@
 # Docker build for ArcadeDB Python package
 # Builds arcadedb-embedded package with bundled JRE (no external Java required)
-# Uses original ArcadeDB distribution but excludes gRPC wire protocol to optimize size
+# Excludes JARs listed in jar_exclusions.txt to optimize size
 #
 # REQUIRED BUILD ARGS (passed from build.sh):
 #   PACKAGE_NAME - always: arcadedb-embedded
@@ -15,7 +15,7 @@ ARG ARCADEDB_TAG=25.10.1-SNAPSHOT
 ARG TARGET_PLATFORM=linux-x64
 
 # Stage 1: Use prebuilt ArcadeDB image to obtain compiled JARs
-# We use the original distribution and selectively exclude only gRPC for Python use cases
+# JARs are filtered based on jar_exclusions.txt in later stages
 FROM arcadedata/arcadedb:${ARCADEDB_TAG} AS java-builder
 
 # nothing to do here; jars will be copied from /home/arcadedb/lib in the python-builder stage

bindings/python/README.md

@@ -87,7 +87,7 @@ The `arcadedb-embedded` package (162MB wheel, ~240MB installed) includes everyth
 - **Bundled JRE** (~39MB): Custom Java 21 runtime (jlink, 21 modules)
 - **Total:** 162MB compressed wheel, ~240MB when installed
 
-**Note**: gRPC wire protocol is excluded to keep package size manageable. We may add it in future versions if needed.
+**Note**: Some JARs are excluded to optimize package size. See `jar_exclusions.txt` for details.
 
 Import: `import arcadedb_embedded as arcadedb`
 
@@ -132,7 +132,7 @@ Supported platforms: `linux/amd64`, `linux/arm64`, `darwin/amd64`, `darwin/arm64
 > **Note:** `linux/arm64` uses QEMU emulation for builds. Additional platforms like `windows/arm64` may be added in future releases if demand justifies it.
 
 !!! note "Package Contents"
-    The package includes all ArcadeDB features except gRPC wire protocol. We don't need gRPC at this moment, and we might add it in future versions if needed.
+    The package includes optimized ArcadeDB JARs. Some components are excluded for size optimization - see `jar_exclusions.txt` for details.
 
 !!! note "Versioning"
     Versions are automatically extracted from the main ArcadeDB `pom.xml`. See [versioning strategy](https://humemai.github.io/arcadedb-embedded-python/latest/development/release/#python-versioning-strategy) for details on development vs release mode handling.

bindings/python/build.sh

@@ -48,7 +48,7 @@ print_usage() {
     echo ""
     echo "Package features:"
     echo "  ✅ Bundled platform-specific JRE (no Java required)"
-    echo "  ✅ All ArcadeDB features except gRPC wire protocol"
+    echo "  ✅ Optimized JAR selection (see jar_exclusions.txt)"
     echo "  ✅ Multi-platform support (5 platforms)"
     echo "  📦 Size: ~160MB (JRE ~63MB, JARs ~13MB, overhead ~84MB)"
     echo ""

bindings/python/docs/development/contributing.md

@@ -139,7 +139,7 @@ arcadedb/bindings/python/
 
 1. Extracts ArcadeDB version from parent `pom.xml`
 2. Downloads appropriate JAR files with custom filtering
-3. Packages Python code with optimized JARs (excludes only gRPC)
+3. Packages Python code with optimized JARs (see `jar_exclusions.txt`)
 4. Runs tests in isolated Docker environment
 5. Creates wheel file in `dist/`
 

bindings/python/docs/development/troubleshooting.md

@@ -51,7 +51,7 @@ pip uninstall -y arcadedb-embedded arcadedb-embedded-headless arcadedb-embedded-
 
 Then install the current package:
 ```bash
-# Current package (~123MB, includes all features except gRPC)
+# Current package (~123MB with optimized JARs, see jar_exclusions.txt)
 pip install arcadedb-embedded
 ```
 

bindings/python/docs/getting-started/distributions.md

@@ -50,11 +50,9 @@ All platforms include a platform-specific bundled JRE - no external Java require
 - ✅ **Vector Search**: HNSW indexing for embeddings
 - ✅ **Data Import**: CSV, JSON, Neo4j importers
 
-**Not Included:**
+**Optimized:**
 
-- ❌ **gRPC Wire Protocol**: Excluded to keep package size manageable
-
-We don't need gRPC at this moment, and we might add it in future versions if needed.
+- Some components are excluded to keep package size manageable (see `jar_exclusions.txt` for details)
 
 ## Test Results
 
@@ -64,9 +62,7 @@ We don't need gRPC at this moment, and we might add it in future versions if nee
 - ✅ SQL, Cypher, and Gremlin queries work
 - ✅ HTTP server and Studio UI work
 - ✅ Vector search and import operations work
-- ✅ All features available except gRPC
-
-## Use Cases
+- ✅ All included features validated
 
 ## Use Cases
 
@@ -119,7 +115,7 @@ Total package size: **162MB wheel (~240MB installed)**
 - **Compressed wheel**: 162 MB
 - **Installed size**: ~240 MB
 
-**Note**: gRPC wire protocol is excluded to keep package size manageable.
+**Note**: Some components are excluded to optimize package size (see `jar_exclusions.txt` for details).
 
 ## Installation Tips
 

bindings/python/setup_jars.py

@@ -83,7 +83,7 @@ def find_jar_files():
         print(f"   Excluded: {len(excluded_jars)}")
 
         if excluded_jars:
-            print("\n❌ Excluded JARs (gRPC protocol not needed):")
+            print("\n❌ Excluded JARs:")
             for jar in excluded_jars:
                 jar_name = Path(jar).name
                 size_mb = Path(jar).stat().st_size / 1024 / 1024