Struct StackFrame 

pub struct StackFrame {
    pub location: &'static Location<'static>,
    pub message: String,
}

Represents a single frame in the virtual stack trace.

Each frame captures the location where an error was propagated and the associated error message. This provides precise context about the error propagation path without the overhead of system backtraces.

Fields

location: &'static Location<'static>

Location where the error occurred or was propagated

message: String

Error message for this frame

Implementations

impl StackFrame

pub fn new(location: &'static Location<'static>, message: String) -> Self

Creates a new stack frame with the given location and message.

Arguments

• location - The location where the error occurred, typically from std::panic::Location::caller()
• message - A descriptive message for this error frame

Example

use snafu_virtstack::StackFrame;
use std::panic::Location;

#[track_caller]
fn create_frame() -> StackFrame {
    StackFrame::new(
        Location::caller(),
        "Something went wrong".to_string()
    )
}

Trait Implementations

impl Clone for StackFrame

fn clone(&self) -> StackFrame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StackFrame

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

Formats the value using the given formatter.

impl Display for StackFrame

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

Formats the stack frame showing the message and location information.

The format is: {message} at {file}:{line}:{column}

Example Output

Failed to read configuration file at src/config.rs:42:15