pry 0.9.10 → 0.9.11

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

@@ -0,0 +1,84 @@
+class Pry
+  class Command::Cat
+    class FileFormatter < AbstractFormatter
+      attr_accessor :file_with_embedded_line
+      attr_accessor :opts
+      attr_accessor :_pry_
+
+      def initialize(file_with_embedded_line, _pry_, opts)
+        @file_with_embedded_line = file_with_embedded_line
+        @opts = opts
+        @_pry_ = _pry_
+      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(Pry::Code.from_file(file_name))
+      end
+
+      private
+
+      def file_and_line
+        file_name, line_num = file_with_embedded_line.split(':')
+
+        [File.expand_path(file_name), line_num ? line_num.to_i : nil]
+      end
+
+      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)
+        name, ext = File.basename(file_name).split('.', 2)
+
+        if ext
+          case ext
+          when "py"
+            :python
+          when "rb", "gemspec", "rakefile", "ru", "pryrc", "irbrc"
+            :ruby
+          when "js"
+            return :javascript
+          when "yml", "prytheme"
+            :yaml
+          when "groovy"
+            :groovy
+          when "c"
+            :c
+          when "cpp"
+            :cpp
+          when "java"
+            :java
+          else
+            :text
+          end
+        else
+          case name
+          when "Rakefile", "Gemfile"
+            :ruby
+          else
+            :text
+          end
+        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

data/lib/pry/commands/cd.rb

@@ -0,0 +1,30 @@
+class Pry
+  class Command::Cd < Pry::ClassCommand
+    match 'cd'
+    group 'Context'
+    description 'Move into a new context (object or scope).'
+
+    banner <<-'BANNER'
+      Usage: cd [OPTIONS] [--help]
+
+      Move into new context (object or scope). As in UNIX shells use `cd ..` to go
+      back, `cd /` to return to Pry top-level and `cd -` to toggle between last two
+      scopes. Complex syntax (e.g `cd ../@x/y`) also supported.
+
+      cd @x
+      cd ..
+      cd /
+      cd -
+
+      https://github.com/pry/pry/wiki/State-navigation#wiki-Changing_scope
+    BANNER
+
+    def process
+      state.old_stack ||= []
+      stack, state.old_stack = context_from_object_path(arg_string, _pry_, state.old_stack)
+      _pry_.binding_stack = stack if stack
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Cd)
+end

data/lib/pry/commands/code_collector.rb

