Struct VarEnv 

pub struct VarEnv<N: Eq + Hash, V> { /* private fields */ }

An environment module for setting, getting, and exporting shell variables.

Implementations

impl<N, V> VarEnv<N, V>

where N: Eq + Hash,

pub fn new() -> Self

Constructs a new environment with no environment variables.

pub fn with_process_env_vars() -> Self

where N: From<String>, V: From<String>,

Constructs a new environment and initializes it with the environment variables of the current process.

pub fn with_env_vars<I: IntoIterator<Item = (N, V)>>(iter: I) -> Self

Constructs a new environment with a provided collection of (key, value) environment variable pairs. These variables (if any) will be inherited by all commands.

Trait Implementations

impl<N, V> Clone for VarEnv<N, V>

where N: Eq + Hash,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<N, V> Debug for VarEnv<N, V>

where N: Eq + Ord + Hash + Debug, V: Debug,

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

Formats the value using the given formatter.

impl<N, V> Default for VarEnv<N, V>

where N: Eq + Hash,

fn default() -> Self

Returns the “default value” for a type.

impl<N, V> ExportedVariableEnvironment for VarEnv<N, V>

where N: Eq + Clone + Hash, V: Eq + Clone,

fn exported_var(&self, name: &Self::VarName) -> Option<(&Self::Var, bool)>

Get the value of some variable and whether it is exported.

fn set_exported_var( &mut self, name: Self::VarName, val: Self::Var, exported: bool, )

Set the value of some variable, and set it’s exported status as specified.

impl<N: PartialEq + Eq + Hash, V: PartialEq> PartialEq for VarEnv<N, V>

fn eq(&self, other: &VarEnv<N, V>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<N, V> SubEnvironment for VarEnv<N, V>

where N: Eq + Hash,

fn sub_env(&self) -> Self

Create a new sub-environment, which starts out idential to its parent, but any changes on the new environment will not be reflected on the parent.

impl<N, V> UnsetVariableEnvironment for VarEnv<N, V>

where N: Eq + Clone + Hash, V: Eq + Clone,

fn unset_var(&mut self, name: &N)

Unset the value of some variable (including environment variables).

impl<N, V> VariableEnvironment for VarEnv<N, V>

where N: Eq + Clone + Hash, V: Eq + Clone,

type VarName = N

The type of the name this environment associates for a variable.

type Var = V

The type of variables this environment holds.

fn var<Q>(&self, name: &Q) -> Option<&Self::Var>

where Self::VarName: Borrow<Q>, Q: Hash + Eq + ?Sized,

Get the value of some variable. The values of both shell-only and environment variables will be looked up and returned.

fn set_var(&mut self, name: Self::VarName, val: Self::Var)

Set the value of some variable, maintaining its status as an environment variable if previously set as such.

fn env_vars(&self) -> Cow<'_, [(&Self::VarName, &Self::Var)]>

Unset the value of some variable (including environment variables). Get all current pairs of environment variables and their values.

impl<N: Eq + Eq + Hash, V: Eq> Eq for VarEnv<N, V>

impl<N: Eq + Hash, V> StructuralPartialEq for VarEnv<N, V>