Struct ErrorCollector 

pub struct ErrorCollector { /* private fields */ }

Thread-safe error collector that deduplicates errors by root cause.

Designed to replace the error_occurred: bool + generic-error-message pattern used throughout the codebase. Stores the first error with its full anyhow::Error chain intact, deduplicates subsequent errors by root cause string, and caps the number of unique causes tracked.

Implementations

impl ErrorCollector

pub fn new(max_unique: usize) -> Self

Creates a new collector that tracks up to max_unique distinct root causes.

pub fn push(&self, error: Error)

Records an error. The first error’s full chain is preserved; subsequent errors are deduplicated by their root cause string.

pub fn has_errors(&self) -> bool

Returns true if any errors have been recorded.

pub fn take_error(&self) -> Option<Error>

Returns the final error, or None if no errors occurred.

• If there is exactly one unique root cause, returns the original first error with its full anyhow chain intact (so {:#} works correctly downstream).
• If there are multiple unique root causes, returns a new error listing all of them.
• If more errors were seen than tracked, appends a count of suppressed causes.

Can be called on a shared reference (e.g., through Arc). Takes the first error out of the collector, so subsequent calls will return a synthesized error if any errors were recorded.

pub fn into_error(self) -> Option<Error>

Consumes the collector and returns the final error. Equivalent to Self::take_error but takes ownership, guaranteeing no other references exist.

Trait Implementations

impl Debug for ErrorCollector

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

Formats the value using the given formatter.

impl Default for ErrorCollector

fn default() -> Self

Returns the “default value” for a type.