pry-stack_explorer 0.3.5 → 0.3.6

data/lib/pry-stack_explorer/commands.rb

@@ -3,14 +3,21 @@ require 'pry'
 module PryStackExplorer
   module FrameHelpers
     private
+
+    # @return [PryStackExplorer::FrameManager] The active frame manager for
+    #   the current `Pry` instance.
     def frame_manager
       PryStackExplorer.frame_manager(_pry_)
     end
 
+    # @return [Array<PryStackExplorer::FrameManager>] All the frame
+    #   managers for the current `Pry` instance.
     def frame_managers
       PryStackExplorer.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
@@ -59,6 +66,8 @@ module PryStackExplorer
       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)|
@@ -136,6 +145,8 @@ module PryStackExplorer
 
       def options(opt)
         opt.on :v, :verbose, "Include extra information."
+        opt.on :H, :head, "Display the first N stack frames (defaults to 10).", :optional => true, :as => Integer, :default => 10
+        opt.on :T, :tail, "Display the last N stack frames (defaults to 10).", :optional => true, :as => Integer, :default => 10
       end
 
       def memoized_info(index, b, verbose)
@@ -148,6 +159,28 @@ module PryStackExplorer
         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]]
+        else
+          [0, frame_manager.bindings]
+        end
+      end
+
+      private :selected_stack_frames
+
       def process
         if !frame_manager
           output.puts "No caller stack available!"
@@ -155,7 +188,9 @@ module PryStackExplorer
           content = ""
           content << "\n#{text.bold("Showing all accessible frames in stack (#{frame_manager.bindings.size} in total):")}\n--\n"
 
-          frame_manager.each_with_index do |b, i|
+          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
@@ -169,7 +204,6 @@ module PryStackExplorer
       end
     end
 
-
     create_command "frame", "Switch to a particular frame. Accepts numeric parameter for the target frame to switch to (use with show-stack). Negative frame numbers allowed." do
       include FrameHelpers
 

data/lib/pry-stack_explorer/version.rb

@@ -1,3 +1,3 @@
 module PryStackExplorer
-  VERSION = "0.3.5"
+  VERSION = "0.3.6"
 end

data/pry-stack_explorer.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = "pry-stack_explorer"
-  s.version = "0.3.5"
+  s.version = "0.3.6"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["John Mair (banisterfiend)"]

metadata

@@ -2,7 +2,7 @@
 name: pry-stack_explorer
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.3.5
+  version: 0.3.6
 platform: ruby
 authors: 
 - John Mair (banisterfiend)