Module: PryStackExplorer
- Defined in:
- lib/pry-stack_explorer/frame_helpers.rb,
lib/pry-stack_explorer/frame_manager.rb,
lib/pry-stack_explorer/stack_commands.rb,
lib/pry-stack_explorer/when_started_hook.rb,
lib/pry-stack_explorer/pry-stack_explorer.rb
Defined Under Namespace
Modules: FrameHelpers Classes: FrameManager, WhenStartedHook
Constant Summary collapse
- COMMANDS =
Pry::CommandSet.new do block_command '%', 'Print current stack frame' do run 'whereami' end create_command "up", "Go up to the caller's context." do include FrameHelpers <<-BANNER Usage: up [OPTIONS] Go up to the caller's context. Accepts optional numeric parameter for how many frames to move up. Also accepts a string (regex) instead of numeric; for jumping to nearest parent method frame which matches the regex. e.g: up #=> Move up normally e.g: up + #=> Move up including vapid frames e.g: up meth #=> Jump to nearest parent stack frame whose method matches /meth/ regex, i.e `my_method`. BANNER def process move :up, args.first end end create_command "down", "Go down to the callee's context." do include FrameHelpers <<-BANNER Usage: down [OPTIONS] Go down to the callee's context. Accepts optional numeric parameter for how many frames to move down. Also accepts a string (regex) instead of numeric; for jumping to nearest child method frame which matches the regex. e.g: down #=> Move down normally e.g: down + #=> Move down including vapid frames e.g: down meth #=> Jump to nearest child stack frame whose method matches /meth/ regex, i.e `my_method`. BANNER def process move :down, args.first end end create_command "top", "Top" do include FrameHelpers def process return if PryMoves::Vars.var_precedence "top", target frame_manager.change_frame_to frame_manager.bindings.size - 1 end end create_command "bottom", "Bottom" do include FrameHelpers def process return if PryMoves::Vars.var_precedence "bottom", target frame_manager.change_frame_to 0 end end alias_command 'bm', 'bottom' create_command "frame", "Switch to a particular frame." do include FrameHelpers <<-BANNER Usage: frame [OPTIONS] Switch to a particular frame. Accepts numeric parameter (or regex for method name) for the target frame to switch to (use with show-stack). Negative frame numbers allowed. When given no parameter show information about the current frame. e.g: frame 4 #=> jump to the 4th frame e.g: frame meth #=> jump to nearest parent stack frame whose method matches /meth/ regex, i.e `my_method` e.g: frame -2 #=> jump to the second-to-last frame e.g: frame #=> show information info about current frame BANNER def process return if PryMoves::Vars.var_precedence "frame", target if !frame_manager raise Pry::CommandError, "nowhere to go!" else if args[0] =~ /\d+/ frame_manager.change_frame_to args[0].to_i elsif match = /^([A-Z]+[^#.]*)(#|\.)(.+)$/.match(args[0]) new_frame_index = find_frame_by_object_regex(Regexp.new(match[1]), Regexp.new(match[3]), :up) frame_manager.change_frame_to new_frame_index elsif args[0] =~ /^[^-].*$/ new_frame_index = find_frame_by_regex(Regexp.new(args[0]), :up) frame_manager.change_frame_to new_frame_index else output.puts "##{frame_manager.binding_index} #{frame_info(target, true)}" end end end end create_command "show-stack", "Show all frames" do include FrameHelpers <<-BANNER Usage: show-stack [OPTIONS] Show all accessible stack frames. e.g: show-stack -v BANNER def (opt) opt.on :v, :verbose, "Include extra information." opt.on :H, :head, "Display the first N stack frames (defaults to 10).", :optional_argument => true, :as => Integer, :default => 10 opt.on :T, :tail, "Display the last N stack frames (defaults to 10).", :optional_argument => true, :as => Integer, :default => 10 opt.on :c, :current, "Display N frames either side of current frame (default to 5).", :optional_argument => true, :as => Integer, :default => 5 end def memoized_info(index, b, verbose) frame_manager.user[:frame_info] ||= Hash.new { |h, k| h[k] = [] } if verbose frame_manager.user[:frame_info][:v][index] ||= frame_info(b, verbose) else frame_manager.user[:frame_info][:normal][index] ||= frame_info(b, verbose) end end private :memoized_info # @return [Array<Fixnum, Array<Binding>>] Return tuple of # base_frame_index and the array of frames. def selected_stack_frames if opts.present?(:head) [0, frame_manager.bindings[0..(opts[:head] - 1)]] elsif opts.present?(:tail) tail = opts[:tail] if tail > frame_manager.bindings.size tail = frame_manager.bindings.size end base_frame_index = frame_manager.bindings.size - tail [base_frame_index, frame_manager.bindings[base_frame_index..-1]] elsif opts.present?(:current) first_frame_index = frame_manager.binding_index - (opts[:current]) first_frame_index = 0 if first_frame_index < 0 last_frame_index = frame_manager.binding_index + (opts[:current]) [first_frame_index, frame_manager.bindings[first_frame_index..last_frame_index]] else [0, frame_manager.bindings] end end private :selected_stack_frames def process if !frame_manager output.puts "No caller stack available!" else content = "" content << "\n#{text.bold("Showing all accessible frames in stack (#{frame_manager.bindings.size} in total):")}\n--\n" base_frame_index, frames = selected_stack_frames frames.each_with_index do |b, index| i = index + base_frame_index if i == frame_manager.binding_index content << "=> ##{i} #{memoized_info(i, b, opts[:v])}\n" else content << " ##{i} #{memoized_info(i, b, opts[:v])}\n" end end stagger_output content end end end end
Class Method Summary collapse
-
.bindings_equal?(b1, b2) ⇒ Boolean
Simple test to check whether two ‘Binding` objects are equal.
-
.clear_frame_managers(_pry_) ⇒ Object
(also: delete_frame_managers)
Clear the stack of frame managers for the Pry instance.
-
.create_and_push_frame_manager(bindings, _pry_, options = {}) ⇒ Object
Create a ‘Pry::FrameManager` object and push it onto the frame manager stack for the relevant `pry` instance.
-
.frame_hash ⇒ Hash
The hash storing all frames for all Pry instances for the current thread.
-
.frame_manager(_pry_) ⇒ PryStackExplorer::FrameManager
The currently active frame manager.
-
.frame_managers(_pry_) ⇒ Array
Return the complete frame manager stack for the Pry instance.
-
.pop_frame_manager(_pry_) ⇒ Pry::FrameManager
Delete the currently active frame manager.
-
.pop_helper(popped_fm, _pry_) ⇒ Object
Restore the Pry instance to operate on the previous binding.
-
.push_helper(fm, options = {}) ⇒ Object
Update the Pry instance to operate on the specified frame for the current frame manager.
Class Method Details
.bindings_equal?(b1, b2) ⇒ Boolean
Simple test to check whether two ‘Binding` objects are equal.
107 108 109 110 111 112 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 107 def bindings_equal?(b1, b2) (b1.eval('self').equal?(b2.eval('self'))) && (b1.eval('__method__') == b2.eval('__method__')) && (b1.eval('local_variables').map { |v| b1.eval("#{v}") }.equal?( b2.eval('local_variables').map { |v| b2.eval("#{v}") })) end |
.clear_frame_managers(_pry_) ⇒ Object Also known as: delete_frame_managers
Clear the stack of frame managers for the Pry instance
91 92 93 94 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 91 def clear_frame_managers(_pry_) pop_frame_manager(_pry_) until frame_managers(_pry_).empty? frame_hash.delete(_pry_) # this line should be unnecessary! end |
.create_and_push_frame_manager(bindings, _pry_, options = {}) ⇒ Object
Create a ‘Pry::FrameManager` object and push it onto the frame manager stack for the relevant `pry` instance.
33 34 35 36 37 38 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 33 def create_and_push_frame_manager(bindings, _pry_, ={}) fm = FrameManager.new(bindings, _pry_) frame_hash[_pry_].push fm push_helper(fm, ) fm end |
.frame_hash ⇒ Hash
Returns The hash storing all frames for all Pry instances for the current thread.
17 18 19 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 17 def frame_hash Thread.current[:__pry_frame_managers__] ||= Hash.new { |h, k| h[k] = [] } end |
.frame_manager(_pry_) ⇒ PryStackExplorer::FrameManager
Returns The currently active frame manager.
99 100 101 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 99 def frame_manager(_pry_) frame_hash[_pry_].last end |
.frame_managers(_pry_) ⇒ Array
Return the complete frame manager stack for the Pry instance
25 26 27 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 25 def frame_managers(_pry_) frame_hash[_pry_] end |
.pop_frame_manager(_pry_) ⇒ Pry::FrameManager
Delete the currently active frame manager
58 59 60 61 62 63 64 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 58 def pop_frame_manager(_pry_) return if frame_managers(_pry_).empty? popped_fm = frame_managers(_pry_).pop pop_helper(popped_fm, _pry_) popped_fm end |
.pop_helper(popped_fm, _pry_) ⇒ Object
Restore the Pry instance to operate on the previous binding. Also responsible for restoring Pry instance’s backtrace.
70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 70 def pop_helper(popped_fm, _pry_) if frame_managers(_pry_).empty? if _pry_.binding_stack.empty? _pry_.binding_stack.push popped_fm.prior_binding else _pry_.binding_stack[-1] = popped_fm.prior_binding end frame_hash.delete(_pry_) else frame_manager(_pry_).refresh_frame(false) end # restore backtrace _pry_.backtrace = popped_fm.prior_backtrace end |
.push_helper(fm, options = {}) ⇒ Object
Update the Pry instance to operate on the specified frame for the current frame manager.
44 45 46 47 48 49 50 |
# File 'lib/pry-stack_explorer/pry-stack_explorer.rb', line 44 def push_helper(fm, ={}) = { :initial_frame => 0 }.merge!() fm.change_frame_to([:initial_frame], false) end |