@@ -0,0 +1,165 @@
+class Pry
+  class Command::CodeCollector
+    include Helpers::CommandHelpers
+
+    attr_accessor :args
+    attr_accessor :opts
+    attr_accessor :_pry_
+
+    # The name of the explicitly given file (if any).
+    attr_accessor :file
+
+    class << self
+      attr_accessor :input_expression_ranges
+      attr_accessor :output_result_ranges
+    end
+
+    @input_expression_ranges = []
+    @output_result_ranges = []
+
+    def initialize(args, opts, _pry_)
+      @args = args
+      @opts = opts
+      @_pry_ = _pry_
+    end
+
+    # Add the `--lines`, `-o`, `-i`, `-s`, `-d` options.
+    def self.inject_options(opt)
+      @input_expression_ranges = []
+      @output_result_ranges = []
+
+      opt.on :l, :lines, "Restrict to a subset of lines. Takes a line number or range",
+                         :optional_argument => true, :as => Range, :default => 1..-1
+      opt.on :o, :out,   "Select lines from Pry's output result history. Takes an index or range",
+      :optional_argument => true, :as => Range, :default => -5..-1 do |r|
+        output_result_ranges << (r || (-5..-1))
+      end
+      opt.on :i, :in,    "Select lines from Pry's input expression history. Takes an index or range",
+      :optional_argument => true, :as => Range, :default => -5..-1 do |r|
+        input_expression_ranges << (r || (-5..-1))
+      end
+      opt.on :s, :super, "Select the 'super' method. Can be repeated to traverse the ancestors",
+                         :as => :count
+      opt.on :d, :doc,   "Select lines from the code object's documentation"
+    end
+
+    # The content (i.e code/docs) for the selected object.
+    # If the user provided a bare code object, it returns the source.
+    # If the user provided the `-i` or `-o` switches, it returns the
+    # selected input/output lines joined as a string. If the user used
+    # `-d CODE_OBJECT` it returns the docs for that code object.
+    #
+    # @return [String]
+    def content
+      return @content if @content
+      raise CommandError, "Only one of --out, --in, --doc and CODE_OBJECT may be specified." if bad_option_combination?
+
+      content = case
+                when opts.present?(:o)
+                  pry_output_content
+                when opts.present?(:i)
+                  pry_input_content
+                when opts.present?(:d)
+                  code_object_doc
+                else
+                  code_object_source_or_file
+                end
+
+      @content ||= restrict_to_lines(content, line_range)
+    end
+
+    # The code object
+    #
+    # @return [Pry::WrappedModule, Pry::Method, Pry::Command]
+    def code_object
+      Pry::CodeObject.lookup(obj_name, _pry_,  :super =>  opts[:super])
+    end
+
+    # Given a string and a range, return the `range` lines of that
+    # string.
+    #
+    # @param [String] content
+    # @param [Range, Fixnum] range
+    # @return [String] The string restricted to the given range
+    def restrict_to_lines(content, range)
+      Array(content.lines.to_a[range]).join
+    end
+
+    # The selected `_pry_.output_array` as a string, as specified by
+    # the `-o` switch.
+    #
+    # @return [String]
+    def pry_output_content
+      pry_array_content_as_string(_pry_.output_array, self.class.output_result_ranges) do |v|
+        Pry.config.gist.inspecter.call(v)
+      end
+    end
+
+    # The selected `_pry_.input_array` as a string, as specified by
+    # the `-i` switch.
+    #
+    # @return [String]
+    def pry_input_content
+      pry_array_content_as_string(_pry_.input_array, self.class.input_expression_ranges) { |v| v }
+    end
+
+    # The line range passed to `--lines`, converted to a 0-indexed range.
+    def line_range
+      opts.present?(:lines) ? one_index_range_or_number(opts[:lines]) : 0..-1
+    end
+
+    # Name of the object argument
+    def obj_name
+      @obj_name ||= args.empty? ? no_arg : args.join(" ")
+    end
+
+    private
+
+    def bad_option_combination?
+      [opts.present?(:in), opts.present?(:out),
+       !args.empty?].count(true) > 1
+    end
+
+    def pry_array_content_as_string(array, ranges, &block)
+      all = ''
+      ranges.each do |range|
+        raise CommandError, "Minimum value for range is 1, not 0." if convert_to_range(range).first == 0
+
+        ranged_array = Array(array[range]) || []
+        ranged_array.compact.each { |v| all << block.call(v) }
+      end
+
+      all
+    end
+
+    def code_object_doc
+      (code_object && code_object.doc) or could_not_locate(obj_name)
+    end
+
+    def code_object_source_or_file
+      (code_object && code_object.source) || file_content
+    end
+
+    def file_content
+      if File.exists?(obj_name)
+        # Set the file accessor.
+        self.file = obj_name
+        File.read(obj_name)
+      else
+        could_not_locate(obj_name)
+      end
+    end
+
+    def could_not_locate(name)
+      raise CommandError, "Cannot locate: #{name}!"
+    end
+
+    def convert_to_range(n)
+      if !n.is_a?(Range)
+        (n..n)
+      else
+        n
+      end
+    end
+  end
+end

data/lib/pry/commands/deprecated_commands.rb

@@ -0,0 +1,2 @@
+Pry::Commands.deprecated_command("edit-method", "Use `edit` instead.")
+Pry::Commands.deprecated_command("show-command", "Use show-source [command_name] instead.")

data/lib/pry/commands/disable_pry.rb

