Struct Vars 

pub struct Vars { /* private fields */ }

A small key→value lookup used when expanding $VAR / ${VAR} references.

Vars is checked before falling back to an env lookup (the process environment by default), so callers can inject locally-scoped values (e.g. WORKSPACE) without leaking them into global state.

Implementations

impl Vars

pub fn new() -> Self

pub fn with_env_lookup( self, f: impl Fn(&str) -> Option<String> + Send + Sync + 'static, ) -> Self

Override the env-var fallback. Useful in tests to avoid mutating the process environment.

pub fn with(self, key: impl Into<String>, value: impl Into<String>) -> Self

pub fn insert( &mut self, key: impl Into<String>, value: impl Into<String>, ) -> &mut Self

pub fn get(&self, key: &str) -> Option<Cow<'_, str>>

pub fn expand(&self, template: &str) -> Result<String, VarError>

Expand $VAR / ${VAR} references in template, consulting self before the env lookup. $$ escapes to a literal $.

pub fn has_reference(&self, s: &str) -> bool

Returns true if s contains a $VAR or ${VAR} style reference.

Trait Implementations

impl Clone for Vars

fn clone(&self) -> Vars

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vars

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

Formats the value using the given formatter.

impl Default for Vars

fn default() -> Self

Returns the “default value” for a type.