Enum cnf::env::Env

pub enum Env {
    AliasPrivileged,
    AliasExecutable,
    RecursionDepth,
    LogLevel,
}

Application-wide environment variables.

Variants

AliasPrivileged

If this variable is defined, an alias is executed with elevated privileges.

AliasExecutable

Name or absolute path of the cnf executable to resolve aliases with.

This is only used when resolving aliases and can be used to override the cnf version e.g. for development purposes to test newer features, like so:

$ CNF_ALIAS_EXECUTABLE="$PWD/target/debug/cnf" podman image ls

RecursionDepth

Set by the application to keep track of how many recursion levels are currently used by e.g. alias execution.

LogLevel

Overwrite the log level set in the application configuration.

Adheres roughly to env_logger syntax, see here: https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives

Implementations

impl Env

pub fn is_set(&self) -> bool

Returns true if an environment variable is defined and set to an arbitrary value.

pub fn get_raw(&self) -> Option<OsString>

Get the raw value of an environment variable. Refer to std::env::var_os for what a value of None may mean.

pub fn set_raw(&self, value: impl AsRef<OsStr>)

Set the raw value of an environment variable.

pub fn get<T: FromStr>(&self) -> Option<T>

Read an environment variable to a concrete type, if possible. Returns None if either:

• Env::get returns None
• The variable value cannot be parsed into a valid UTF-8 string
• The variable value cannot be parsed into the requested type

pub fn set<T: Display>(&self, value: T)

Set an environment variable to the string representation of value.

Trait Implementations

impl Debug for Env

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

Formats the value using the given formatter.

impl Display for Env

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

Formats the value using the given formatter.