docs: update test results to reflect 331 passed tests across documentation

Author: tae898

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**: 290 Passed | **Platforms**: 4 Supported
+**Status**: ✅ Production Ready | **Tests**: 331 Passed | **Platforms**: 4 Supported
 
 ---
 
@@ -92,7 +92,7 @@ Import: `import arcadedb_embedded as arcadedb`
 
 ## 🧪 Testing
 
-**Status**: 290 passed
+**Status**: 331 passed
 
 ```bash
 # Run all tests

bindings/python/docs/development/architecture.md

@@ -16,27 +16,39 @@ The ArcadeDB Python bindings are a **thin wrapper** around the ArcadeDB Java lib
 ```
 arcadedb_embedded/
 ├── __init__.py          # Package exports and version
-├── jvm.py               # JVM startup (bundled JRE, JAR discovery)
-├── core.py              # Database, DatabaseFactory, convenience helpers
-├── graph.py             # Document, Vertex, Edge wrappers
-├── schema.py            # Schema/Index/Property helpers
-├── type_conversion.py   # Java ↔ Python value conversion
+├── _logging.py          # Internal logging helpers
 ├── async_executor.py    # Async command/query + record wrapper
+├── citation.py          # Citation DOI helpers
+├── core.py              # Database, DatabaseFactory, convenience helpers
+├── exceptions.py        # ArcadeDBError (unified exceptions)
 ├── exporter.py          # Export (JSONL/GraphML/GraphSON + CSV helper)
-├── vector.py            # VectorIndex + array helpers
+├── graph.py             # Document, Vertex, Edge wrappers
+├── graph_batch.py       # High-throughput graph ingest wrapper
+├── importer.py          # Document import helpers and result payloads
+├── jvm.py               # JVM startup (bundled JRE, JAR discovery)
 ├── results.py           # ResultSet, Result (query results)
-├── transactions.py      # TransactionContext (ACID guard)
+├── schema.py            # Schema/Index/Property helpers
 ├── server.py            # ArcadeDBServer (HTTP/Studio)
