Struct EnvRedactor 

pub struct EnvRedactor { /* private fields */ }

Applies one immutable redaction policy to environment-variable values.

Implementations

impl EnvRedactor

pub const fn new(redactor: Redactor) -> Self

Creates an environment redactor from a core redactor.

Parameters

• redactor - Core redactor whose immutable policy will be used.

Returns

An environment redactor owning the supplied policy snapshot.

pub const fn redactor(&self) -> &Redactor

Returns the core redactor backing this adapter.

Returns

A borrowed view of the core redactor.

pub fn redact_pair(&self, name: &str, value: &str) -> RedactedEnvPair

Redacts one UTF-8 environment-variable pair.

Both components are escaped before they can be displayed. The value is classified from name using the adapter’s immutable policy.

Parameters

• name - Environment-variable name used for classification.
• value - Environment-variable value to redact when sensitive.

Returns

A log-safe pair rendered as NAME=VALUE.

pub fn redact_pair_with_session( &self, name: &str, value: &str, session: &RedactionSession<'_>, ) -> RedactedEnvPair

Redacts one UTF-8 pair through a shared operation session.

pub fn redact_os_pair(&self, name: &OsStr, value: &OsStr) -> RedactedEnvPair

Redacts one environment pair whose components may not be UTF-8.

If either component is invalid UTF-8, the original value is never rendered or supplied to an edge-preserving mask. Instead, the secret opaque replacement is used. A non-UTF-8 name is rendered lossily and escaped for diagnostics.

Parameters

• name - Operating-system environment-variable name.
• value - Operating-system environment-variable value.

Returns

A fail-closed, log-safe pair rendered as NAME=VALUE.

pub fn redact_os_pairs<'a, I>(&self, pairs: I) -> LogSafeText<'static>

where I: IntoIterator<Item = (&'a OsStr, &'a OsStr)>,

Redacts environment pairs into one bounded log-safe list.

The adapter stops before inspecting a pair that would exceed the policy’s diagnostic input budget. It also stops once the escaped list reaches the diagnostic output budget.

Type Parameters

• 'a - Lifetime of environment names and values yielded by the iterator.
• I - Iterator source yielding borrowed environment pairs.

Parameters

• pairs - Operating-system environment names and values to redact.

Returns

A debug-style log-safe list of redacted assignments.

pub fn redact_os_pairs_with_session<'a, I>( &self, pairs: I, session: &RedactionSession<'_>, ) -> LogSafeText<'static>

where I: IntoIterator<Item = (&'a OsStr, &'a OsStr)>,

Redacts environment pairs through one cumulative diagnostic session.

pub fn redact_assignment(&self, assignment: &str) -> RedactedEnvPair

Redacts one UTF-8 NAME=value assignment.

Input without = is treated as a name with an empty value and therefore renders as NAME=.

Parameters

• assignment - Assignment text to split at its first equals sign.

Returns

A log-safe pair rendered as NAME=VALUE.

Trait Implementations

impl Clone for EnvRedactor

fn clone(&self) -> EnvRedactor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EnvRedactor

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

Formats the value using the given formatter.

impl Default for EnvRedactor

fn default() -> Self

Creates an environment redactor from the current default policy snapshot.

Returns

An environment redactor backed by Redactor::default.

impl Eq for EnvRedactor

impl PartialEq for EnvRedactor

fn eq(&self, other: &EnvRedactor) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for EnvRedactor