feat: Add Hash Index Exact-Match Lookup example and update workflows

Author: tae898

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

@@ -25,7 +25,7 @@ on:
         description: "Glob pattern(s) for examples to run (space-separated, relative to bindings/python/examples)."
         required: false
         type: string
-        default: "0[1-9]_*.py 1[0-7]_*.py"
+        default: "0[1-9]_*.py 1[0-9]_*.py"
       build-version:
         description: "Override package version (PEP 440) for build.sh"
         required: false
@@ -37,10 +37,10 @@ on:
       examples:
         description: "Glob pattern(s) for examples to run (space-separated, relative to bindings/python/examples)."
         required: false
-        default: "0[1-9]_*.py 1[0-7]_*.py"
+        default: "0[1-9]_*.py 1[0-9]_*.py"
 
 env:
-  EXAMPLES: ${{ inputs.examples || '0[1-9]_*.py 1[0-7]_*.py' }}
+  EXAMPLES: ${{ inputs.examples || '0[1-9]_*.py 1[0-9]_*.py' }}
 
 permissions:
   contents: read
@@ -402,6 +402,12 @@ jobs:
                 timeout_duration=900
                 example_jvm_args=""
                 ;;
+              "19_hash_index_exact_match.py")
+                example_args=""
+                example_name="$example (hash index exact-match workflow)"
+                timeout_duration=900
+                example_jvm_args=""
+                ;;
               *)
                 example_args=""
                 example_name="$example"

bindings/python/docs/examples/19_hash_index_exact_match.md

@@ -0,0 +1,57 @@
+# 19 - Hash Index Exact-Match Lookup Workflow
+
+[View source code]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/bindings/python/examples/19_hash_index_exact_match.py){ .md-button }
+
+This example demonstrates a fuller HASH index workflow that mirrors several of the
+behaviors already covered by the Java engine tests:
+
+- creating a unique HASH index with `UNIQUE_HASH`
+- creating non-unique HASH indexes with `NOTUNIQUE_HASH`
+- creating composite HASH indexes for multi-column exact matches
+- inserting deterministic product and warehouse inventory records
+- running equality lookups against single-property and composite HASH indexes
+- inspecting HASH index metadata from the Python schema API
+- verifying missing-key behavior
+- updating indexed values and verifying HASH index maintenance
+- showing duplicate-key rejection plus rollback semantics
+- closing and reopening the database to verify index persistence
+
+## Run
+
+From `bindings/python/examples`:
+
+```bash
+python3 19_hash_index_exact_match.py
+```
+
+With a custom database path:
+
+```bash
+python3 19_hash_index_exact_match.py --db-path ./my_test_databases/hash_index_demo
+```
+
+## Notes
+
+- The example is intentionally SQL-first.
+- HASH indexes are the right fit for exact-match predicates such as `sku = ?`, `category
+  = ?`, or `(warehouse = ? AND sku = ?)`.
+- For range predicates or ordered scans, prefer `UNIQUE` / `NOTUNIQUE` `LSM_TREE`
+  indexes instead.
+- If the packaged runtime does not include HASH index support, the script prints a short
+  explanation and exits.
+- The example intentionally includes a reopen phase so persisted HASH index metadata and
+  exact-match lookups are exercised in a fresh database session.
+
+## Why This Example Exists
+
+The Java engine already has focused HASH index coverage for:
+
+- SQL creation via `UNIQUE_HASH` and `NOTUNIQUE_HASH`
+- unique and non-unique lookup behavior
+- composite HASH keys
+- missing-key behavior
+- duplicate-key rejection
+- persistence across reopen
+
+This Python example mirrors that behavior with the public bindings API so the examples
+set includes a dedicated exact-match index workflow.

bindings/python/docs/examples/index.md

@@ -64,6 +64,9 @@ Four-way graph-ingest comparison. Repository guidance from these experiments is
 **[17 - Time Series End-to-End](17_timeseries_end_to_end.md)**
 SQL-first time-series workflow covering type creation, tagged inserts, range queries, and hourly bucket aggregation.
 
+**[19 - Hash Index Exact-Match Lookup Workflow](19_hash_index_exact_match.md)**
+SQL-first HASH index workflow covering unique and non-unique exact-match lookups, schema inspection, and duplicate-key rejection.
+
 ## Quick Start
 
 **⚠️ Important: Always run examples from the `examples/` directory.**
@@ -87,6 +90,7 @@ python 01_simple_document_store.py
 10. **Hybrid Queries** (13) - Combined SQL, graph, and vector workflow
 11. **Lifecycle And Ingest Benchmarks** (14/15/16) - Embedded lifecycle timing and ingest comparisons
 12. **Time Series SQL Workflow** (17) - Tagged samples, range queries, and bucket aggregation from Python
+13. **Hash Index Workflow** (19) - Exact-match HASH indexes, missing-key behavior, and duplicate protection
 
 ---