-└── exceptions.py        # ArcadeDBError (unified exceptions)
+├── transactions.py      # TransactionContext (ACID guard)
+├── type_conversion.py   # Java ↔ Python value conversion
+└── vector.py            # VectorIndex + array helpers
 ```
 
 ### Module Responsibilities
 
 **`__init__.py`**
 
-- Central export surface (Database, AsyncExecutor, Schema, Exporter, VectorIndex, converters)
+- Central export surface (Database, AsyncExecutor, GraphBatch, Schema, Exporter, VectorIndex, converters, citation/import helpers)
 - Version metadata
 
+**`_logging.py`**
+
+- Internal logger access and swallowed-exception helpers for cleanup/finalizer paths
+
+**`citation.py`**
+
+- `cite()`: resolves version-specific DOI URLs for released Python package versions
+
 **`jvm.py`**
 
 - Starts JVM using bundled JRE and packaged JARs
@@ -56,6 +68,16 @@ arcadedb_embedded/
 - Record wrappers: `Document`, `Vertex`, `Edge`
 - Property helpers, `new_edge()`, type-aware wrapping from Java records
 
+**`graph_batch.py`**
+
+- `GraphBatch`: builder-backed high-throughput graph ingest API
+- Batch vertex/edge creation plus flush/close lifecycle helpers
+
+**`importer.py`**
+
+- `import_documents()`: narrow Python wrapper around document import flows
+- `ImportResult`: normalized import result payload and statistics accessor
+
 **`schema.py`**
 
 - `Schema`: type/property/index management

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

@@ -19,7 +19,7 @@ This document describes the build architecture for creating platform-specific Py
 
 **All supported platforms:**
 
-- ✅ Current suite: 290 passed
+- ✅ Current suite: 331 passed
 - ✅ 31.7M JARs (83 files, identical across platforms)
 - ✅ All native runners (no QEMU emulation)
 - ✅ Reproducible builds (pinned runner versions)

bindings/python/docs/development/ci-setup.md

@@ -102,7 +102,7 @@ All 4 platforms passing the bindings suite and example workflows:
 
 | Platforms | Wheel Size | JRE Size | Tests |
 |-----------|-----------|----------|-------|
-| linux/amd64, linux/arm64, darwin/arm64, windows/amd64 | ~70-75M | ~60M | 290 passed ✅ |
+| linux/amd64, linux/arm64, darwin/arm64, windows/amd64 | ~70-75M | ~60M | 331 passed ✅ |
 
 **All platforms include:**
 

bindings/python/docs/development/contributing.md

@@ -86,40 +86,55 @@ arcadedb/bindings/python/
 ├── src/
 │   └── arcadedb_embedded/        # Main package
 │       ├── __init__.py            # Package initialization
+│       ├── _logging.py            # Internal logging helpers
+│       ├── async_executor.py      # Async command/query execution
+│       ├── citation.py            # Citation DOI helpers
 │       ├── core.py                # Database, DatabaseFactory
-│       ├── server.py              # ArcadeDBServer
-│       ├── schema.py              # Schema management
+│       ├── exceptions.py          # Exception classes
+│       ├── exporter.py            # Data export (JSONL, GraphML, etc.)
+│       ├── graph.py               # Graph wrappers
+│       ├── graph_batch.py         # Bulk graph ingest helper
+│       ├── importer.py            # Import helpers
+│       ├── jvm.py                 # JVM startup logic
 │       ├── results.py             # Query result handling
+│       ├── schema.py              # Schema management
+│       ├── server.py              # ArcadeDBServer
 │       ├── transactions.py        # Transaction management
-│       ├── vector.py              # Vector search support
-│       ├── graph.py               # Graph wrappers
-│       ├── exporter.py            # Data export (JSONL, GraphML, etc.)
-│       ├── async_executor.py      # Async command/query execution
 │       ├── type_conversion.py     # Python-Java type conversion
-│       ├── exceptions.py          # Exception classes
-│       ├── jvm.py                 # JVM startup logic
-│       ├── _version.py            # Version info
-│       └── jars/                  # JAR files (bundled/downloaded)
+│       └── vector.py              # Vector search support
 ├── tests/
 │   ├── __init__.py
 │   ├── conftest.py                # pytest fixtures
 │   ├── README.md                  # Testing documentation
-│   ├── test_core.py               # Core tests
-│   ├── test_server.py             # Server tests
-│   ├── test_schema.py             # Schema tests
-│   ├── test_resultset.py          # Result handling tests
-│   ├── test_import_database.py    # Import database tests
-│   ├── test_exporter.py           # Exporter tests
-│   ├── test_vector.py             # Vector search tests
-│   ├── test_vector_sql.py         # Vector SQL tests
-│   ├── test_cypher.py             # OpenCypher tests
 │   ├── test_async_executor.py     # Async execution tests
-│   ├── test_type_conversion.py    # Type conversion tests
-│   ├── test_transaction_config.py # Transaction tests
 │   ├── test_concurrency.py        # Concurrency tests
+│   ├── test_core.py               # Core tests
+│   ├── test_cypher.py             # OpenCypher tests
 │   ├── test_database_utils.py     # Database utilities tests
+│   ├── test_docs_examples.py      # Docs example tests
+│   ├── test_exporter.py           # Exporter tests
+│   ├── test_geo_predicate_sql.py  # Geospatial SQL tests
+│   ├── test_graph_algorithms_sql.py # Graph algorithm SQL tests
+│   ├── test_graph_api.py          # Graph API tests
+│   ├── test_graph_batch.py        # GraphBatch tests
+│   ├── test_hash_index_schema.py  # HASH index schema tests
+│   ├── test_import_database.py    # Import database tests
+│   ├── test_importer_api.py       # Import helper tests
+│   ├── test_jvm_args.py           # JVM argument tests
+│   ├── test_logging_helper.py     # Logging helper tests
+│   ├── test_materialized_view_sql.py # Materialized view SQL tests
 │   ├── test_numpy_support.py      # NumPy integration tests
-│   └── test_server_patterns.py    # Server pattern tests
+│   ├── test_resultset.py          # Result handling tests
+│   ├── test_schema.py             # Schema tests
+│   ├── test_server.py             # Server tests
+│   ├── test_server_patterns.py    # Server pattern tests
+│   ├── test_timeseries_sql.py     # Timeseries SQL tests
+│   ├── test_transaction_config.py # Transaction tests
+│   ├── test_type_conversion.py    # Type conversion tests
+│   ├── test_vector.py             # Vector search tests
+│   ├── test_vector_sql.py         # Vector SQL tests
+│   ├── test_vector_params_verification.py # Vector parameter validation tests
+│   └── test_wheel_platform_tag.py # Wheel platform tag tests
 ├── docs/                          # MkDocs documentation
 │   ├── getting-started/
 │   ├── guide/

bindings/python/docs/development/testing.md

@@ -5,7 +5,7 @@ Comprehensive testing documentation for ArcadeDB Python bindings.
 !!! success "Test Coverage"
     Current bindings suite
 
-    - **Current package**: 290 passed
+    - **Current package**: 331 passed
     - All ArcadeDB features working (SQL, OpenCypher, Studio)
 
 ## Quick Navigation
@@ -188,22 +188,40 @@ pytest -v -rs
 
 ## Test Organization
 
+This is the current live test tree under `bindings/python/tests`. Exact test counts evolve, so this section lists files and responsibilities rather than hardcoding per-file totals.
+
 ```bash
 tests/
