Struct Redactor 

pub struct Redactor { /* private fields */ }

A helper for redacting data that varies by environment.

This isn’t meant to be perfect, and not everything can be redacted yet – the set of supported redactions will grow over time.

Implementations

impl Redactor

pub fn noop() -> Self

Creates a new no-op redactor.

pub fn build_active<State>(build_meta: &RustBuildMeta<State>) -> RedactorBuilder

Creates a new redactor builder that operates on the given build metadata.

This should only be called if redaction is actually needed.

pub fn redact_path<'a>( &self, orig: &'a Utf8Path, ) -> RedactorOutput<&'a Utf8Path>

Redacts a path.

pub fn redact_file_count(&self, orig: usize) -> RedactorOutput<usize>

Redacts a file count.

pub fn is_active(&self) -> bool

Returns true if this redactor is active (will redact values).

pub fn for_snapshot_testing() -> Self

Creates a new redactor for snapshot testing, without any path redactions.

This is useful when you need redaction of timestamps, durations, and sizes, but don’t have a RustBuildMeta to build path redactions from.

pub fn redact_timestamp<Tz>( &self, orig: &DateTime<Tz>, ) -> RedactorOutput<DisplayTimestamp<Tz>>

where Tz: TimeZone + Clone, Tz::Offset: Display,

Redacts a timestamp for display, producing a fixed-width placeholder.

The placeholder XXXX-XX-XX XX:XX:XX is 19 characters, matching the width of the %Y-%m-%d %H:%M:%S format.

pub fn redact_size(&self, orig: u64) -> RedactorOutput<SizeDisplay>

Redacts a size (in bytes) for display as a human-readable string.

When redacting, produces <size> as a placeholder.

pub fn redact_version(&self, orig: &Version) -> String

Redacts a version for display.

When redacting, produces <version> as a placeholder.

pub fn redact_store_duration( &self, orig: Option<f64>, ) -> RedactorOutput<StoreDurationDisplay>

Redacts a store duration for display, producing a fixed-width placeholder.

The placeholder <duration> is 10 characters, matching the width of the {:>9.3}s format used for durations.

pub fn redact_detailed_timestamp<Tz>(&self, orig: &DateTime<Tz>) -> String

where Tz: TimeZone, Tz::Offset: Display,

Redacts a timestamp with timezone for detailed display.

Produces XXXX-XX-XX XX:XX:XX when active, otherwise formats as %Y-%m-%d %H:%M:%S %:z.

pub fn redact_detailed_duration(&self, orig: Option<f64>) -> String

Redacts a duration in seconds for detailed display.

Produces <duration> when active, otherwise formats as {:.3}s.

pub fn redact_cli_args(&self, args: &[String]) -> String

Redacts CLI args for display.

• The first arg (the exe) is replaced with [EXE]
• Absolute paths in other args are replaced with [PATH]

pub fn redact_env_vars(&self, env_vars: &BTreeMap<String, String>) -> String

Redacts env vars for display.

Formats as K=V pairs.

pub fn redact_env_value<'a>(&self, value: &'a str) -> &'a str

Redacts an env var value for display.

Absolute paths are replaced with [PATH].

Trait Implementations

impl Clone for Redactor

fn clone(&self) -> Redactor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Redactor

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

Formats the value using the given formatter.