pry 0.10.pre.1-i386-mswin32 → 0.10.0.pre3-i386-mswin32

data/lib/pry/commands/show_input.rb

@@ -0,0 +1,17 @@
+class Pry
+  class Command::ShowInput < Pry::ClassCommand
+    match 'show-input'
+    group 'Editing'
+    description 'Show the contents of the input buffer for the current multi-line expression.'
+
+    banner <<-'BANNER'
+      Show the contents of the input buffer for the current multi-line expression.
+    BANNER
+
+    def process
+      output.puts Code.new(eval_string).with_line_numbers
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::ShowInput)
+end

data/lib/pry/commands/show_source.rb

@@ -0,0 +1,50 @@
+require 'pry/commands/show_info'
+
+class Pry
+  class Command::ShowSource < Command::ShowInfo
+    match 'show-source'
+    group 'Introspection'
+    description 'Show the source for a method or class.'
+
+    banner <<-'BANNER'
+      Usage:   show-source [OPTIONS] [METH|CLASS]
+      Aliases: $, show-method
+
+      Show the source for a method or class. Tries instance methods first and then
+      methods by default.
+
+      show-source hi_method
+      show-source hi_method
+      show-source Pry#rep     # source for Pry#rep method
+      show-source Pry         # for Pry class
+      show-source Pry -a      # for all Pry class definitions (all monkey patches)
+      show-source Pry.foo -e  # for class of the return value of expression `Pry.foo`
+      show-source Pry --super # for superclass of Pry (Object class)
+
+      https://github.com/pry/pry/wiki/Source-browsing#wiki-Show_method
+    BANNER
+
+    def options(opt)
+      opt.on :e, :eval, "evaluate the command's argument as a ruby expression and show the class its return value"
+      super(opt)
+    end
+
+    def process
+      if opts.present?(:e)
+        obj = target.eval(args.first)
+        self.args = Array.new(1) { Module === obj ? obj.name : obj.class.name }
+      end
+      super
+    end
+
+    # The source for code_object prepared for display.
+    def content_for(code_object)
+      Code.new(code_object.source, start_line_for(code_object)).
+        with_line_numbers(use_line_numbers?)
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::ShowSource)
+  Pry::Commands.alias_command 'show-method', 'show-source'
+  Pry::Commands.alias_command '$', 'show-source'
+end

data/lib/pry/commands/simple_prompt.rb

@@ -0,0 +1,22 @@
+class Pry
+  class Command::SimplePrompt < Pry::ClassCommand
+    match 'simple-prompt'
+    group 'prompts'
+    description 'Toggle the simple prompt.'
+
+    banner <<-'BANNER'
+      Toggle the simple prompt.
+    BANNER
+
+    def process
+      case _pry_.prompt
+      when Pry::SIMPLE_PROMPT
+        _pry_.pop_prompt
+      else
+        _pry_.push_prompt Pry::SIMPLE_PROMPT
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::SimplePrompt)
+end

data/lib/pry/commands/stat.rb

@@ -0,0 +1,40 @@
+class Pry
+  class Command::Stat < Pry::ClassCommand
+    match 'stat'
+    group 'Introspection'
+    description 'View method information and set _file_ and _dir_ locals.'
+    command_options :shellwords => false
+
+    banner <<-'BANNER'
+        Usage: stat [OPTIONS] [METH]
+
+        Show method information for method METH and set _file_ and _dir_ locals.
+
+        stat hello_method
+    BANNER
+
+    def options(opt)
+      method_options(opt)
+    end
+
+    def process
+      meth = method_object
+      aliases = meth.aliases
+
+      output.puts unindent <<-EOS
+        Method Information:
+        --
+        Name: #{meth.name}
+        Alias#{ "es" if aliases.length > 1 }: #{ aliases.any? ? aliases.join(", ") : "None." }
+        Owner: #{meth.owner ? meth.owner : "Unknown"}
+        Visibility: #{meth.visibility}
+        Type: #{meth.is_a?(::Method) ? "Bound" : "Unbound"}
+        Arity: #{meth.arity}
+        Method Signature: #{meth.signature}
+        Source Location: #{meth.source_location ? meth.source_location.join(":") : "Not found."}
+      EOS
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Stat)
+end

data/lib/pry/commands/switch_to.rb

@@ -0,0 +1,23 @@
+class Pry
+  class Command::SwitchTo < Pry::ClassCommand
+    match 'switch-to'
+    group 'Navigating Pry'
+    description 'Start a new subsession on a binding in the current stack.'
+
+    banner <<-'BANNER'
+      Start a new subsession on a binding in the current stack (numbered by nesting).
+    BANNER
+
+    def process(selection)
+      selection = selection.to_i
+
+      if selection < 0 || selection > _pry_.binding_stack.size - 1
+        raise CommandError, "Invalid binding index #{selection} - use `nesting` command to view valid indices."
+      else
+        Pry.start(_pry_.binding_stack[selection])
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::SwitchTo)
+end

