ConfigErrors

Struct ConfigErrors 

Source
pub struct ConfigErrors(pub NonEmptyVec<ConfigError>);
Expand description

A non-empty collection of configuration errors.

Uses NonEmptyVec from stillwater to guarantee at least one error exists. This prevents the “empty error list” anti-pattern and enables safe first().

Tuple Fields§

§0: NonEmptyVec<ConfigError>

Implementations§

Source§

impl ConfigErrors

Source

pub fn single(error: ConfigError) -> Self

Create from a single error.

Source

pub fn from_nonempty(errors: NonEmptyVec<ConfigError>) -> Self

Create from a non-empty vec.

Source

pub fn from_vec(errors: Vec<ConfigError>) -> Option<Self>

Try to create from a vec, returning None if empty.

Source

pub fn first(&self) -> &ConfigError

Get the first error (always exists).

Source

pub fn as_slice(&self) -> Vec<&ConfigError>

Get all errors as a slice.

Source

pub fn len(&self) -> usize

Number of errors.

Source

pub fn is_empty(&self) -> bool

Check if empty (always false, but required for API consistency).

Source

pub fn iter(&self) -> impl Iterator<Item = &ConfigError>

Iterate over errors.

Source

pub fn with_context(self, context: impl Into<String>) -> Self

Add context to all errors.

Source

pub fn with_path_prefix(self, prefix: &str) -> Self

Add a path prefix to all error paths.

This is used for nested validation to add parent context to error paths. For example, if an error has path “port” and prefix is “database”, the resulting path will be “database.port”.

Source§

impl ConfigErrors

Source

pub fn pretty_print(&self, options: &PrettyPrintOptions)

Pretty print errors to stderr.

§Stillwater Integration

ConfigErrors wraps NonEmptyVec<ConfigError>, guaranteeing at least one error exists. This eliminates empty-error-list edge cases.

Source

pub fn format(&self, options: &PrettyPrintOptions) -> String

Pretty print to a string (for testing).

Source

pub fn pretty_print_default(&self)

Pretty print with default options.

Trait Implementations§

Source§

impl Clone for ConfigErrors

Source§

fn clone(&self) -> ConfigErrors

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ConfigErrors

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for ConfigErrors

Source§

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

Formats the value using the given formatter. Read more
Source§

impl From<ConfigError> for ConfigErrors

Source§

fn from(error: ConfigError) -> Self

Converts to this type from the input type.
Source§

impl IntoIterator for ConfigErrors

Source§

type Item = ConfigError

The type of the elements being iterated over.
Source§

type IntoIter = IntoIter<ConfigError>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
Source§

impl Semigroup for ConfigErrors

Source§

fn combine(self, other: Self) -> Self

Combine this value with another value associatively Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.