Struct WhenEnv 

pub struct WhenEnv<'a> {
    pub facts: &'a FactValues,
    pub vars: &'a HashMap<String, String>,
    pub iter: Option<IterEnv<'a>>,
    pub env: Option<&'a HashMap<String, String>>,
}

Fields

facts: &'a FactValues

vars: &'a HashMap<String, String>

iter: Option<IterEnv<'a>>

Per-iteration context, populated when this WhenEnv gates an iterated rule (for_each_dir / for_each_file / every_matching_has). None for top-level rule gating, where iter.* references resolve to falsy / null per the “unknown fact is falsy” convention.

env: Option<&'a HashMap<String, String>>

Optional environment-variable snapshot backing the env.* namespace. None — the production default — means the evaluator reads the live process environment via std::env::var (env is constant during a run, so the eval-time read matches a load-time snapshot). Tests inject a fake map via WhenEnv::with_env so they never touch the real environment (Rust 2024 marks set_var unsafe).

Implementations

impl<'a> WhenEnv<'a>

pub fn new(facts: &'a FactValues, vars: &'a HashMap<String, String>) -> Self

Construct a WhenEnv without iteration context — the shape every existing call site uses. iter.* references in the expression resolve to null / false; env.* reads the live process environment.

pub fn with_iter(self, iter: IterEnv<'a>) -> Self

Attach an iteration context. The same WhenEnv shape can then evaluate iter.path, iter.basename, and iter.has_file(...) against the supplied path + index.

pub fn with_env(self, env: &'a HashMap<String, String>) -> Self

Back the env.* namespace with an explicit map instead of the live process environment. Used by tests to resolve env.X hermetically.

Trait Implementations

impl<'a> Debug for WhenEnv<'a>

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

Formats the value using the given formatter.