Struct BindingEntry 

pub struct BindingEntry {
    pub path: String,
    pub default: Option<Value>,
    pub lazy: bool,
}

Unified with entry - supports both string and extended object syntax

String syntax: task.path [?? default]

• path: “task.field.subfield” or “task” for entire output
• default: Optional JSON literal after ??

Extended syntax (YAML object):

• path: “task.field” (required)
• lazy: bool (optional, default false)
• default: JSON value (optional)

Fields

path: String

Full path: “task.field.subfield” or “task” for entire output

default: Option<Value>

Optional default value (JSON literal)

lazy: bool

Lazy flag - if true, resolution is deferred until first access

Implementations

impl BindingEntry

pub fn new(path: impl Into<String>) -> BindingEntry

Create a new BindingEntry with just a path (eager resolution)

pub fn with_default(path: impl Into<String>, default: Value) -> BindingEntry

Create a new BindingEntry with path and default (eager resolution)

pub fn new_lazy(path: impl Into<String>) -> BindingEntry

Create a new lazy BindingEntry (deferred resolution)

pub fn lazy_with_default( path: impl Into<String>, default: Value, ) -> BindingEntry

Create a new lazy BindingEntry with default (deferred resolution)

pub fn is_lazy(&self) -> bool

Check if this binding is lazy (deferred resolution)

pub fn task_id(&self) -> &str

Extract the task ID from the path (first segment before ‘.’)

pub fn normalize_path(path: &str) -> &str

Normalize a binding path by stripping the $ prefix if present.

This enables implicit output reference syntax where $task is syntactic sugar for task. The RunContext.resolve_path() function already handles resolving bare task IDs to their full output.

Examples

use nika_core::binding::BindingEntry;

assert_eq!(BindingEntry::normalize_path("$task1"), "task1");
assert_eq!(BindingEntry::normalize_path("task1"), "task1");
assert_eq!(BindingEntry::normalize_path("$my_task"), "my_task");
assert_eq!(BindingEntry::normalize_path("task.field"), "task.field");
assert_eq!(BindingEntry::normalize_path("$task.field"), "task.field");

Trait Implementations

impl Clone for BindingEntry

fn clone(&self) -> BindingEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BindingEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BindingEntry

Custom deserializer for BindingEntry

Accepts two formats:

1. String: task.path [?? default] → eager binding
2. Object: {path: "task.path", lazy: true, default: ...} → lazy binding

fn deserialize<D>( deserializer: D, ) -> Result<BindingEntry, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for BindingEntry

fn eq(&self, other: &BindingEntry) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for BindingEntry