pry-stack 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 055a3091baf5b3f516b238784efa827b4d8cd615
+  data.tar.gz: fa1f4f9e593c14a613328d159dfe9d6a153b679f
+SHA512:
+  metadata.gz: 39af5fb5cc996bd09f4bb2b19ea493dca5c5043c47f3dd0cc68d49c7f5c77403e8966f4b7addf50106aa776b13aaa5c0bf2a409f7ac8f903987bccff1301f313
+  data.tar.gz: 3eaff3b80174d881409ab03911041f16e17d82c623d5b9c27e0b0f4450bc4fd2c64e65d3f93bb0f83d71382dbc4e016c5d00e258806010e604504996bb9a3184

data/.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name    = "pry-stack"
+  s.version = File.read("VERSION").strip
+  s.date    = File.mtime("VERSION").strftime("%Y-%m-%d")
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+
+  s.authors     = ["John Mair (banisterfiend)", "Chris Gahan (epitron)"]
+  s.email       = ["jrmair@gmail.com", "chris@ill-logic.com"]
+  s.description = "Walk the stack in Pry, with STYLE."
+  s.summary     = "Tired of your 'up' and 'down' commands going in the wrong direction? Longing for a shorter command to show the stack? Are your fingers raw from typing overly long gem names and unnecessary underscores? Then pry-stack is for you!"
+  s.homepage    = "https://github.com/epitron/pry-stack"
+  s.licenses    = ["MIT"]
+
+  s.files            = `git ls`.lines.map(&:strip)
+  s.extra_rdoc_files = ["README.md", "CHANGELOG"]
+  s.require_paths    = ["lib"]
+
+  s.rubygems_version = "2.4.5"
+
+  s.test_files = ["test/helper.rb", "test/test_commands.rb", "test/test_frame_manager.rb", "test/test_stack.rb"]
+
+  s.specification_version = 4
+  s.add_dependency("binding_of_caller", "~> 0.7")
+  s.add_dependency("pry", ["~> 0.9", ">= 0.9.11"])
+  s.add_development_dependency("bacon", "~> 1.1")
+  s.add_development_dependency("rake", "~> 0.9")
+end

data/.gitignore

@@ -0,0 +1,7 @@
+Makefile
+*.so
+*.o
+*.def
+doc/
+pkg/
+.yardoc/

data/.travis.yml

@@ -0,0 +1,15 @@
+script:
+  rake test --trace
+
+rvm:
+  - 1.9.2
+  - 1.9.3
+
+notifications:
+  irc: "irc.freenode.org#pry"
+  recipients:
+    - jrmair@gmail.com
+
+branches:
+  only:
+    - master

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/LICENSE

