Struct Frame 

pub struct Frame {
    pub filename: String,
    pub lineno: usize,
    pub name: String,
    pub line: String,
    pub locals: Option<BTreeMap<String, String>>,
}

A single stack frame in a traceback.

Represents one level in the call stack, including the source location, function name, source line, and optionally local variables.

Fields

filename: String

The source file path.

lineno: usize

The line number (1-based).

name: String

The function or method name.

line: String

The source code line (may be empty if unavailable).

locals: Option<BTreeMap<String, String>>

Local variables as debug strings (name -> repr). Uses BTreeMap for deterministic ordering.

Implementations

impl Frame

pub fn new( filename: impl Into<String>, lineno: usize, name: impl Into<String>, ) -> Self

Create a new frame with the essential fields.

Arguments

• filename - The source file path.
• lineno - The line number (1-based).
• name - The function or method name.

Example

use rich_rs::traceback::Frame;

let frame = Frame::new("src/main.rs", 42, "main");

pub fn with_line(self, line: impl Into<String>) -> Self

Set the source line for this frame.

pub fn with_locals(self, locals: BTreeMap<String, String>) -> Self

Set the local variables for this frame.

pub fn add_local(&mut self, name: impl Into<String>, value: impl Into<String>)

Add a single local variable.

pub fn has_locals(&self) -> bool

Check if this frame has local variables.

Trait Implementations

impl Clone for Frame

fn clone(&self) -> Frame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Frame

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

Formats the value using the given formatter.