pry 0.10.pre.1-java → 0.10.0.pre2-java

data/lib/pry/commands.rb

@@ -1,29 +1,6 @@
-require "pry/default_commands/misc"
-require "pry/default_commands/help"
-require "pry/default_commands/gems"
-require "pry/default_commands/context"
-require "pry/default_commands/commands"
-require "pry/default_commands/input_and_output"
-require "pry/default_commands/introspection"
-require "pry/default_commands/editing"
-require "pry/default_commands/navigating_pry"
-require "pry/default_commands/easter_eggs"
+# Default commands used by Pry.
+Pry::Commands = Pry::CommandSet.new
 
-require "pry/extended_commands/experimental"
-
-class Pry
-
-  # Default commands used by Pry.
-  Commands = Pry::CommandSet.new do
-    import DefaultCommands::Misc
-    import DefaultCommands::Help
-    import DefaultCommands::Gems
-    import DefaultCommands::Context
-    import DefaultCommands::NavigatingPry
-    import DefaultCommands::Editing
-    import DefaultCommands::InputAndOutput
-    import DefaultCommands::Introspection
-    import DefaultCommands::EasterEggs
-    import DefaultCommands::Commands
-  end
+Dir[File.expand_path('../commands', __FILE__) << '/*.rb'].each do |file|
+  require file
 end

data/lib/pry/commands/amend_line.rb

@@ -0,0 +1,99 @@
+class Pry
+  class Command::AmendLine < Pry::ClassCommand
+    match(/amend-line(?: (-?\d+)(?:\.\.(-?\d+))?)?/)
+    group 'Editing'
+    description 'Amend a line of input in multi-line mode.'
+    command_options :interpolate => false, :listing => 'amend-line'
+
+    banner <<-'BANNER'
+      Amend a line of input in multi-line mode. `amend-line N`, where the N represents
+      line to replace. Can also specify a range of lines using `amend-line N..M`
+      syntax. Passing "!" as replacement content deletes the line(s) instead.
+
+      amend-line 1 puts 'new'    # replace line 1
+      amend-line 1..4 !          # delete lines 1..4
+      amend-line 3 >puts 'bye'   # insert before line 3
+      amend-line puts 'appended' # no line number modifies immediately preceding line
+    BANNER
+
+    def process
+      raise CommandError, "No input to amend." if eval_string.empty?
+
+      eval_string.replace amended_input(eval_string)
+      run "fix-indent"
+      run "show-input"
+    end
+
+    private
+
+    # @param [String] string The string to amend.
+    # @return [String] A new string with the amendments applied to it.
+    def amended_input(string)
+      input_array = eval_string.each_line.to_a
+
+      if arg_string == "!"
+        delete_from_array(input_array, line_range)
+      elsif arg_string.start_with?(">")
+        insert_into_array(input_array, line_range)
+      else
+        replace_in_array(input_array, line_range)
+      end
+
+      input_array.join
+    end
+
+    def delete_from_array(array, range)
+      array.slice!(range)
+    end
+
+    def insert_into_array(array, range)
+      insert_slot = Array(range).first
+      array.insert(insert_slot, arg_string[1..-1] << "\n")
+    end
+
+    def replace_in_array(array, range)
+      array[range] = arg_string + "\n"
+    end
+
+    # @return [Fixnum] The number of lines currently in `eval_string` (the input buffer).
+    def line_count
+      eval_string.lines.count
+    end
+
+    # Returns the (one-indexed) start and end lines given by the user.
+    # The lines in this range will be affected by the `amend-line`.
+    # Returns `nil` if no lines were specified by the user.
+    # @return [Array<Fixnum>, nil]
+    def start_and_end_line_number
+      start_line_number, end_line_number = args
+      end_line_number ||= start_line_number.to_i
+
+      [start_line_number.to_i, end_line_number.to_i] if start_line_number
+    end
+
+    # Takes two numbers that are 1-indexed, and returns a range (or
+    # number) that is 0-indexed. 1-indexed means the first element is
+    # indentified by 1 rather than by 0 (as is the case for Ruby arrays).
+    # @param [Fixnum] start_line_number One-indexed number.
+    # @param [Fixnum] end_line_number One-indexed number.
+    # @return [Range] The zero-indexed range.
+    def zero_indexed_range_from_one_indexed_numbers(start_line_number, end_line_number)
+      # FIXME: one_index_number is a horrible name for this method
+      one_index_number(start_line_number)..one_index_number(end_line_number)
+    end
+
+    # The lines (or line) that will be modified by the `amend-line`.
+    # @return [Range, Fixnum] The lines or line.
+    def line_range
+      start_line_number, end_line_number = start_and_end_line_number
+      if start_line_number
+        zero_indexed_range_from_one_indexed_numbers(start_line_number,
+                                                    end_line_number)
+      else
+        line_count - 1
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::AmendLine)
+end

