Struct TraversingDispenser 

pub struct TraversingDispenser { /* private fields */ }

Wraps an inner OpDispenser with result traversal and optional capture extraction.

This is the default wrapper, always applied unless disabled. It ensures that:

1. The result body is fully consumed (element/byte counting)
2. Captures are extracted from the result (if declared)
3. Traversal metrics are recorded

Implementations

impl TraversingDispenser

pub fn wrap( inner: Arc<dyn OpDispenser>, template: &ParsedOp, stats: Arc<TraversalStats>, ) -> Arc<dyn OpDispenser>

Wrap an inner dispenser with traversal.

Reads template.captures (the parse-time-extracted capture specs) directly. The op-template parser has already stripped [name] / [@name] brackets from the op text fields, so adapters see clean SQL/URL/body strings.

Trait Implementations

impl OpDispenser for TraversingDispenser

fn execute<'a>( &'a self, cycle: u64, ctx: &'a ExecCtx<'a>, ) -> Pin<Box<dyn Future<Output = Result<OpResult, ExecutionError>> + Send + 'a>>

Execute an operation for the given cycle.

fn inner_dispenser(&self) -> Option<&dyn OpDispenser>

Returns the wrapped dispenser when this is a wrapper, None when this is a leaf (the adapter’s base dispenser — e.g. CQL raw / prepared / batch, HTTP, stdout, plotter, …).

fn describe(&self) -> Option<String>

One-line description of the op this dispenser represents — typically the statement text / request shape with bind-point placeholders left unresolved ({table}, {key}, ?, …).

fn describe_resolved(&self, wires: &dyn WireSource) -> Option<String>

Render the actual op the dispenser would fire for the given cycle — the dryrun-equivalent view of the statement after every bind point is interpolated.

fn canonical_kernel(&self) -> Option<&Arc<dyn Kernel>>

SRD-68 invariant I-3 — the dispenser’s canonical Polydat Kernel, established at construction by map_op from its parent — the parent itself, or a kernel bound under it. Any engine: the executor finds the program to bind per fiber by program_id. Returns None for dispensers that don’t own a kernel (adapters with no Polydat needs, or wrappers that delegate to an inner dispenser).

fn adapter_metrics(&self) -> Vec<(String, Labels, MetricValue)>

Snapshot adapter-specific metrics for inclusion in the capture snapshot.

fn status_counters(&self) -> Vec<(&str, u64)>

Adapter-specific status line entries (cumulative, non-destructive read).

fn rows_per_op(&self) -> usize

The op’s uniform per-invocation cursor consumption — how many consecutive wire ordinals one execute call reads and covers.

impl WrappingDispenser for TraversingDispenser