Struct EmbeddedClient 

pub struct EmbeddedClient { /* private fields */ }

In-process handle to a RedDB engine.

Implementations

impl EmbeddedClient

pub fn open(path: PathBuf) -> Result<Self>

Open a persistent database at path.

pub fn in_memory() -> Result<Self>

Open an ephemeral, tempfile-backed database. Equivalent to connect("memory://").

pub fn query(&self, sql: &str) -> Result<QueryResult>

pub fn query_with<P: IntoParams>( &self, sql: &str, params: P, ) -> Result<QueryResult>

Parameterized embedded query — see crate::Reddb::query_with. Empty params short-circuits to the legacy execute_query fast path so the parameter-less hot path pays zero overhead.

pub fn execute_with<P: IntoParams>( &self, sql: &str, params: P, ) -> Result<QueryResult>

Parameterized execution for INSERT / UPDATE / DELETE. RedDB uses the same result envelope for DML as for SELECT, so this forwards to Self::query_with.

pub fn insert( &self, collection: &str, payload: &JsonValue, ) -> Result<InsertResult>

Single-row insert. Routes through the same runtime.create_rows_batch_columnar port that Self::bulk_insert uses (#110), passing a one-row batch. Skips build_insert_sql + execute_query, so this hot autocommit path pays zero SQL build / lex / parse / plan cost when the collection carries no contract.

pub fn bulk_insert( &self, collection: &str, payloads: &[JsonValue], ) -> Result<BulkInsertResult>

Routes through runtime.create_rows_batch_columnar, which fast-paths to the prevalidated columnar kernel when the collection carries no contract — same shape MSG_BULK_INSERT_BINARY already uses on the wire path. Result: one WAL append per batch instead of one per row, no per-row SQL build / lex / parse / plan, and no per-row (String, Value) tuple materialisation when the collection is contract-free.

Heterogeneous payloads (rows with differing key sets) fall back to the per-row execute_query path so existing semantics are preserved for callers that mix shapes.

pub fn delete(&self, collection: &str, id: &str) -> Result<u64>

pub fn close(&self) -> Result<()>

pub fn version() -> &'static str

Trait Implementations

impl Debug for EmbeddedClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.