pretty-trace

0.3.1 • Public • Published

pretty-trace build status

testling badge

Prettifies traces emitted by tools like lldb.

var prettyTrace = require('pretty-trace');
 
var lines = fs.readFileSync(__dirname + '/test/fixtures/lldb-trace.txt', 'utf8').split('\n');
 
var prettyLines = prettyTrace.lines(lines, prettyTrace.terminalTheme);
console.log(prettyLines.join('\n'))

lldb-trace

CLI

cat ./test/fixtures/lldb-trace.txt | pretty-trace

Installation

npm install pretty-trace

Used by resolve-jit-symbols.

prettyTrace::htmlTheme

A theme that surrounds the given trace using with spans classed trace-* in order to allow styling with CSS.

Source:

prettyTrace::regexes::instruments

Regexes used to match callgraphs generated with Mac Instruments.

Source:

prettyTrace::regexes::lldb

Regexes used to match debug traces created by tools like lldb.

Source:

prettyTrace::regexes::perf

Regexes used to match callgraphs generated running Linux perf, i.e. perf script.

Source:

prettyTrace::terminalTheme

A theme that colorizes the given trace using ANSI color codes.

Source:

prettyTrace::line(line, theme) → {string}

Prettifies the given line.

Parameters:
Name Type Description
line string

the line to be prettified

theme Object

theme that specifies how to prettify a trace

Properties
Name Type Description
raw function

invoked to surround an unparsable line

frame function

invoked to surround the frame number

address function

invoked to surround the hex address

symbol function

invoked to surround the symbol corresponding to the address, i.e. a function name

location function

invoked to surround the location in the file at which the symbol is found

Source:
Returns:

prettified line

Type
string

prettyTrace::lines(lines, theme) → {Array.<string>}

Prettifies multiple lines.

Parameters:
Name Type Description
lines Array.<string>

lines to be prettified

theme Object

theme that specifies how to prettify a trace @see prettyTrace::line

Source:
Returns:

the prettified lines

Type
Array.<string>

generated with docme

License

MIT

Package Sidebar

Install

npm i pretty-trace

Weekly Downloads

7,411

Version

0.3.1

License

MIT

Last publish

Collaborators

  • thlorenz