Struct loga::types::Error

pub struct Error(/* private fields */);

A comprehensive structural error type, intended exclusively for human consumption.

Implementations

impl Error

pub fn from(x: impl Display) -> Error

pub fn also(self, incidental: Error) -> Error

Extend the base error with a new incidental (occurred while handling the base error) error. Use like e.also(log, new_e);.

Examples found in repository

examples/fatal.rs (lines 15-23)

fn main() {
    fatal(
        agg_err(
            "The main thing failed",
            vec![
                err_with("The primary system exploded", ea!(att1 = "Hi", att2 = 423))
                    .also(
                        err_with(
                            "An incidental_error with a threateningly long message that might be able to wrap if I extend the length somewhat further and then some I guess going by editor width this might not be quite enough",
                            ea!(
                                another_attr =
                                    "This is a very long message, hopefully it gets wrapped somewhere between the start and the end of the screen"
                            ),
                        ),
                    )
                    .also(err("Nothing much else to add")),
                err("Just tacking this one on too")
            ],
        ),
    );
}

pub fn context(self, message: &'static str) -> Error

Return a new error adding a simple string message as a layer of context.

pub fn log_context<F: Flags>(self, log: &Log<F>, message: &'static str) -> Error

Return a new error adding a layer of context including all attributes in the provided log along with the specified message.

pub fn log_context_with<F: Flags>( self, log: &Log<F>, message: &'static str, attrs: impl Fn(&mut HashMap<&'static str, String>) ) -> Error

Return a new error adding a layer of context including all attributes in the provided log along with the specified message and new attributes.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl<T: Error> From<T> for Error

fn from(value: T) -> Self

Converts to this type from the input type.