Struct Environment 

pub struct Environment<'a> {
    pub home_dir: Cow<'a, Path>,
    pub temp_dir: Cow<'a, Path>,
    pub cache_dir: Cow<'a, Path>,
    pub pkg_name: Cow<'a, str>,
}

Environment variables and system metadata.

Uses Cow (Copy-on-Write) to handle both owned paths/strings from the environment and static fallbacks efficiently without unnecessary allocations.

Fields

home_dir: Cow<'a, Path>

temp_dir: Cow<'a, Path>

cache_dir: Cow<'a, Path>

pkg_name: Cow<'a, str>

Implementations

impl Environment<'_>

pub fn fallback() -> Environment<'static>

Returns a fallback environment config with static defaults.

pub fn new() -> WallSwitchResult<Environment<'static>>

Initializes the environment by gathering data from system variables.

This resolves the system home directory, temporary directory, and package name safely.

pub fn get_app_config_dir(&self) -> PathBuf

Returns the standard configuration directory based on target OS platform guidelines.

• On Unix-like systems (Linux/macOS), returns ~/.config/wallswitch.
• On Windows systems, returns %APPDATA%\wallswitch.

pub fn get_app_cache_dir(&self) -> PathBuf

Returns the standard non-volatile user cache directory based on OS guidelines.

• On Unix-like systems, returns ~/.cache/wallswitch.
• On Windows systems, returns %LOCALAPPDATA%\wallswitch.

pub fn get_home_dir(&self) -> &Path

Returns a reference to the home directory path.

pub fn get_temp_dir(&self) -> &Path

Returns a reference to the temporary directory path.

pub fn get_pkg_name(&self) -> &str

Returns a reference to the package name.