Struct StackTrace 

pub struct StackTrace {
    pub language: Language,
    pub kind: Option<String>,
    pub message: Option<String>,
    pub frames: Vec<Frame>,
    pub cause: Option<Box<StackTrace>>,
    pub cause_kind: CauseKind,
    pub omitted_causes: usize,
    pub location: Option<Frame>,
}

A normalised stack trace.

Fields

language: Language

The source language.

kind: Option<String>

The error type (ValueError, java.io.IOException, panic).

message: Option<String>

The error message.

frames: Vec<Frame>

Frames, most recent call last.

cause: Option<Box<StackTrace>>

The error this one came from.

cause_kind: CauseKind

How cause relates to this error.

omitted_causes: usize

Causes below this one that were left out because the chain was longer than MAX_CAUSES. Rendered as … N more causes.

location: Option<Frame>

Where the error was raised, when the trace names it apart from the frames (a Rust panic’s panicked at location).

Implementations

impl StackTrace

pub fn new(language: Language) -> Self

An empty trace for language.

pub fn chain(&self) -> impl Iterator<Item = &StackTrace>

The traces from this one down its causes.

pub fn origin(&self) -> Option<&Frame>

The most recent application (non-library) frame, if any: where to look.

pub fn render_options(&self) -> StackTraceView<'_>

A renderable view with the default options.

Trait Implementations

impl Clone for StackTrace

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StackTrace

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

Formats the value using the given formatter.

impl Drop for StackTrace

Unlinks the cause chain one trace at a time: the derived drop recurses once per cause and overflows the stack on a long hand-built chain.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Eq for StackTrace

impl PartialEq for StackTrace

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Renderable for StackTrace

fn rich_render( &self, console: &Console, options: &ConsoleOptions, ) -> Vec<Segment>

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

The (minimum, maximum) cell width this renderable wants. Port of __rich_measure__. The default is what upstream’s Measurement.get returns for a renderable without one: anything from nothing to the whole width, (0, max_width).

fn fit_to_measurement(&self) -> bool

Whether a top-level Console::print shrinks this renderable to its measured width. Upstream renders every top-level renderable at the full console width, so the default is false; an extension may opt in.

fn vertical(&self) -> Option<VerticalAlign>

The vertical alignment a Table cell holding this renderable uses in place of its column’s. Upstream reads getattr(renderable, "vertical", None); Align sets it.

fn print_end_line(&self, _options: &ConsoleOptions) -> bool

Whether a top-level print ends this renderable’s last line. This port’s renderables separate lines, where upstream’s end each line with "\n", so a print adds the final line break. A renderable whose upstream output stops without one (Screen, LiveRender, a Rule whose end has no newline) returns false, and the next output continues its last line. options are the print’s options.

impl StructuralPartialEq for StackTrace