Struct EnvVarManager 

pub struct EnvVarManager {
    pub vars: IndexMap<String, EnvVar>,
    pub history: Vec<HistoryEntry>,
}

Fields

vars: IndexMap<String, EnvVar>

history: Vec<HistoryEntry>

Implementations

impl EnvVarManager

pub fn new() -> Self

pub fn load_all(&mut self) -> Result<()>

Loads environment variables from all available sources (process, system, and user).

This method loads environment variables from the current process environment and platform-specific sources like the Windows registry or Unix shell configurations.

Errors

Returns an error if:

• Registry access fails on Windows platforms
• File system operations fail when reading Unix shell configurations
• Other platform-specific environment variable access fails

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

pub fn get_pattern(&self, pattern: &str) -> Vec<&EnvVar>

Get variables matching a pattern (supports wildcards and regex)

pub fn get_wildcard(&self, pattern: &str) -> Vec<&EnvVar>

Get variables matching a wildcard pattern (* and ?)

pub fn get_regex(&self, pattern: &str) -> Vec<&EnvVar>

Get variables matching a regex pattern

pub fn get_prefix(&self, prefix: &str) -> Vec<&EnvVar>

Get variables with names starting with a prefix

pub fn get_suffix(&self, suffix: &str) -> Vec<&EnvVar>

Get variables with names ending with a suffix

pub fn get_containing(&self, substring: &str) -> Vec<&EnvVar>

Get variables containing a substring (case-insensitive)

pub fn set(&mut self, name: &str, value: &str, permanent: bool) -> Result<()>

Sets an environment variable with the given name and value.

This method updates the variable both in the manager’s internal state and in the current process environment. If permanent is true, it will also attempt to persist the variable to the system or user environment.

Errors

Returns an error if:

• Registry operations fail on Windows platforms when setting permanent variables
• File system operations fail when modifying shell configuration files on Unix
• Other platform-specific environment variable persistence operations fail

pub fn delete(&mut self, name: &str) -> Result<()>

Deletes an environment variable by name.

This method removes the variable from both the manager’s internal state, the current process environment, and the system environment (if it was a permanent variable).

Errors

Returns an error if the variable with the given name does not exist.

pub fn list(&self) -> Vec<&EnvVar>

pub fn filter_by_source(&self, source: &EnvVarSource) -> Vec<&EnvVar>

pub fn search(&self, query: &str) -> Vec<&EnvVar>

pub fn undo(&mut self) -> Result<()>

Undoes the last environment variable operation.

This method reverses the most recent operation (set or delete) by restoring the previous state from the history. For set operations, it either restores the previous value or removes the variable if it didn’t exist before. For delete operations, it restores the deleted variable with its previous value.

Errors

Currently, this method always returns Ok(()) and does not produce errors, but it returns a Result for future extensibility and consistency with other methods in the API.

pub fn clear(&mut self)

pub fn rename( &mut self, pattern: &str, replacement: &str, ) -> Result<Vec<(String, String)>>

Rename environment variables based on pattern Supports wildcards (*) for batch renaming

Errors

Returns an error if:

• The pattern contains multiple wildcards (not supported)
• A target variable name already exists when attempting to rename
• The source variable specified by the pattern doesn’t exist (for exact matches)
• System-level operations fail when updating environment variables

pub fn replace( &mut self, pattern: &str, new_value: &str, ) -> Result<Vec<(String, String, String)>>

Replace the value of environment variables matching a pattern

Arguments

• pattern - Variable name pattern (supports wildcards with *)
• new_value - The new value to set

Errors

Returns an error if:

• The pattern contains multiple wildcards (not supported)
• System-level operations fail when updating environment variables

pub fn find_replace( &mut self, search: &str, replacement: &str, pattern: Option<&str>, ) -> Result<Vec<(String, String, String)>>

Find and replace text within environment variable values

Arguments

• search - Text to search for in values
• replacement - Text to replace with
• pattern - Optional variable name pattern to limit the search (supports wildcards)

Errors

Returns an error if:

• The pattern contains multiple wildcards (not supported)
• System-level operations fail when updating environment variables

Trait Implementations

impl Default for EnvVarManager

fn default() -> Self

Returns the “default value” for a type.