Struct Traceback 

pub struct Traceback {

    pub trace: Trace,
    pub width: Option<usize>,
    pub extra_lines: usize,
    pub theme: Option<String>,
    pub word_wrap: bool,
    pub show_locals: bool,
    pub locals_max_length: Option<usize>,
    pub locals_max_string: Option<usize>,
    pub locals_hide_dunder: bool,
    pub locals_hide_sunder: bool,
    pub indent_guides: bool,
    pub suppress: Vec<String>,
    pub max_frames: usize,
}

Traceback display configuration and data.

Holds a Trace and configuration options for rendering. Rendering is not yet implemented - this is the struct definition only.

Example

use rich_rs::traceback::{Frame, Stack, Trace, Traceback};

let frame = Frame::new("main.rs", 10, "main")
    .with_line("    let x = foo();");

let stack = Stack::new("PanicInfo", "called `Result::unwrap()` on an `Err` value")
    .with_frame(frame);

let trace = Trace::new(vec![stack]);

// Using new() with defaults
let tb = Traceback::new(trace.clone());

// Using builder pattern for customization
let tb = Traceback::builder(trace)
    .width(100)
    .show_locals(true)
    .theme("monokai")
    .build();

Fields

trace: Trace

The trace data.

width: Option<usize>

Display width (None = use console width).

extra_lines: usize

Number of extra context lines around the error line.

theme: Option<String>

Syntax highlighting theme name.

word_wrap: bool

Enable word wrapping of long lines.

show_locals: bool

Show local variables in each frame.

locals_max_length: Option<usize>

Maximum length for container locals before abbreviating.

locals_max_string: Option<usize>

Maximum string length for locals before truncating.

locals_hide_dunder: bool

Hide locals prefixed with double underscore.

locals_hide_sunder: bool

Hide locals prefixed with single underscore.

indent_guides: bool

Show indent guides in code.

suppress: Vec<String>

Modules/paths to suppress from the traceback.

max_frames: usize

Maximum number of frames to show (0 = unlimited).

Implementations

impl Traceback

pub fn new(trace: Trace) -> Self

Create a new traceback with default settings.

Arguments

• trace - The trace data to display.

Example

use rich_rs::traceback::{Stack, Trace, Traceback};

let trace = Trace::new(vec![Stack::new("Error", "message")]);
let tb = Traceback::new(trace);

pub fn builder(trace: Trace) -> TracebackBuilder

Create a builder for configuring a traceback.

Arguments

• trace - The trace data to display.

Example

use rich_rs::traceback::{Stack, Trace, Traceback};

let trace = Trace::new(vec![Stack::new("Error", "message")]);
let tb = Traceback::builder(trace)
    .show_locals(true)
    .max_frames(50)
    .build();

pub fn trace(&self) -> &Trace

Get the trace data.

pub fn should_show_locals(&self) -> bool

Check if local variables should be displayed.

pub fn filter_locals( &self, locals: &BTreeMap<String, String>, ) -> BTreeMap<String, String>

Filter locals based on hide settings.

Returns a new BTreeMap with hidden variables removed.

pub fn is_suppressed(&self, path: &str) -> bool

Check if a path should be suppressed.

Trait Implementations

impl Clone for Traceback

fn clone(&self) -> Traceback

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Traceback

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

Formats the value using the given formatter.

impl Renderable for Traceback

fn render( &self, console: &Console<Stdout>, options: &ConsoleOptions, ) -> Segments

Render this object to a sequence of segments.

fn measure( &self, _console: &Console<Stdout>, options: &ConsoleOptions, ) -> Measurement

Measure the minimum and maximum width requirements.