Struct ContainedShell 

pub struct ContainedShell { /* private fields */ }

TableShell over a contained relation’s in-memory records.

Reads delegate to the seeded ImTable; writes apply to it and then flush the whole collection through ContainedWriteback. Holds no parent handle itself — the writeback closure captures whatever the host needs to patch the parent row.

Trait Implementations

impl TableShell for ContainedShell

fn get_ref(&self, relation: &str, row: &Record<CborValue>) -> Result<Vista>

Resolve a relation of the contained record (e.g. a line’s product) through the host-supplied resolver, back into the real table.

fn columns(&self) -> &IndexMap<String, Column>

fn references(&self) -> &IndexMap<String, Reference>

fn id_column(&self) -> Option<&str>

fn list_vista_values<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, ) -> Pin<Box<dyn Future<Output = Result<IndexMap<String, Record<CborValue>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn get_vista_value<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _vista: &'life1 Vista, id: &'life2 String, ) -> Pin<Box<dyn Future<Output = Result<Option<Record<CborValue>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn get_vista_some_value<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, ) -> Pin<Box<dyn Future<Output = Result<Option<(String, Record<CborValue>)>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn get_vista_count<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, ) -> Pin<Box<dyn Future<Output = Result<i64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Default impl falls back to list_vista_values — drivers with native count (SELECT COUNT(*), etc.) override.

fn insert_vista_value<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _vista: &'life1 Vista, id: &'life2 String, record: &'life3 Record<CborValue>, ) -> Pin<Box<dyn Future<Output = Result<Record<CborValue>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

fn insert_vista_return_id_value<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _vista: &'life1 Vista, record: &'life2 Record<CborValue>, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn replace_vista_value<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _vista: &'life1 Vista, id: &'life2 String, record: &'life3 Record<CborValue>, ) -> Pin<Box<dyn Future<Output = Result<Record<CborValue>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

fn patch_vista_value<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _vista: &'life1 Vista, id: &'life2 String, partial: &'life3 Record<CborValue>, ) -> Pin<Box<dyn Future<Output = Result<Record<CborValue>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

fn delete_vista_value<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _vista: &'life1 Vista, id: &'life2 String, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn delete_vista_all_values<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn capabilities(&self) -> &VistaCapabilities

fn driver_name(&self) -> &'static str

Short human label for the underlying driver (e.g. "csv", "sqlite", "postgres", "mongodb"). Used for diagnostics and CLI output. Drivers should override; the default is a placeholder.

fn get_vista_value_with_row<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, vista: &'life1 Vista, id: &'life2 String, _row: &'life3 Record<CborValue>, ) -> Pin<Box<dyn Future<Output = Result<Option<Record<CborValue>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Fetch one record by id, with the caller’s existing (cheap) record available to drivers that can use it (e.g. a cmd detail script reading list-pass columns). The default ignores row and delegates to get_vista_value; only drivers that benefit override it.

fn stream_vista_values<'a>( &'a self, vista: &'a Vista, ) -> Pin<Box<dyn Stream<Item = Result<(String, Record<CborValue>)>> + Send + 'a>>

where Self: Sync,

Default implementation wraps list_vista_values. Drivers with native streaming (cursor-based queries, paginated REST APIs) override.

fn aggregate_vista( &self, _vista: &Vista, _spec: &AggregateSpec, ) -> Result<Option<Vista>>

Derive a new vista that reduces this one — the driver’s equivalent of selecting from a subquery.

fn add_eq_condition(&mut self, _field: &str, _value: &CborValue) -> Result<()>

Translate field == value into the driver’s native condition type and apply it to the wrapped table. The default impl returns Unimplemented — every driver is expected to override.

fn add_op_condition( &mut self, field: &str, op: FilterOp, value: &CborValue, ) -> Result<()>

Translate field <op> value into the driver’s native condition and apply it. The default routes Eq to add_eq_condition (so every driver gets equality for free) and returns Unimplemented for every richer operator. Drivers whose query language expresses the operators (SQL, SurrealDB) override this and advertise can_filter_operators; consumers that see false skip the call and filter locally instead.

fn add_raw_condition( &mut self, _condition: Box<dyn Any + Send + Sync>, ) -> Result<()>

