tracer (version 1.0.0)

tb: A better base::traceback()

Description

Compared to base::traceback(), tb
  • shows the stack from top to bottom, the same way as utils::recover(),
  • shows references to source files in a clickable form (in terminals that support this),
  • cuts long lines of code,
  • colors the output nicely (although this is a matter of taste),
  • can show the source code where the error happened, with syntax highlighting, if the source code is available.

Usage

tb(frame = NULL, context = 5)
bt(frame = NULL, context = 5)

Arguments

frame
If NULL, the stack trace is shown. If it is an integer referring to a frame in the stack, the source code of the corresponding call is shown.
context
Number of source code lines to show before and after the current line.

The custom error handler

tracer defines an error handler when loaded, via a call to options(error = tracer:::dumper). If you overwrite the error handler, then tb does not work properly. You can reinstate the tracer:::dumper error handler via an explicit call to options().

Details

bt is an alias to tb.