Struct VantageError 

pub struct VantageError {
    pub context: Box<IndexMap<String, String>>,
    /* private fields */
}

VantageError with location tracking and context information

Fields

context: Box<IndexMap<String, String>>

Implementations

impl VantageError

pub fn new(message: impl Into<String>, location: String) -> VantageError

Create a new VantageError with message and location

pub fn kind(&self) -> ErrorKind

Current classification — see ErrorKind.

pub fn mark_unsupported(self) -> VantageError

Classify this error as ErrorKind::Unsupported (builder).

Marking no longer emits a trace on its own — chain traced when you want the tracing::error! event: error!(...).mark_unsupported().traced().

pub fn mark_unimplemented(self) -> VantageError

Classify this error as ErrorKind::Unimplemented (builder). See mark_unsupported on tracing.

pub fn mark_incorrect_usage(self) -> VantageError

Classify this error as ErrorKind::IncorrectUsage (builder). See mark_unsupported on tracing.

pub fn traced(self) -> VantageError

Emit a tracing::error! event with this error’s kind, location, message and context, then return self so it can be chained: error!(...).mark_unsupported().traced(). Classification and logging are deliberately decoupled — marking a kind no longer traces implicitly.

pub fn is_unsupported(&self) -> bool

true if this error is classified as ErrorKind::Unsupported.

pub fn is_unimplemented(&self) -> bool

true if this error is classified as ErrorKind::Unimplemented.

pub fn is_incorrect_usage(&self) -> bool

true if this error is classified as ErrorKind::IncorrectUsage.

pub fn no_data() -> VantageError

Create a “no data available” error

pub fn no_capability( method: impl Into<String>, type_name: impl Into<String>, ) -> VantageError

👎Deprecated:

Use error!(...).mark_unsupported().traced() or .mark_unimplemented().traced() modifier API instead

Create a “capability not implemented” error with method and type information

pub fn other(message: impl Into<String>) -> VantageError

Create a generic error with a message (no location)

Trait Implementations

impl Debug for VantageError

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

Formats the value using the given formatter.

impl Display for VantageError

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

Formats the value using the given formatter.

impl Error for VantageError

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.

impl From<&str> for VantageError

fn from(msg: &str) -> VantageError

Converts to this type from the input type.

impl From<Error> for VantageError

fn from(err: Error) -> VantageError

Converts to this type from the input type.

impl From<String> for VantageError

From String for backward compatibility

fn from(msg: String) -> VantageError

Converts to this type from the input type.

impl Termination for VantageError

fn report(self) -> ExitCode

Is called to get the representation of the value as status code. This status code is returned to the operating system.