Struct ResolvedBindings 

pub struct ResolvedBindings { /* private fields */ }

Resolved bindings from with: block (alias -> value or pending)

Uses FxHashMap for faster hashing on small string keys. Supports both eager and lazy bindings. Also provides from_with_spec() for the typed binding system.

Implementations

impl ResolvedBindings

pub fn new() -> Self

Create empty bindings

pub fn from_binding_spec( binding_spec: Option<&BindingSpec>, datastore: &RunContext, ) -> Result<Self, NikaError>

Build bindings from with: block by resolving paths from datastore

Unified resolution for both syntax styles:

• String: task.path [?? default] → eager resolution
• Object: {path, lazy?, default?} → lazy or eager based on flag

Lazy bindings are stored as Pending and resolved on first access. Eager bindings are resolved immediately and fail if source is missing.

Returns empty bindings if binding_spec is None.

pub fn from_with_spec( with_spec: Option<&WithSpec>, datastore: &RunContext, ) -> Result<Self, NikaError>

Build bindings from with: spec by resolving typed BindingPaths

Resolution order per entry:

1. Dispatch by BindingSource (Task/Input/Context/Env)
2. Navigate PathSegments for nested value access
3. Apply TransformExpr pipeline (if present)
4. Apply default value (if result is null/missing)
5. Validate BindingType constraint

Lazy bindings are stored as PendingWithEntry for later resolution.

pub fn from_with_spec_traced( with_spec: Option<&WithSpec>, datastore: &RunContext, task_id: &Arc<str>, ) -> Result<(Self, Vec<EventKind>), NikaError>

Build bindings from with: spec with event collection for telemetry.

Same as from_with_spec but collects binding events (defaults applied, transforms executed, env vars resolved) for the caller to emit.

pub fn set(&mut self, alias: impl Into<String>, value: Value)

Set a resolved value (always eager)

pub fn set_with_source( &mut self, alias: impl Into<String>, value: Value, source_task_id: impl Into<String>, )

Set a resolved value with source task ID tracking.

Use this when the binding originates from a task output, so that media path resolution (e.g., {{with.alias.media[0].hash}}) can trace back to the correct task’s media refs.

pub fn source_task_id(&self, alias: &str) -> Option<&str>

Get the source task ID for a binding alias.

Returns Some("gen_img") when the binding was img: $gen_img. Used by artifact processor to resolve media paths and binary artifact sources.

pub fn get(&self, alias: &str) -> Option<&Value>

Get a resolved value (only works for already-resolved bindings)

For lazy bindings that haven’t been resolved yet, returns None. Use get_resolved() to force resolution of lazy bindings.

pub fn get_resolved( &self, alias: &str, datastore: &RunContext, ) -> Result<Value, NikaError>

Get a resolved value, resolving lazy bindings on demand

For eager bindings, returns the pre-resolved value. For lazy bindings, resolves from datastore on first call.

Note: This doesn’t cache the resolution - each call re-resolves. This is intentional to support changing datastore values.

pub fn is_lazy(&self, alias: &str) -> bool

Check if a binding is lazy (pending resolution)

pub fn is_empty(&self) -> bool

Check if context has any bindings

pub fn iter(&self) -> impl Iterator<Item = (&str, &Value)>

Iterate over resolved bindings (alias, value pairs)

Only returns already-resolved bindings. Pending lazy bindings are skipped. Use this for event logging where we want to capture resolved values.

pub fn to_value(&self) -> Value

Serialize context to JSON Value for event logging

Returns the full resolved inputs as a JSON object. Lazy bindings that haven’t been resolved are represented as marker objects. Used by EventLog for TaskStarted events (inputs field).

Trait Implementations

impl Clone for ResolvedBindings

fn clone(&self) -> ResolvedBindings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResolvedBindings

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

Formats the value using the given formatter.

impl Default for ResolvedBindings

fn default() -> ResolvedBindings

Returns the “default value” for a type.