@@ -0,0 +1,27 @@
+class Pry
+  class Command::DisablePry < Pry::ClassCommand
+    match 'disable-pry'
+    group 'Navigating Pry'
+    description 'Stops all future calls to pry and exits the current session.'
+
+    banner <<-'BANNER'
+      Usage: disable-pry
+
+      After this command is run any further calls to pry will immediately return `nil`
+      without interrupting the flow of your program. This is particularly useful when
+      you've debugged the problem you were having, and now wish the program to run to
+      the end.
+
+      As alternatives, consider using `exit!` to force the current Ruby process
+      to quit immediately; or using `edit-method -p` to remove the `binding.pry`
+      from the code.
+    BANNER
+
+    def process
+      ENV['DISABLE_PRY'] = 'true'
+      _pry_.run_command "exit"
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::DisablePry)
+end

data/lib/pry/commands/easter_eggs.rb

@@ -0,0 +1,112 @@
+class Pry
+  Pry::Commands.instance_eval do
+    command "nyan-cat", "", :requires_gem => ["nyancat"] do
+      run ".nyancat"
+    end
+
+    command(/!s\/(.*?)\/(.*?)/, "") do |source, dest|
+      eval_string.gsub!(/#{source}/) { dest }
+      run "show-input"
+    end
+
+    command "get-naked", "" do
+      text = %{
+  --
+  We dont have to take our clothes off to have a good time.
+  We could dance & party all night And drink some cherry wine.
+  -- Jermaine Stewart }
+      output.puts text
+      text
+    end
+
+    command "east-coker", "" do
+      text = %{
+  --
+  Now the light falls
+  Across the open field, leaving the deep lane
+  Shuttered with branches, dark in the afternoon,
+  Where you lean against a bank while a van passes,
+  And the deep lane insists on the direction
+  Into the village, in the electric heat
+  Hypnotised. In a warm haze the sultry light
+  Is absorbed, not refracted, by grey stone.
+  The dahlias sleep in the empty silence.
+  Wait for the early owl.
+                -- T.S Eliot
+          }
+      output.puts text
+      text
+    end
+
+    command "cohen-poem", "" do
+      text = %{
+  --
+  When this American woman,
+  whose thighs are bound in casual red cloth,
+  comes thundering past my sitting place
+  like a forest-burning Mongol tribe,
+  the city is ravished
+  and brittle buildings of a hundred years
+  splash into the street;
+  and my eyes are burnt
+  for the embroidered Chinese girls,
+  already old,
+  and so small between the thin pines
+  on these enormous landscapes,
+  that if you turn your head
+  they are lost for hours.
+                -- Leonard Cohen
+              }
+      output.puts text
+      text
+    end
+
+    command "pessoa-poem", "" do
+      output.puts <<-TEXT
+  --
+  I've gone to bed with every feeling,
+  I've been the pimp of every emotion,
+  All felt sensations have bought me drinks,
+  I've traded glances with every motive for every act,
+  I've held hands with every urge to depart,
+  ..
+  Rage, foam, the vastness that doesn't fit in my handkerchief,
+  The dog in heat howling in the night,
+  The pond from the farm going in circles around my insomnia,
+  The woods as they were, on our late-afternoon walks, the rose,
+  The indifferent tuft of hair, the moss, the pines,
+  The rage of not containing all this, not retaining all this,
+  O abstract hunger for things, impotent libido for moments,
+  Intellectual orgy of feeling life!
+                -- Fernando Pessoa
+TEXT
+    end
+
+    command "test-ansi", "" do
+      prev_color = Pry.color
+      Pry.color = true
+
+      picture = unindent <<-'EOS'.gsub(/[[:alpha:]!]/) { |s| text.red(s) }
+         ____      _______________________
+        /    \    |  A         W     G    |
+       / O  O \   |   N    I    O   N !   |
+      |        |  |    S    S    R I   !  |
+       \ \__/ / __|     I         K     ! |
+        \____/   \________________________|
+      EOS
+
+      if windows_ansi?
+        move_up = proc { |n| "\e[#{n}F" }
+      else
+        move_up = proc { |n| "\e[#{n}A\e[0G" }
+      end
+
+      output.puts "\n" * 6
+      output.puts picture.lines.map(&:chomp).reverse.join(move_up[1])
+      output.puts "\n" * 6
+      output.puts "** ENV['TERM'] is #{ENV['TERM']} **\n\n"
+
+      Pry.color = prev_color
+    end
+  end
+end