@@ -0,0 +1,25 @@
+License
+-------
+
+(The MIT License) 
+
+Copyright (c) 2011 John Mair (banisterfiend)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,39 @@
+pry-stack
+===========
+
+A Pry plugin to navigate the stack.
+
+This gem is almost exactly the same as [pry-stack_explorer](http://github.com/pry/pry-stack_explorer), with three exceptions:
+
+* Its name is shorter
+* "up" and "down" actually move the stack pointer in those directions
+* You can type "stack" instead of "show-stack"
+* It has a fresh pine scent
+
+License
+-------
+
+(The MIT License)
+
+Copyright (c) 2015 Barry Allard ([steakknife](http://github.com/steakknife))
+Copyright (c) 2014 Chris Gahan ([epitron](http://github.com/epitron))
+Copyright (c) 2011 John Mair ([banisterfiend](http://github.com/banisterfiend))
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,30 @@
+gem_version = File.read("VERSION").strip
+gem_name = "pry-stack"
+
+desc "Build the gem"
+task :build do
+  system "gem build .gemspec"
+end
+ 
+desc "Build and push the gem to rubygems.org"
+task :release => :build do
+  system "gem push #{gem_name}-#{gem_version}.gem"
+end
+
+desc "Build and install the gem"
+task :install => :build do
+  system "gem install #{gem_name}-#{gem_version}.gem"
+end
+
+task :default => :test
+
+desc "Run bacon tests"
+task :test do
+  sh "bacon -Itest -rubygems -a -q"
+end
+
+desc "Load this checked out git repo in pry"
+task :pry do
+  system "pry --gem"
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.5.0

data/examples/example.rb

@@ -0,0 +1,45 @@
+unless Object.const_defined? :PryStack
+  $:.unshift File.expand_path '../../lib', __FILE__
+  require 'pry'
+end
+
+require 'pry-stack'
+
+def alphabet(y)
+  x = 20
+  b
+end
+
+def b
+  x = 30
+  proc {
+    c
+  }.call
+end
+
+def c
+  u = 50
+  binding.pry
+end
+
+# hello
+def beta
+  gamma
+end
+
+def gamma
+  zeta
+end
+
+def zeta
+  vitamin = 100
+  binding.pry
+end
+#
+
+proc {
+  class J
+    alphabet(22)
+  end
+}.call
+

data/examples/example2.rb

@@ -0,0 +1,18 @@
+unless Object.const_defined? :PryStack
+  $:.unshift File.expand_path '../../lib', __FILE__
+  require 'pry'
+end
+
+require 'pry-stack'
+
+def alpha
+  x = "hello"
+  beta
+  puts x
+end
+
+def beta
+  binding.pry
+end
+
+alpha

data/examples/example3.rb

@@ -0,0 +1,46 @@
+unless Object.const_defined? :PryStack
+  $:.unshift File.expand_path '../../lib', __FILE__
+  require 'pry'
+end
+
+require 'pry-stack'
+
+def b
+  x = 30
+  proc {
+    c
+  }.call
+end
+
+def c
+  u = 50
+  V.new.beta
+end
+
+# hello
+class V
+  def beta
+    gamma
+  end
+
+  def gamma
+    zeta
+  end
+end
+
+def zeta
+  vitamin = 100
+  binding.pry
+end
+#
+
+proc {
+  class J
+    def alphabet(y)
+      x = 20
+      b
+    end
+  end
+}.call
+
+J.new.alphabet(122)

data/lib/pry-stack.rb

@@ -0,0 +1,133 @@
+# pry-stack.rb
+# (C) John Mair (banisterfiend); MIT license
+
+require "pry-stack/commands"
+require "pry-stack/frame_manager"
+require "pry-stack/when_started_hook"
+require "binding_of_caller"
+
+module PryStack
+
+  class << self
+    # @return [Hash] The hash storing all frames for all Pry instances for
+    #   the current thread.
+    def frame_hash
+      Thread.current[:__pry_frame_managers__] ||= Hash.new { |h, k| h[k] = [] }
+    end
+
+    # Return the complete frame manager stack for the Pry instance
+    # @param [Pry] _pry_ The Pry instance associated with the frame
+    #   managers
+    # @return [Array] The stack of Pry::FrameManager objections
+    def frame_managers(_pry_)
+      frame_hash[_pry_]
+    end
+
+    # Create a `Pry::FrameManager` object and push it onto the frame
+    # manager stack for the relevant `_pry_` instance.
+    # @param [Array] bindings The array of bindings (frames)
+    # @param [Pry] _pry_ The Pry instance associated with the frame manager
+    def create_and_push_frame_manager(bindings, _pry_, options={})
+      fm = FrameManager.new(bindings, _pry_)
+      frame_hash[_pry_].push fm
+      push_helper(fm, options)
+      fm
+    end
+
+    # Update the Pry instance to operate on the specified frame for the
+    # current frame manager.
+    # @param [PryStack::FrameManager] fm The active frame manager.
+    # @param [Hash] options The options hash.
+    def push_helper(fm, options={})
+      options = {
+        :initial_frame => 0
+      }.merge!(options)
+
+      fm.change_frame_to(options[:initial_frame], false)
+    end
+
+    private :push_helper
+
+    # Delete the currently active frame manager
+    # @param [Pry] _pry_ The Pry instance associated with the frame
+    #   managers.
+    # @return [Pry::FrameManager] The popped frame manager.
+    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
+
+    # Restore the Pry instance to operate on the previous
+    # binding. Also responsible for restoring Pry instance's backtrace.
+    # @param [Pry::FrameManager] popped_fm The recently popped frame manager.
+    # @param [Pry] _pry_ The Pry instance associated with the frame managers.
+    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
+
+    private :pop_helper
+
+    # Clear the stack of frame managers for the Pry instance
+    # @param [Pry] _pry_ The Pry instance associated with the frame managers
+    def clear_frame_managers(_pry_)
+      pop_frame_manager(_pry_) until frame_managers(_pry_).empty?
+      frame_hash.delete(_pry_) # this line should be unnecessary!
+    end
+
+    alias_method :delete_frame_managers, :clear_frame_managers
+
+    # @return [PryStack::FrameManager] The currently active frame manager
+    def frame_manager(_pry_)
+      frame_hash[_pry_].last
+    end
+
+    # Simple test to check whether two `Binding` objects are equal.
+    # @param [Binding] b1 First binding.
+    # @param [Binding] b2 Second binding.
+    # @return [Boolean] Whether the `Binding`s are equal.
+    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
+  end
+end
+
+Pry.config.hooks.add_hook(:after_session, :delete_frame_manager) do |_, _, _pry_|
+  PryStack.clear_frame_managers(_pry_)
+end
+
+Pry.config.hooks.add_hook(:when_started, :save_caller_bindings, PryStack::WhenStartedHook.new)
+
+# Import the Stack commands
+Pry.config.commands.import PryStack::Commands
+
+# monkey-patch the whereami command to show some frame information,
+# useful for navigating stack.
+Pry.config.commands.before_command("whereami") do |num|
+  if PryStack.frame_manager(_pry_) && !internal_binding?(target)
+    bindings      = PryStack.frame_manager(_pry_).bindings
+    binding_index = PryStack.frame_manager(_pry_).binding_index
+
+    output.puts "\n"
+    output.puts "#{Pry::Helpers::Text.bold('Frame number:')} #{binding_index}/#{bindings.size - 1}"
+    output.puts "#{Pry::Helpers::Text.bold('Frame type:')} #{bindings[binding_index].frame_type}" if bindings[binding_index].frame_type
+  end
+end

data/lib/pry-stack/commands.rb

@@ -0,0 +1,316 @@
+module PryStack
+  module FrameHelpers
+    private
+
+    # @return [PryStack::FrameManager] The active frame manager for
+    #   the current `Pry` instance.
+    def frame_manager
+      PryStack.frame_manager(_pry_)
+    end
+
+    # @return [Array<PryStack::FrameManager>] All the frame
+    #   managers for the current `Pry` instance.
+    def frame_managers
+      PryStack.frame_managers(_pry_)
+    end
+
+    # @return [Boolean] Whether there is a context to return to once
+    #   the current `frame_manager` is popped.
+    def prior_context_exists?
+      frame_managers.count > 1 || frame_manager.prior_binding
+    end
+
+    # Return a description of the frame (binding).
+    # This is only useful for regular old bindings that have not been
+    # enhanced by `#of_caller`.
+    # @param [Binding] b The binding.
+    # @return [String] A description of the frame (binding).
+    def frame_description(b)
+      b_self = b.eval('self')
+      b_method = b.eval('__method__')
+
+      if b_method && b_method != :__binding__ && b_method != :__binding_impl__
+        b_method.to_s
+      elsif b_self.instance_of?(Module)
+        "<module:#{b_self}>"
+      elsif b_self.instance_of?(Class)
+        "<class:#{b_self}>"
+      else
+        "<main>"
+      end
+    end
+
+    # Return a description of the passed binding object. Accepts an
+    # optional `verbose` parameter.
+    # @param [Binding] b The binding.
+    # @param [Boolean] verbose Whether to generate a verbose description.
+    # @return [String] The description of the binding.
+    def frame_info(b, verbose = false)
+      meth = b.eval('__method__')
+      b_self = b.eval('self')
+      meth_obj = Pry::Method.from_binding(b) if meth
+
+      type = b.frame_type ? "[#{b.frame_type}]".ljust(9) : ""
+      desc = b.frame_description ? "#{b.frame_description}" : "#{frame_description(b)}"
+      sig = meth_obj ? "<#{signature_with_owner(meth_obj)}>" : ""
+
+      self_clipped = "#{Pry.view_clip(b_self)}"
+      path = "@ #{b.eval('__FILE__')}:#{b.eval('__LINE__')}"
+
+      if !verbose
+        "#{type} #{desc} #{sig}"
+      else
+        "#{type} #{desc} #{sig}\n      in #{self_clipped} #{path}"
+      end
+    end
+
+    # @param [Pry::Method] meth_obj The method object.
+    # @return [String] Signature for the method object in Class#method format.
+    def signature_with_owner(meth_obj)
+      if !meth_obj.undefined?
+        args = meth_obj.parameters.inject([]) do |arr, (type, name)|
+          name ||= (type == :block ? 'block' : "arg#{arr.size + 1}")
+          arr << case type
+                 when :req   then name.to_s
+                 when :opt   then "#{name}=?"
+                 when :rest  then "*#{name}"
+                 when :block then "&#{name}"
+                 else '?'
+                 end
+        end
+        "#{meth_obj.name_with_owner}(#{args.join(', ')})"
+      else
+        "#{meth_obj.name_with_owner}(UNKNOWN) (undefined method)"
+      end
+    end
+
+    #  Regexp.new(args[0])
+    def find_frame_by_regex(regex, up_or_down)
+      frame_index = find_frame_by_block(up_or_down) do |b|
+        b.eval("__method__").to_s =~ regex
+      end
+
+      if frame_index
+        frame_index
+      else
+        raise Pry::CommandError, "No frame that matches #{regex.source} found!"
+      end
+    end
+
+    def find_frame_by_object_regex(class_regex, method_regex, up_or_down)
+      frame_index = find_frame_by_block(up_or_down) do |b|
+        class_match = b.eval("self.class").to_s =~ class_regex
+        meth_match = b.eval("__method__").to_s =~ method_regex
+
+        class_match && meth_match
+      end
+
+      if frame_index
+        frame_index
+      else
+        raise Pry::CommandError, "No frame that matches #{class_regex.source}" + '#' + "#{method_regex.source} found!"
+      end
+    end
+
+    def find_frame_by_block(up_or_down)
+      start_index = frame_manager.binding_index
+
+      if up_or_down == :down
+        enum = frame_manager.bindings[0..start_index - 1].reverse_each
+      else
+        enum = frame_manager.bindings[start_index + 1..-1]
+      end
+
+      new_frame = enum.find do |b|
+        yield(b)
+      end
+
+      frame_index = frame_manager.bindings.index(new_frame)
+    end
+  end
+
+
+  Commands = Pry::CommandSet.new do
+    create_command "up", "Go up to the caller's context." do
+      include FrameHelpers
+
+      banner <<-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 1 stack frame.
+          e.g: up 3    #=> Move up 2 stack frames.
+          e.g: up meth #=> Jump to nearest parent stack frame whose method matches /meth/ regex, i.e `my_method`.
+      BANNER
+
+      def process
+        inc = args.first.nil? ? "1" : args.first
+
+        if !frame_manager
+          raise Pry::CommandError, "Nowhere to go!"
+        else
+          if inc =~ /\d+/
+            frame_manager.change_frame_to frame_manager.binding_index + inc.to_i
+          elsif match = /^([A-Z]+[^#.]*)(#|\.)(.+)$/.match(inc)
+            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 inc =~ /^[^-].*$/
+            new_frame_index = find_frame_by_regex(Regexp.new(inc), :up)
+            frame_manager.change_frame_to new_frame_index
+          end
+        end
+      end
+    end
+
+    create_command "down", "Go down to the callee's context." do
+      include FrameHelpers
+
+      banner <<-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 1 stack frame.
+          e.g: down 3    #=> Move down 2 stack frames.
+          e.g: down meth #=> Jump to nearest child stack frame whose method matches /meth/ regex, i.e `my_method`.
+      BANNER
+
+      def process
+        inc = args.first.nil? ? "1" : args.first
+
+        if !frame_manager
+          raise Pry::CommandError, "Nowhere to go!"
+        else
+          if inc =~ /\d+/
+            if frame_manager.binding_index - inc.to_i < 0
+              raise Pry::CommandError, "At bottom of stack, cannot go further!"
+            else
+              frame_manager.change_frame_to frame_manager.binding_index - inc.to_i
+            end
+          elsif match = /^([A-Z]+[^#.]*)(#|\.)(.+)$/.match(inc)
+            new_frame_index = find_frame_by_object_regex(Regexp.new(match[1]), Regexp.new(match[3]), :down)
+            frame_manager.change_frame_to new_frame_index
+          elsif inc =~ /^[^-].*$/
+            new_frame_index = find_frame_by_regex(Regexp.new(inc), :down)
+            frame_manager.change_frame_to new_frame_index
+          end
+        end
+      end
+    end
+
+    create_command "frame", "Switch to a particular frame." do
+      include FrameHelpers
+
+      banner <<-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
+        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 "stack", "Show all frames" do
+      include FrameHelpers
+
+      banner <<-BANNER
+        Usage: stack [OPTIONS]
+          Show all accessible stack frames.
+          e.g: show-stack -v
+      BANNER
+
+      def options(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.to_a.reverse.each 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
+
+    alias_command "show-stack", "stack"
+
+  end
+end