-├── test_core.py              # Core operations (13 tests)
-├── test_server.py            # Server mode (6 tests)
-├── test_concurrency.py       # Concurrency (4 tests)
-├── test_server_patterns.py   # Patterns (4 tests)
-├── test_graph_batch.py       # Bulk graph ingest helper
-├── test_graph_algorithms_sql.py  # shortestPath / dijkstra / astar
-├── test_geo_predicate_sql.py # Geospatial SQL predicates
-├── test_timeseries_sql.py    # Timeseries SQL coverage
-├── test_materialized_view_sql.py # Materialized view lifecycle
-├── test_hash_index_schema.py # HASH index schema API coverage
-├── test_import_database.py   # Import database tests
-├── test_docs_examples.py     # Validates runnable docs examples
-├── test_cypher.py            # OpenCypher (tests)
-└── conftest.py               # Shared fixtures
+├── conftest.py                         # Shared fixtures
+├── test_async_executor.py             # Async execution tests
+├── test_concurrency.py                # Concurrency tests
+├── test_core.py                       # Core operations
+├── test_cypher.py                     # OpenCypher tests
+├── test_database_utils.py             # Database utility tests
+├── test_docs_examples.py              # Runnable docs example tests
+├── test_exporter.py                   # Exporter tests
+├── test_geo_predicate_sql.py          # Geospatial SQL predicate tests
+├── test_graph_algorithms_sql.py       # shortestPath / dijkstra / astar
+├── test_graph_api.py                  # Graph API tests
+├── test_graph_batch.py                # Bulk graph ingest helper
+├── test_hash_index_schema.py          # HASH index schema tests
+├── test_import_database.py            # SQL import workflow tests
+├── test_importer_api.py               # Import helper wrapper tests
+├── test_jvm_args.py                   # JVM argument tests
+├── test_logging_helper.py             # Internal logging helper tests
+├── test_materialized_view_sql.py      # Materialized view lifecycle
+├── test_numpy_support.py              # NumPy integration tests
+├── test_resultset.py                  # Result handling tests
+├── test_schema.py                     # Schema tests
+├── test_server.py                     # Server tests
+├── test_server_patterns.py            # Embedded/server access patterns
+├── test_timeseries_sql.py             # Timeseries SQL coverage
+├── test_transaction_config.py         # Transaction config tests
+├── test_type_conversion.py            # Type conversion tests
+├── test_vector.py                     # Vector API tests
+├── test_vector_params_verification.py # Vector parameter validation tests
+├── test_vector_sql.py                 # Vector SQL tests
+└── test_wheel_platform_tag.py         # Wheel platform tag tests
 ```
 
 ## Next Steps

bindings/python/docs/development/testing/overview.md

@@ -5,7 +5,7 @@ The ArcadeDB Python bindings have a comprehensive test suite covering all major
 ## Quick Statistics
 
 !!! success "Test Results"
-    - **Current package**: ✅ 290 passed
+    - **Current package**: ✅ 331 passed
     - Environment-specific skips may vary depending on optional components
 
 ## What's Tested
@@ -75,12 +75,21 @@ Test counts evolve over time. For the latest per-file counts, run `pytest -v -rs
 
 | Test File | Description |
 | --------- | ----------- |
