Struct minijinja::Error

pub struct Error { /* private fields */ }

Represents template errors.

If debug mode is enabled a template error contains additional debug information that can be displayed by formatting an error with the alternative formatting (format!("{:#}", err)). That information is also shown for the Debug display where the extended information is hidden when the alternative formatting is used.

Since MiniJinja takes advantage of chained errors it’s recommended to render the entire chain to better understand the causes.

Example

Here is an example of you might want to render errors:

match template.render(ctx) {
    Ok(result) => println!("{}", result),
    Err(err) => {
        eprintln!("Could not render template: {:#}", err);
        // render causes as well
        let mut err = &err as &dyn std::error::Error;
        while let Some(next_err) = err.source() {
            eprintln!();
            eprintln!("caused by: {:#}", next_err);
            err = next_err;
        }
    }
}

Implementations

impl Error

pub fn new<D: Into<Cow<'static, str>>>(kind: ErrorKind, detail: D) -> Error

Creates a new error with kind and detail.

pub fn with_source<E: Error + Send + Sync + 'static>(self, source: E) -> Self

Attaches another error as source to this error.

pub fn kind(&self) -> ErrorKind

Returns the error kind

pub fn name(&self) -> Option<&str>

Returns the filename of the template that caused the error.

pub fn line(&self) -> Option<usize>

Returns the line number where the error ocurred.

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)>

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 self, req: &mut Demand<'a>)

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

Provides type based access to context intended for error reports.

impl Error for Error

fn custom<T>(msg: T) -> Self where
    T: Display, 

Used when a Serialize implementation encounters any error while serializing a type.

impl From<Error> for Error

fn from(_: Error) -> Self

Converts to this type from the input type.

impl From<ErrorKind> for Error

fn from(kind: ErrorKind) -> Self

Converts to this type from the input type.