data/lib/pry/commands/bang.rb

@@ -0,0 +1,20 @@
+class Pry
+  class Command::Bang < Pry::ClassCommand
+    match /^\s*!\s*$/
+    group 'Editing'
+    description 'Clear the input buffer.'
+    command_options :use_prefix => false
+
+    banner <<-'BANNER'
+      Clear the input buffer. Useful if the parsing process goes wrong and you get
+      stuck in the read loop.
+    BANNER
+
+    def process
+      output.puts 'Input buffer cleared!'
+      eval_string.replace('')
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Bang)
+end

data/lib/pry/commands/bang_pry.rb

@@ -0,0 +1,17 @@
+class Pry
+  class Command::BangPry < Pry::ClassCommand
+    match '!pry'
+    group 'Navigating Pry'
+    description 'Start a Pry session on current self.'
+
+    banner <<-'BANNER'
+      Start a Pry session on current self. Also works mid multi-line expression.
+    BANNER
+
+    def process
+      target.pry
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::BangPry)
+end

data/lib/pry/commands/cat.rb

@@ -0,0 +1,62 @@
+class Pry
+  class Command::Cat < Pry::ClassCommand
+    require 'pry/commands/cat/abstract_formatter.rb'
+    require 'pry/commands/cat/input_expression_formatter.rb'
+    require 'pry/commands/cat/exception_formatter.rb'
+    require 'pry/commands/cat/file_formatter.rb'
+
+    match 'cat'
+    group 'Input and Output'
+    description "Show code from a file, Pry's input buffer, or the last exception."
+
+    banner <<-'BANNER'
+      Usage: cat FILE
+             cat --ex [STACK_INDEX]
+             cat --in [INPUT_INDEX_OR_RANGE]
+
+      `cat` is capable of showing part or all of a source file, the context of the
+      last exception, or an expression from Pry's input history.
+
+      `cat --ex` defaults to showing the lines surrounding the location of the last
+      exception. Invoking it more than once travels up the exception's backtrace, and
+      providing a number shows the context of the given index of the backtrace.
+    BANNER
+
+    def options(opt)
+      opt.on :ex,        "Show the context of the last exception", :optional_argument => true, :as => Integer
+      opt.on :i, :in,    "Show one or more entries from Pry's expression history", :optional_argument => true, :as => Range, :default => -5..-1
+      opt.on :s, :start, "Starting line (defaults to the first line)", :optional_argument => true, :as => Integer
+      opt.on :e, :end,   "Ending line (defaults to the last line)", :optional_argument => true, :as => Integer
+      opt.on :l, :'line-numbers', "Show line numbers"
+      opt.on :t, :type,  "The file type for syntax highlighting (e.g., 'ruby' or 'python')", :argument => true, :as => Symbol
+    end
+
+    def process
+      output = case
+               when opts.present?(:ex)
+                 ExceptionFormatter.new(_pry_.last_exception, _pry_, opts).format
+               when opts.present?(:in)
+                 InputExpressionFormatter.new(_pry_.input_array, opts).format
+               else
+                 FileFormatter.new(args.first, _pry_, opts).format
+               end
+
+      _pry_.pager.page output
+    end
+
+    def complete(search)
+      super | load_path_completions
+    end
+
+    def load_path_completions
+      $LOAD_PATH.flat_map do |path|
+        Dir[path + '/**/*'].map { |f|
+          next if File.directory?(f)
+          f.sub!(path + '/', '')
+        }
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Cat)
+end

data/lib/pry/commands/cat/abstract_formatter.rb

@@ -0,0 +1,27 @@
+class Pry
+  class Command::Cat
+    class AbstractFormatter
+      include Pry::Helpers::CommandHelpers
+      include Pry::Helpers::BaseHelpers
+
+      private
+      def decorate(content)
+        content.code_type = code_type
+        content.between(*between_lines).
+          with_line_numbers(use_line_numbers?)
+      end
+
+      def code_type
+        opts[:type] || :ruby
+      end
+
+      def use_line_numbers?
+        opts.present?(:'line-numbers') || opts.present?(:ex)
+      end
+
+      def between_lines
+        [opts[:start] || 1, opts[:end] || -1]
+      end
+    end
+  end
+end

data/lib/pry/commands/cat/exception_formatter.rb