data/lib/pry/commands/toggle_color.rb

@@ -0,0 +1,24 @@
+class Pry
+  class Command::ToggleColor < Pry::ClassCommand
+    match 'toggle-color'
+    group 'Misc'
+    description 'Toggle syntax highlighting.'
+
+    banner <<-'BANNER'
+      Usage: toggle-color
+
+      Toggle syntax highlighting.
+    BANNER
+
+    def process
+      _pry_.color = color_toggle
+      output.puts "Syntax highlighting #{_pry_.color ? "on" : "off"}"
+    end
+
+    def color_toggle
+      !_pry_.color
+    end
+
+    Pry::Commands.add_command(self)
+  end
+end

data/lib/pry/commands/watch_expression.rb

@@ -0,0 +1,105 @@
+class Pry
+  class Command::WatchExpression < Pry::ClassCommand
+    require 'pry/commands/watch_expression/expression.rb'
+
+    match 'watch'
+    group 'Context'
+    description 'Watch the value of an expression and print a notification whenever it changes.'
+    command_options :use_prefix => false
+
+    banner <<-'BANNER'
+      Usage: watch [EXPRESSION]
+             watch
+             watch --delete [INDEX]
+
+      watch [EXPRESSION] adds an expression to the list of those being watched.
+      It will be re-evaluated every time you hit enter in pry. If its value has
+      changed, the new value will be printed to the console.
+
+      This is useful if you are step-through debugging and want to see how
+      something changes over time.  It's also useful if you're trying to write
+      a method inside pry and want to check that it gives the right answers
+      every time you redefine it.
+
+      watch on its own displays all the currently watched expressions and their
+      values, and watch --delete [INDEX] allows you to delete expressions from
+      the list being watched.
+    BANNER
+
+    def options(opt)
+      opt.on :d, :delete,
+        "Delete the watch expression with the given index. If no index is given; clear all watch expressions.",
+        :optional_argument => true, :as => Integer
+      opt.on :l, :list,
+        "Show all current watch expressions and their values.  Calling watch with no expressions or options will also show the watch expressions."
+    end
+
+    def process
+      case
+      when opts.present?(:delete)
+        delete opts[:delete]
+      when opts.present?(:list) || args.empty?
+        list
+      else
+        add_hook
+        add_expression(args)
+      end
+    end
+
+    private
+
+    def expressions
+      _pry_.config.watch_expressions ||= []
+    end
+
+    def delete(index)
+      if index
+        output.puts "Deleting watch expression ##{index}: #{expressions[index-1]}"
+        expressions.delete_at(index-1)
+      else
+        output.puts "Deleting all watched expressions"
+        expressions.clear
+      end
+    end
+
+    def list
+      if expressions.empty?
+        output.puts "No watched expressions"
+      else
+        _pry_.pager.open do |pager|
+          pager.puts "Listing all watched expressions:"
+          pager.puts ""
+          expressions.each_with_index do |expr, index|
+            pager.print text.with_line_numbers(expr.to_s, index+1)
+          end
+          pager.puts ""
+        end
+      end
+    end
+
+    def eval_and_print_changed(output)
+      expressions.each do |expr|
+        expr.eval!
+        if expr.changed?
+          output.puts "#{text.blue "watch"}: #{expr.to_s}"
+        end
+      end
+    end
+
+    def add_expression(arguments)
+      expressions << Expression.new(_pry_, target, arg_string)
+      output.puts "Watching #{Code.new(arg_string)}"
+    end
+
+    def add_hook
+      hook = [:after_eval, :watch_expression]
+      unless _pry_.hooks.hook_exists?(*hook)
+        _pry_.hooks.add_hook(*hook) do |_, _pry_|
+          eval_and_print_changed _pry_.output
+        end
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::WatchExpression)
+end

data/lib/pry/commands/watch_expression/expression.rb

@@ -0,0 +1,38 @@
+class Pry
+  class Command::WatchExpression
+    class Expression
+      attr_reader :target, :source, :value, :previous_value, :_pry_
+
+      def initialize(_pry_, target, source)
+        @_pry_ = _pry_
+        @target = target
+        @source = source.strip
+      end
+
+      def eval!
+        @previous_value = @value
+        @value = Pry::ColorPrinter.pp(target_eval(target, source), "")
+      end
+
+      def to_s
+        "#{Code.new(source).strip} => #{value}"
+      end
+
+      # Has the value of the expression changed?
+      #
+      # We use the pretty-printed string represenation to detect differences
+      # as this avoids problems with dup (causes too many differences) and == (causes too few)
+      def changed?
+        (value != previous_value)
+      end
+
+      private
+
+      def target_eval(target, source)
+        target.eval(source)
+      rescue => e
+        e
+      end
+    end
+  end
+end

data/lib/pry/commands/whereami.rb

