Struct Environment 

pub struct Environment {
    pub vars: HashMap<String, String>,
}

Runtime environment variables for task execution

Fields

vars: HashMap<String, String>

Map of environment variable names to values

Implementations

impl Environment

pub fn new() -> Self

Create a new empty environment

pub fn from_map(vars: HashMap<String, String>) -> Self

Create environment from a map

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

Get an environment variable value

pub fn set(&mut self, key: String, value: String)

Set an environment variable

pub fn contains(&self, key: &str) -> bool

Check if an environment variable exists

pub fn to_env_vec(&self) -> Vec<String>

Get all environment variables as a vector of key=value strings

pub fn merge_with_system(&self) -> HashMap<String, String>

Merge with system environment variables CUE environment variables take precedence

pub fn to_full_env_vec(&self) -> Vec<String>

Convert to a vector of key=value strings including system environment

pub fn len(&self) -> usize

Get the number of environment variables

pub fn is_empty(&self) -> bool

Check if the environment is empty

pub fn resolve_command(&self, command: &str) -> String

Resolve a command to its full path using this environment’s PATH. This is necessary because when spawning a process, the OS looks up the executable in the current process’s PATH, not the environment that will be set on the child process.

Returns the full path if found, or the original command if not found (letting the spawn fail with a proper error).

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

Iterate over environment variables

pub fn build_for_task( task_name: &str, env_vars: &HashMap<String, EnvValue>, ) -> HashMap<String, String>

Build environment for a task, filtering based on policies

pub async fn resolve_for_task( task_name: &str, env_vars: &HashMap<String, EnvValue>, ) -> Result<HashMap<String, String>>

Build and resolve environment for a task, filtering based on policies

Resolves all environment variables including secrets via the trait-based resolver system.

pub async fn resolve_for_task_with_secrets( task_name: &str, env_vars: &HashMap<String, EnvValue>, ) -> Result<(HashMap<String, String>, Vec<String>)>

Build and resolve environment for a task, also returning secret values

Returns (resolved_env_vars, secret_values) where secret_values contains the resolved values of any secrets, for use in output redaction.

pub fn build_for_exec( command: &str, env_vars: &HashMap<String, EnvValue>, ) -> HashMap<String, String>

Build environment for exec command, filtering based on policies

pub async fn resolve_for_exec( command: &str, env_vars: &HashMap<String, EnvValue>, ) -> Result<HashMap<String, String>>

Build and resolve environment for exec command, filtering based on policies

Resolves all environment variables including secrets via the trait-based resolver system.

pub async fn resolve_for_exec_with_secrets( command: &str, env_vars: &HashMap<String, EnvValue>, ) -> Result<(HashMap<String, String>, Vec<String>)>

Build and resolve environment for exec command, also returning secret values

Returns (resolved_env_vars, secret_values) where secret_values contains the resolved values of any secrets, for use in output redaction.

Trait Implementations

impl Clone for Environment

fn clone(&self) -> Environment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Environment

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

Formats the value using the given formatter.

impl Default for Environment

fn default() -> Environment

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Environment

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Environment

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.