+| [`test_async_executor.py`](test-async-executor.md) | Async command/query execution and callback behavior |
+| [`test_core.py`](test-core.md) | Core database operations, CRUD, transactions, queries |
+| [`test_database_utils.py`](test-database-utils.md) | Database utility helpers and initialization behavior |
+| [`test_docs_examples.py`](test-docs-examples.md) | Executes representative Python snippets from the documentation site |
+| [`test_exporter.py`](test-exporter.md) | Database export formats and CSV result export helpers |
+| [`test_graph_api.py`](test-graph-api.md) | Graph wrapper behavior for vertices, edges, and traversal helpers |
+| [`test_importer_api.py`](test-importer.md) | Narrow `db.import_documents(...)` wrapper coverage |
+| [`test_numpy_support.py`](test-numpy-support.md) | NumPy integration and array conversion behavior |
+| [`test_resultset.py`](test-resultset.md) | Result and ResultSet iteration, accessors, and export helpers |
+| [`test_schema.py`](test-schema.md) | Schema, property, and index management behavior |
 | [`test_core.py`](test-core.md) | Core database operations, CRUD, transactions, queries |
 | [`test_server.py`](test-server.md) | Server mode, HTTP API, configuration |
 | [`test_concurrency.py`](test-concurrency.md) | File locking, thread safety, multi-process behavior |
 | [`test_server_patterns.py`](test-server-patterns.md) | Best practices for embedded + server mode |
 | [`test_import_database.py`](test-importer.md) | SQL `IMPORT DATABASE` scenarios and format coverage |
-| [`test_docs_examples.py`](test-docs-examples.md) | Executes representative Python snippets from the documentation site |
 | [`test_cypher.py`](test-opencypher.md) | OpenCypher query language |
 | [`test_graph_batch.py`](test-graph-batch.md) | Bulk graph-ingest helper coverage |
 | [`test_geo_predicate_sql.py`](test-geo-predicate-sql.md) | Geospatial SQL predicate semantics |
@@ -89,7 +98,11 @@ Test counts evolve over time. For the latest per-file counts, run `pytest -v -rs
 | [`test_graph_algorithms_sql.py`](test-graph-algorithms-sql.md) | SQL graph algorithm runtime coverage |
 | [`test_hash_index_schema.py`](test-hash-index-schema.md) | HASH index schema API behavior |
 | [`test_jvm_args.py`](test-jvm-args.md) | JVM args handling |
+| [`test_transaction_config.py`](test-transaction-config.md) | Transaction configuration and rollback semantics |
+| [`test_type_conversion.py`](test-type-conversion.md) | Python/Java type conversion coverage |
+| [`test_vector.py`](test-vector.md) | Vector API and nearest-neighbor search behavior |
 | [`test_vector_params_verification.py`](test-vector-params-verification.md) | Vector param validation |
+| [`test_vector_sql.py`](test-vector-sql.md) | SQL vector functions, index creation, and search flows |
 
 ## Common Testing Workflows
 
@@ -142,7 +155,7 @@ pytest -m "not slow"
 When the current bindings test suite passes, you should see a clean all-green summary.
 
 ```text
-======================== 290 passed ========================
+======================== 331 passed ========================
 ```
 
 ## Next Steps

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

@@ -37,7 +37,7 @@ Pre-built **platform-specific** wheels are available for **4 platforms**. Sizes
 - ✅ All platforms use **platform-specific wheels** (not universal)
 - ✅ uv pip automatically selects the correct wheel for your system
 - ✅ Each platform has its own bundled JRE optimized for that architecture
-- ✅ Current suite validated in the latest local run: 290 passed
+- ✅ Current suite validated in the latest local run: 331 passed
 - ✅ Built on native runners (no emulation) for optimal performance
 
 ## What's Included
@@ -59,7 +59,7 @@ Pre-built **platform-specific** wheels are available for **4 platforms**. Sizes
 
 ## Test Results
 
-The current bindings suite reports **290 passed** in a full local run:
+The current bindings suite reports **331 passed** in a full local run:
 
 - ✅ All core database operations
 - ✅ SQL and OpenCypher queries

bindings/python/docs/index.md

@@ -9,7 +9,7 @@
     Native Python bindings for ArcadeDB with comprehensive embedded/server coverage
 
     - **Status**: ✅ Production Ready
-    - **Tests**: ✅ 290 passed
+    - **Tests**: ✅ 331 passed
 
 -   :fontawesome-brands-python:{ .lg .middle } **Pure Python API**
 

bindings/python/tests/README.md

@@ -7,7 +7,7 @@ For detailed test documentation, examples, and best practices, see the **[Testin
 ## Quick Stats
 
 - Current bindings suite
-- ✅ **Current package**: 290 passed
+- ✅ **Current package**: 331 passed
 - Package includes all ArcadeDB features (SQL, OpenCypher, Studio)
 
 ## Running Tests