Struct EnvFetch 

pub struct EnvFetch { /* private fields */ }

Available on crate feature fetcher-env only.

KeyFetch implementation that reads bytes from a process environment variable.

The variable name is configured at construction. The variable’s bytes are returned verbatim — no decoding, no trimming, no parsing.

Examples

use key_vault::{EnvFetch, FetchContext, KeyFetch};

// SAFETY for the example: setting an env var in a single-threaded
// doctest is fine. Real applications should set keys via the
// orchestration layer (Kubernetes Secrets, AWS Lambda env, etc.).
unsafe { std::env::set_var("MY_APP_KEY", "very-secret-value"); }

let fetcher = EnvFetch::new("MY_APP_KEY");
let ctx = FetchContext::new("my-key");
let raw = fetcher.fetch(&ctx)?;
assert_eq!(raw.len(), "very-secret-value".len());

Implementations

impl EnvFetch

pub fn new(var_name: impl Into<String>) -> Self

Construct a fetcher that reads from the named environment variable.

The name is stored verbatim. It is logged in failure messages for diagnosability — keep that in mind if your variable names themselves encode sensitive deployment metadata.

Trait Implementations

impl Clone for EnvFetch

fn clone(&self) -> EnvFetch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EnvFetch

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

Formats the value using the given formatter.

impl KeyFetch for EnvFetch

fn fetch(&self, _ctx: &FetchContext) -> Result<RawKey>

Acquire raw key material from the underlying source.

fn describe(&self) -> Cow<'_, str>

Short, machine-friendly identifier for this fetcher (e.g. "keychain", "file", "env"). Used for audit records and error attribution.