@@ -0,0 +1,190 @@
+class Pry
+  class Command::Whereami < Pry::ClassCommand
+
+    class << self
+      attr_accessor :method_size_cutoff
+    end
+
+    @method_size_cutoff = 30
+
+    match 'whereami'
+    description 'Show code surrounding the current context.'
+    group 'Context'
+
+    banner <<-'BANNER'
+      Usage: whereami [-qn] [LINES]
+
+      Describe the current location. If you use `binding.pry` inside a method then
+      whereami will print out the source for that method.
+
+      If a number is passed, then LINES lines before and after the current line will be
+      shown instead of the method itself.
+
+      The `-q` flag can be used to suppress error messages in the case that there's
+      no code to show. This is used by pry in the default before_session hook to show
+      you when you arrive at a `binding.pry`.
+
+      The `-n` flag can be used to hide line numbers so that code can be copy/pasted
+      effectively.
+
+      When pry was started on an Object and there is no associated method, whereami
+      will instead output a brief description of the current object.
+    BANNER
+
+    def setup
+      @file = expand_path(target.eval('__FILE__'))
+      @line = target.eval('__LINE__')
+      @method = Pry::Method.from_binding(target)
+    end
+
+    def options(opt)
+      opt.on :q, :quiet,             "Don't display anything in case of an error"
+      opt.on :n, :"no-line-numbers", "Do not display line numbers"
+      opt.on :m, :"method", "Show the complete source for the current method."
+      opt.on :c, :"class", "Show the complete source for the current class or module."
+      opt.on :f, :"file", "Show the complete source for the current file."
+    end
+
+    def code
+      @code ||= if opts.present?(:m)
+                  method_code or raise CommandError, "Cannot find method code."
+                elsif opts.present?(:c)
+                  class_code or raise CommandError, "Cannot find class code."
+                elsif opts.present?(:f)
+                  Pry::Code.from_file(@file)
+                elsif args.any?
+                  code_window
+                else
+                  default_code
+                end
+    end
+
+    def code?
+      !!code
+    rescue MethodSource::SourceNotFoundError
+      false
+    end
+
+    def bad_option_combination?
+      [opts.present?(:m), opts.present?(:f),
+       opts.present?(:c), args.any?].count(true) > 1
+    end
+
+    def location
+      "#{@file} @ line #{@line} #{@method && @method.name_with_owner}"
+    end
+
+    def process
+      if bad_option_combination?
+        raise CommandError, "Only one of -m, -c, -f, and  LINES may be specified."
+      end
+
+      if nothing_to_do?
+        return
+      elsif internal_binding?(target)
+        handle_internal_binding
+        return
+      end
+
+      set_file_and_dir_locals(@file)
+
+      out = "\n#{text.bold('From:')} #{location}:\n\n" <<
+        code.with_line_numbers(use_line_numbers?).with_marker(marker) << "\n"
+
+      _pry_.pager.page out
+    end
+
+    private
+
+    def nothing_to_do?
+      opts.quiet? && (internal_binding?(target) || !code?)
+    end
+
+    def use_line_numbers?
+      !opts.present?(:n)
+    end
+
+    def marker
+      !opts.present?(:n) && @line
+    end
+
+    def top_level?
+      target_self == Pry.main
+    end
+
+    def handle_internal_binding
+      if top_level?
+        output.puts "At the top level."
+      else
+        output.puts "Inside #{Pry.view_clip(target_self)}."
+      end
+    end
+
+    def small_method?
+      @method.source_range.count < self.class.method_size_cutoff
+    end
+
+    def default_code
+      if method_code && small_method?
+        method_code
+      else
+        code_window
+      end
+    end
+
+    def code_window
+      Pry::Code.from_file(@file).around(@line, window_size)
+    end
+
+    def method_code
+      return @method_code if @method_code
+
+      if valid_method?
+        @method_code = Pry::Code.from_method(@method)
+      end
+    end
+
+    # This either returns the `target_self`
+    # or it returns the class of `target_self` if `target_self` is not a class.
+    # @return [Pry::WrappedModule]
+    def target_class
+      target_self.is_a?(Module) ? Pry::WrappedModule(target_self) :
+        Pry::WrappedModule(target_self.class)
+    end
+
+    def class_code
+      return @class_code if @class_code
+
+      mod = @method ? Pry::WrappedModule(@method.owner) : target_class
+
+      idx = mod.candidates.find_index { |v| expand_path(v.source_file) == @file }
+      @class_code = idx && Pry::Code.from_module(mod, idx)
+    end
+
+    def valid_method?
+      @method && @method.source? && expand_path(@method.source_file) == @file &&
+        @method.source_range.include?(@line)
+    end
+
+    def expand_path(f)
+      return if !f
+
+      if Pry.eval_path == f
+        f
+      else
+        File.expand_path(f)
+      end
+    end
+
+    def window_size
+      if args.empty?
+        _pry_.config.default_window_size
+      else
+        args.first.to_i
+      end
+    end
+  end
+
+  Pry::Commands.add_command(Pry::Command::Whereami)
+  Pry::Commands.alias_command '@', 'whereami'
+end