Struct ArgvRedactor 

pub struct ArgvRedactor { /* private fields */ }

Applies one immutable redaction policy to argument vectors.

Implementations

impl ArgvRedactor

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

Creates an argv redactor from a core redactor.

Parameters

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

Returns

An argv 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_items<'a, I>(&self, items: I) -> RedactedArgv

where I: IntoIterator<Item = ArgvItem<'a>>,

Redacts only values explicitly marked sensitive by their caller.

Plain items are rendered as ordinary argv values without guessing whether they are options, assignments, or option values. Non-UTF-8 sensitive items are masked from an opaque sentinel so their original bytes can never reach output.

Type Parameters

• 'a - Lifetime of argument values borrowed by the iterator.
• I - Iterator source yielding borrowed ArgvItem values.

Parameters

• items - Borrowed argv items with optional authoritative levels.

Returns

A log-safe rendering in input order.

pub fn redact_heuristically<'a, I>(&self, items: I) -> RedactedArgv

where I: IntoIterator<Item = ArgvItem<'a>>,

Redacts explicit sensitive values and heuristically classified plain values.

Explicit sensitivity always wins. Plain items recognize --name value, --name=value, -name value, NAME=value, and JVM-style -Dname=value properties. Compact options such as -pSECRET and shell payload syntax are not inferred. Callers must mark those values explicitly when they are sensitive. Because this is a safety heuristic rather than a command-specific parser, an option delimiter does not disable recognition in later wrapper or child-command segments. A non-UTF-8 plain item is masked at Sensitivity::Secret because it cannot be classified safely.

Type Parameters

• 'a - Lifetime of argument values borrowed by the iterator.
• I - Iterator source yielding borrowed ArgvItem values.

Parameters

• items - Borrowed argv items with optional authoritative levels.

Returns

A log-safe rendering in input order.

pub fn redact_items_with_session<'a, I>( &self, items: I, session: &RedactionSession<'_>, ) -> RedactedArgv

where I: IntoIterator<Item = ArgvItem<'a>>,

Redacts explicit items while sharing cumulative input and output accounting with other diagnostic adapters.

pub fn redact_heuristically_with_session<'a, I>( &self, items: I, session: &RedactionSession<'_>, ) -> RedactedArgv

where I: IntoIterator<Item = ArgvItem<'a>>,

Redacts explicit and heuristic items through a shared diagnostic session.

Trait Implementations

impl Clone for ArgvRedactor

fn clone(&self) -> ArgvRedactor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArgvRedactor

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

Formats the value using the given formatter.

impl Default for ArgvRedactor

fn default() -> Self

Creates an argv redactor from the current default policy snapshot.

Returns

An argv redactor backed by Redactor::default.

impl Eq for ArgvRedactor

impl PartialEq for ArgvRedactor

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ArgvRedactor