joaoh82 / rust_sqlite / 25655926923

69%

push

github

feat(sdk): Phase 11.8 multi-handle SDK shape (SQLR-22) (#129)

Closes the end-to-end gap from 11.7. The retry-error machinery
(BusyError / errorKind / ErrBusy) was reachable through every
SDK after 11.7 — but each `sqlrite.connect()` / `new Database()`
/ `sql.Open()` built an *isolated* backing DB, so the retry
idioms were untriggerable. This slice exposes the engine's
`Connection::connect()` through the public SDK surfaces so apps
can finally mint sibling handles that share state.

Picked ahead of plan-doc 11.5 (durability) for the same reason
11.5–11.7 jumped the queue: visible user value first. After
this PR, the canonical `BEGIN CONCURRENT` retry loop pattern
works end-to-end through Python and Node.

C FFI ([`sqlrite-ffi/src/lib.rs`]):
- new `sqlrite_connect_sibling(existing, out)` function. Thin
  wrapper around the engine's `Connection::connect`. Sibling has
  its own pointer + lifecycle but shares Database state.
- header regenerated via build.rs.
- 2 new tests: connect_sibling_mints_a_handle_that_shares_state
  (real cross-handle BEGIN CONCURRENT conflict through the public
  API) and connect_sibling_rejects_null_inputs.

Python SDK ([`sdk/python/src/lib.rs`]):
- new `Connection.connect()` instance method. Acquires the
  inner Mutex<RustConnection>, calls `inner.connect()`, wraps
  result in a fresh pyclass with its own Mutex. Inherits the
  parent's ask_config.
- 4 new tests: sibling sharing, outliving closed parent, raise on
  closed connect, and the headline busy-round-trip-via-siblings.

Node.js SDK ([`sdk/nodejs/src/lib.rs`]):
- new `Database.connect()` method on the napi-rs class. Same
  shape — sibling Database with its own RefCell + ask_config clone.
- 4 new tests including the cross-sibling BusyError round trip
  using 11.7's errorKind classifier.

Go SDK: deliberately skipped. database/sql's pool model already
gives sibling-like behavior across `db.Conn(ctx)` calls within a
single `sql.Open`, but exposing a *cross-pool* sibling shap... (continued)

0 of 21 new or added lines in 2 files covered. (0.0%)

10577 of 15500 relevant lines covered (68.24%)

1.23 hits per line