Struct Error 

pub struct Error {
    pub error: Error,
    pub trace: Trace<PathBuf>,
    /* private fields */
}

Available on crate feature file only.

Error for the File evaluator.

Example

use module_util::evaluator::dfs;

let mut err = Error::new(dfs::Error::Merge({
    let mut e = module::merge::Error::collision();
    e.field.push_back("my");
    e.field.push_back("super");
    e.field.push_back("awesome");
    e.field.push_back("field");
    e
}));

err.trace.push("module 1".into());
err.trace.push("module 2".into());
err.trace.push("module 3".into());

assert_eq!(format!("{err}"),
r#"value collision while evaluating "my.super.awesome.field"

    in module 3
  from module 2
  from module 1
"#);

assert_eq!(format!("{err}"), format!("{err:#}"));

use module_util::evaluator::dfs;

let mut err = Error::new(dfs::Error::Merge(module::merge::Error::collision()));

err.trace.push("module 1".into());

assert_eq!(format!("{err}"),
r#"value collision

    in module 1
"#);

assert_eq!(format!("{err}"), format!("{err:#}"));

use module_util::evaluator::dfs;
use std::io;

let mut err = Error::new({
    let mut e = module::merge::Error::other(io::Error::other("invalid data"));
    e.field.push_back("user");
    e.field.push_back("email");
    dfs::Error::Merge(e)
});

err.trace.push("module 1".into());
err.trace.push("module 2".into());

assert_eq!(format!("{err}"),
r#"invalid data while evaluating "user.email"

    in module 2
  from module 1
"#);

assert_eq!(format!("{err}"), format!("{err:#}"));

use module_util::evaluator::{dfs, Trace};
use std::io;

let err = Error::new(dfs::Error::other(io::Error::other("some other error")))
    .with_trace({
        let mut t = Trace::empty();
        t.push("module 1".into());
        t.push("module 2".into());
        t.push("module 3".into());
        t
    });

assert_eq!(format!("{err}"),
r#"some other error

    in module 3
  from module 2
  from module 1
"#);

assert_eq!(format!("{err}"), format!("{err:#}"));

Fields

error: Error

Evaluation error.

trace: Trace<PathBuf>

Module trace.

Implementations

impl Error

pub const fn new(error: Error) -> Self

Create a new Error.

pub fn with_trace(self, trace: Trace<PathBuf>) -> Self

Set the trace of the error.

Trait Implementations

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 Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.