Struct XdgEnv 

#[non_exhaustive]
pub struct XdgEnv { /* private fields */ }

Snapshot of the env vars the XDG cascade reads. Only xdg and home matter; the cascade has no other inputs.

Fields are OsString (not String) because Unix paths are byte-strings — a user with XDG_CACHE_HOME=/srv/café-bin in a non-UTF-8 locale must not silently lose their setting. None and empty-string both count as “not set” — the cascade treats them the same. The XdgEnv::from_process_env factory normalizes at the boundary so each call site doesn’t have to.

Implementations

impl XdgEnv

pub fn from_process_env() -> Self

Snapshot the three env vars from the running process, treating empty strings as unset per the XDG spec. Non-UTF-8 values are preserved; Option<OsString> carries them through to the cascade unchanged.

pub fn from_os_options( xdg_cache_home: Option<OsString>, xdg_config_home: Option<OsString>, home: Option<OsString>, ) -> Self

Build an XdgEnv from raw OsString reads (the shape std::env::var_os returns). Filters empty values to None at the single normalization point.

Trait Implementations

impl Clone for XdgEnv

fn clone(&self) -> XdgEnv

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for XdgEnv

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

Formats the value using the given formatter.

impl Default for XdgEnv

fn default() -> XdgEnv

Returns the “default value” for a type.