Struct Columns 

pub struct Columns<'a> {
    pub skip: usize,
    pub pwd: &'a str,
    pub funcs: &'a str,
    pub sources: &'a str,
    pub lines: &'a str,
    pub args: Option<Args<'a>>,
}

One frame walk, in the sections stack.bash writes.

Fields

skip: usize

How many leading frames belong to the instrument rather than the subject. At least one — the emitter’s own.

pwd: &'a str

The sending shell’s $PWD, which a relative BASH_SOURCE is relative to as far as anything can know.

funcs: &'a str

sources: &'a str

lines: &'a str

args: Option<Args<'a>>

Absent where an instrument does not report arguments at all.

Implementations

impl<'a> Columns<'a>

pub fn of(words: &'a [String]) -> Result<Self, Failure>

The sections out of a message’s key value payload, which is the shape stack.bash appends them in.

pub fn frames(&self, shell: &Shell) -> Result<Stack, Failure>

The subject’s walk, read against the shell it was taken in.

shell is what that shell said of itself when it joined, and it is needed because BASH_SOURCE alone cannot say what its own words mean: $0 is a path in one shell and a stand-in for code in another.