gemstone-py-native

Optional PyO3 extension for gemstone-py.

The extension exports gemstone_py_native._gci, which matches the Python gemstone_py._gci shim surface. The reusable GCI loader and raw ABI calls live in ../crates/gemstone-gci; this package is the thin PyO3 wrapper around that shared Rust core. It exposes a NativeGciLibrary object with Rust-backed GCI methods, releases the GIL around blocking GCI calls, and replaces hot OOP tag helpers with native implementations. Wheels are built with the Python 3.11 stable ABI.

The same extension also exposes the first additive gemstone-rs shared-core surface through RustCoreSession and rust_core_*_json() helpers. That path is backed by gemstone_rs::py_native and is intentionally separate from the existing _gci compatibility API, so existing gemstone-py backend selection keeps working while the Rust-core migration is proven in tests.

Direct Rust applications should use the separate gemstone-rs workspace. When checked out beside gemstone-py, it lives at ../../gemstone-rs from this directory. It provides the safe Rust Config and Session API over the same low-level GCI layer. Rust code imports it as gemstone_rs.

Build locally:

python -m pip install maturin
cd gemstone-py-native
maturin develop

Check the Rust-core handoff surface:

python - <<'PY'
from gemstone_py_native import _gci

print(_gci.rust_core_implementation())
print(_gci.rust_core_capabilities_json())
print(hasattr(_gci, "RustCoreSession"))
PY

Run the native Rust-core smoke:

python scripts/run_native_rust_core_live_smoke.py --dry-run
GS_RUN_LIVE=1 python scripts/run_native_rust_core_live_smoke.py --require-live

The dry run verifies the installed extension exposes RustCoreSession and the rust_core_*_json() reports. The live run logs in through gemstone_rs::py_native, checks 3 + 4 == 7, performs printString, resolves Object, round-trips a string, writes and aborts a temporary global, and logs out.

Package wheels:

cd gemstone-py-native
maturin build --release

Run the direct Rust example:

cd ../../gemstone-rs
cargo run -p gemstone-rs --example eval

The repository workflow Native Wheels builds platform wheels for Linux x86_64, Linux aarch64, Linux ARMv7, macOS x86_64, macOS aarch64, Windows x86_64, and Windows ARM64. Manual workflow runs can publish the merged wheel set to TestPyPI or PyPI using trusted publishing. The workflow also builds the generated native sdist back into a wheel before uploading it, so missing source files fail before publish.