@@ -0,0 +1,77 @@
+class Pry
+  class Command::Cat
+    class ExceptionFormatter < AbstractFormatter
+      attr_reader :ex
+      attr_reader :opts
+      attr_reader :_pry_
+
+      def initialize(exception, _pry_, opts)
+        @ex = exception
+        @opts = opts
+        @_pry_ = _pry_
+      end
+
+      def format
+        check_for_errors
+        set_file_and_dir_locals(backtrace_file, _pry_, _pry_.current_context)
+        code = decorate(Pry::Code.from_file(backtrace_file).
+                                    between(*start_and_end_line_for_code_window).
+                                    with_marker(backtrace_line)).to_s
+        "#{header}#{code}"
+      end
+
+      private
+
+      def code_window_size
+        _pry_.config.default_window_size || 5
+      end
+
+      def backtrace_level
+        return @backtrace_level if @backtrace_level
+
+        bl =  if opts[:ex].nil?
+                ex.bt_index
+              else
+                ex.bt_index = absolute_index_number(opts[:ex], ex.backtrace.size)
+              end
+
+        increment_backtrace_level
+        @backtrace_level = bl
+      end
+
+      def increment_backtrace_level
+        ex.inc_bt_index
+      end
+
+      def backtrace_file
+        Array(ex.bt_source_location_for(backtrace_level)).first
+      end
+
+      def backtrace_line
+        Array(ex.bt_source_location_for(backtrace_level)).last
+      end
+
+      def check_for_errors
+        raise CommandError, "No exception found." unless ex
+        raise CommandError, "The given backtrace level is out of bounds." unless backtrace_file
+      end
+
+      def start_and_end_line_for_code_window
+        start_line = backtrace_line - code_window_size
+        start_line = 1 if start_line < 1
+
+        [start_line, backtrace_line + code_window_size]
+      end
+
+      def header
+        unindent %{
+        #{Helpers::Text.bold 'Exception:'} #{ex.class}: #{ex.message}
+        --
+        #{Helpers::Text.bold('From:')} #{backtrace_file} @ line #{backtrace_line} @ #{Helpers::Text.bold("level: #{backtrace_level}")} of backtrace (of #{ex.backtrace.size - 1}).
+
+      }
+      end
+
+    end
+  end
+end

data/lib/pry/commands/cat/file_formatter.rb

@@ -0,0 +1,67 @@
+class Pry
+  class Command::Cat
+    class FileFormatter < AbstractFormatter
+      attr_reader :file_with_embedded_line
+      attr_reader :opts
+      attr_reader :_pry_
+
+      def initialize(file_with_embedded_line, _pry_, opts)
+        @file_with_embedded_line = file_with_embedded_line
+        @opts = opts
+        @_pry_ = _pry_
+        @code_from_file = Pry::Code.from_file(file_name)
+      end
+
+      def format
+        raise CommandError, "Must provide a filename, --in, or --ex." if !file_with_embedded_line
+
+        set_file_and_dir_locals(file_name, _pry_, _pry_.current_context)
+        decorate(@code_from_file)
+      end
+
+      def file_and_line
+        file_name, line_num = file_with_embedded_line.split(/:(?!\/|\\)/)
+
+        [file_name, line_num ? line_num.to_i : nil]
+      end
+
+      private
+
+      def file_name
+        file_and_line.first
+      end
+
+      def line_number
+        file_and_line.last
+      end
+
+      def code_window_size
+        _pry_.config.default_window_size || 7
+      end
+
+      def decorate(content)
+        line_number ? super.around(line_number, code_window_size) : super
+      end
+
+      def code_type
+        opts[:type] || detect_code_type_from_file(file_name)
+      end
+
+      def detect_code_type_from_file(file_name)
+        code_type = @code_from_file.code_type
+
+        if code_type == :unknown
+          name, ext = File.basename(file_name).split('.', 2)
+          case name
+          when "Rakefile", "Gemfile"
+            :ruby
+          else
+            :text
+          end
+        else
+          code_type
+        end
+      end
+    end
+  end
+end

data/lib/pry/commands/cat/input_expression_formatter.rb

@@ -0,0 +1,43 @@
+class Pry
+  class Command::Cat
+    class InputExpressionFormatter < AbstractFormatter
+      attr_accessor :input_expressions
+      attr_accessor :opts
+
+      def initialize(input_expressions, opts)
+        @input_expressions = input_expressions
+        @opts = opts
+      end
+
+      def format
+        raise CommandError, "No input expressions!" if numbered_input_items.length < 1
+
+        if numbered_input_items.length > 1
+          content = ""
+          numbered_input_items.each do |i, s|
+            content << "#{Helpers::Text.bold(i.to_s)}:\n" << decorate(Pry::Code(s).with_indentation(2)).to_s
+          end
+
+          content
+        else
+          decorate(Pry::Code(selected_input_items.first)).to_s
+        end
+      end
+
+      private
+
+      def selected_input_items
+        input_expressions[normalized_expression_range] || []
+      end
+
+      def numbered_input_items
+        @numbered_input_items ||= normalized_expression_range.zip(selected_input_items).
+          reject { |_, s| s.nil? || s == "" }
+      end
+
+      def normalized_expression_range
+        absolute_index_range(opts[:i], input_expressions.length)
+      end
+    end
+  end
+end