Push a driver-native condition into the wrapped table. The caller boxes the condition as dyn Any and the driver downcasts to its own T::Condition. Used by YAML-driven relation traversal, where the factory constructs a DeferredFn-bearing condition outside the value-set surface (which only accepts scalar eq) and pushes it through this channel. Default is Unimplemented.

fn set_page_size(&mut self, _size: usize) -> Result<()>

Declare how many records constitute one page. Used by both fetch_page and fetch_next. Default returns default_error("set_page_size", "can_set_page_size").

fn fetch_page<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, _page: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<(String, Record<CborValue>)>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch a specific page (1-based) using offset-style pagination. The per-page count comes from the most recent set_page_size.

fn fetch_next<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, _token: Option<CborValue>, ) -> Pin<Box<dyn Future<Output = Result<(Vec<(String, Record<CborValue>)>, Option<CborValue>)>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Cursor-style chain fetch. Pass None on the first call; pass the previous call’s returned token on subsequent calls. Returned token is None when the result set is exhausted.

fn fetch_window<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, _offset: usize, _limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<(String, Record<CborValue>)>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch the half-open row window [offset, offset + limit) in the source’s natural order. Offset-style like fetch_page but addressed by absolute row index rather than page number, so it maps directly onto a diorama on_load_chunk Range<usize> — which is not guaranteed page-aligned. This is the primitive a paged, lazily-loaded grid drives on scroll.

fn fetch_window_counted<'life0, 'life1, 'async_trait>( &'life0 self, vista: &'life1 Vista, offset: usize, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<(Vec<(String, Record<CborValue>)>, Option<i64>)>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fetch_window, plus the grand total of matching rows when this fetch already learned it.

fn add_search(&mut self, _text: &str) -> Result<()>

Apply a quicksearch filter — a single string the driver fans out across the columns it considers searchable (typically those flagged SEARCHABLE, but each driver decides).

fn clear_search(&mut self) -> Result<()>

Drop the search filter previously applied via add_search. Default mirrors add_search.

fn add_order(&mut self, _field: &str, _dir: SortDirection) -> Result<()>

Push a single ORDER BY clause onto the wrapped table.

fn clear_orders(&mut self) -> Result<()>

Wipe every order clause. Default mirrors add_order.

fn clone_shell(&self) -> Option<Box<dyn TableShell>>

Produce an independent copy of this shell, or None if the driver can’t be cloned cheaply. The copy must share the backing store / connection (typically Arc) but own its own query state (conditions / order / search) so a caller can narrow it — set an ORDER BY, add a WHERE — without disturbing the original. This is how a consumer builds a per-view ordered Vista to fetch from: clone_shell() → add_order(...) → fetch_window.

fn get_ref_target(&self, relation: &str) -> Result<Vista>

Build the bare target of a same-persistence relation as a Vista — the table a new related row would be inserted into, with no join condition applied. Used by Vista’s nested insert to reach a has-one / has-many child’s destination.

fn contained(&self) -> &IndexMap<String, ContainedSpec>

Contained (embedded-in-row) relations this shell exposes, keyed by name. Default empty — only shells that model embedded objects/arrays override.

fn get_contained_ref( &self, relation: &str, _row: &Record<CborValue>, ) -> Result<Vista>

Resolve a contained relation against a known parent row, returning the embedded records as a sub-Vista. Writes to that sub-Vista patch the host column of row’s record back through the shell. Default returns Unimplemented; shells override to seed crate::build_contained_vista with a writeback that patches the parent.

fn get_ref_kinds(&self) -> Vec<(String, ReferenceKind)>

Names + cardinalities of the shell’s same-persistence references. Derived from references by default; impls should rarely need to override.

fn watch_vista<'life0, 'life1, 'async_trait>( &'life0 self, _vista: &'life1 Vista, ) -> Pin<Box<dyn Future<Output = Result<VistaChangeStream>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Subscribe to changes on the set and stream them as VistaChanges.

fn capability_flag(&self, name: &str) -> bool

Look up a capability flag by name. Used by default_error to decide between Unsupported and Unimplemented. Drivers don’t normally need to override this.

fn default_error(&self, method: &str, capability: &str) -> VantageError

Build the standard error returned by default trait method impls.