pry-stack_explorer
Walk the stack in a Pry session
Pry::StackExplorer is a plugin for Pry that allows navigating the call stack.
From the point a Pry session is started, the user can move up the stack through parent frames, examine state, and even evaluate code.
Unlike ruby-debug
, pry-stack_explorer incurs no runtime cost and
enables navigation right up the call-stack to the birth of the
program.
The up
, down
, frame
and stack
commands are provided. See
Pry's in-session help for more information on any of these commands.
Usage
Provides commands available in Pry sessions.
Commands:
up
/down
- Move up or down the call stackframe [n]
- Go to frame nstack
- Show call stack
Install
In Gemfile:
gem 'pry-stack_explorer', '~> 0.6.0'
gem install pry-stack_explorer
- Read the documentation
- See the wiki for in-depth usage information.
Branches and compatible Ruby versions
- v0.5, v0.6: Ruby 2.6+, Pry 0.13+
- v0.4.11+: Ruby 2.5, Pry 0.12+ (branch
0-4
– end-of-life in March 2021) - v0.4.9.3: Older versions (unsupported)
Example:
Here we run the following ruby script:
require 'pry-stack_explorer'
def alpha
x = "hello"
beta
puts x
end
def beta
binding.pry
end
alpha
We wander around the stack a little bit, and modify the state of a frame above the one we binding.pry
'd at.
Output from above is Goodbye
as we changed the x
local inside the alpha
(caller) stack frame.
License
Released under the MIT License by John Mair (banisterfiend) and contributors
Contributions to this gem are released under the same license.