pry 0.8.4pre1-i386-mswin32 → 0.9.0-i386-mswin32

data/lib/pry/helpers/text.rb

@@ -0,0 +1,83 @@
+class Pry
+  module Helpers
+
+    # The methods defined on {Text} are available to custom commands via {Pry::CommandContext#text}.  
+    module Text
+ 
+      COLORS = 
+      {
+        "black"   => 0,
+        "red"     => 1,
+        "green"   => 2,
+        "yellow"  => 3,
+        "blue"    => 4,
+        "purple"  => 5,
+        "magenta" => 5,
+        "cyan"    => 6,
+        "white"   => 7
+      }
+
+      class << self
+        
+        COLORS.each_pair do |color, value|
+          define_method color do |text|
+            Pry.color ? "\033[0;#{30+value}m#{text}\033[0m" : text.to_s
+          end
+
+          define_method "bright_#{color}" do |text|
+            Pry.color ? "\033[1;#{30+value}m#{text}\033[0m" : text.to_s
+          end
+        end
+
+        alias_method :grey, :bright_black
+        alias_method :gray, :bright_black
+        
+
+        # Remove any color codes from _text_.
+        #
+        # @param  [String, #to_s] text
+        # @return [String] _text_ stripped of any color codes.
+        def strip_color text
+          text.to_s.gsub(/\e\[.*?(\d)+m/ , '')
+        end
+
+        # Returns _text_ as bold text for use on a terminal.  
+        # _Pry.color_ must be true for this method to perform any transformations.
+        #
+        # @param [String, #to_s] text
+        # @return [String] _text_ 
+        def bold text
+          Pry.color ? "\e[1m#{text}\e[0m" : text.to_s
+        end
+
+        # Executes _block_ with _Pry.color_ set to false.
+        #
+        # @param [Proc]
+        # @return [void]
+        def no_color &block
+          boolean = Pry.color
+          Pry.color = false
+          yield
+        ensure
+          Pry.color = boolean
+        end
+
+        # Returns _text_ in a numbered list, beginning at _offset_.
+        # 
+        # @param  [#each_line] text
+        # @param  [Fixnum] offset
+        # @return [String]
+        def with_line_numbers text, offset
+          lines = text.each_line.to_a
+          lines.each_with_index.map do |line, index|
+            adjusted_index = index + offset
+            "#{self.blue adjusted_index}: #{line}"
+          end.join
+        end
+      end
+
+    end
+
+  end
+end
+

data/lib/pry/history_array.rb

@@ -0,0 +1,105 @@
+class Pry
+  # A history array is an array to which you can only add elements. Older
+  # entries are removed progressively, so that the aray never contains more than
+  # N elements.
+  #
+  # History arrays are used by Pry to store the output of the last commands.
+  #
+  # @example
+  #   ary = Pry::HistoryArray.new 10
+  #   ary << 1 << 2 << 3
+  #   ary[0] # => 1
+  #   ary[1] # => 2
+  #   10.times { |n| ary << n }
+  #   ary[0] # => nil
+  #   ary[-1] # => 9
+  class HistoryArray
+    include Enumerable
+
+    # @param [Integer] size Maximum amount of objects in the array
+    def initialize(size)
+      @max_size = size
+
+      @hash  = {}
+      @count = 0
+    end
+
+    # Pushes an object at the end of the array
+    # @param [Object] value Object to be added
+    def <<(value)
+      @hash[@count] = value
+
+      if @hash.size > max_size
+        @hash.delete(@count - max_size)
+      end
+
+      @count += 1
+
+      self
+    end
+
+    # @overload [](index)
+    #   @param [Integer] index Index of the item to access.
+    #   @return [Object, nil] Item at that index or nil if it has been removed.
+    # @overload [](index, size)
+    #   @param [Integer] index Index of the first item to access.
+    #   @param [Integer] size Amount of items to access
+    #   @return [Array, nil] The selected items. Nil if index is greater than
+    #     the size of the array.
+    # @overload [](range)
+    #   @param [Range<Integer>] range Range of indices to access.
+    #   @return [Array, nil] The selected items. Nil if index is greater than
+    #     the size of the array.
+    def [](index_or_range, size = nil)
+      if index_or_range.is_a? Integer
+        index = convert_index(index_or_range)
+
+        if size
+          end_index = index + size
+          index > @count ? nil : (index...[end_index, @count].min).map do |n|
+            @hash[n]
+          end
+        else
+          @hash[index]
+        end
+      else
+        range = convert_range(index_or_range)
+        range.begin > @count ? nil : range.map { |n| @hash[n] }
+      end
+    end
+
+    # @return [Integer] Amount of objects in the array
+    def size
+      @count
+    end
+
+    def each
+      ((@count - size)...@count).each do |n|
+        yield @hash[n]
+      end
+    end
+
+    def to_a
+      ((@count - size)...@count).map { |n| @hash[n] }
+    end
+
+    def inspect
+      "#<#{self.class} size=#{size} first=#{@count - size} max_size=#{max_size}>"
+    end
+
+    # @return [Integer] Maximum amount of objects in the array
+    attr_reader :max_size
+
+    private
+    def convert_index(n)
+      n >= 0 ? n : @count + n
+    end
+
+    def convert_range(range)
+      end_index = convert_index(range.end)
+      end_index += 1 unless range.exclude_end?
+
+      Range.new(convert_index(range.begin), [end_index, @count].min, true)
+    end
+  end
+end

data/lib/pry/plugins.rb

@@ -0,0 +1,79 @@
+class Pry
+  class PluginManager
+    PRY_PLUGIN_PREFIX = /^pry-/
+    PluginNotFound = Class.new(LoadError)
+
+    MessageSink = Object.new.tap { |o| def o.method_missing(*args) end }
+
+    class Plugin
+      attr_accessor :name, :gem_name, :enabled, :spec, :active
+
+      def initialize(name, gem_name, spec, enabled)
+        @name, @gem_name, @enabled, @spec = name, gem_name, enabled, spec
+      end
+
+      # Disable a plugin.
+      def disable!
+        self.enabled = false
+      end
+
+      # Enable a plugin.
+      def enable!
+        self.enabled = true
+      end
+
+      # Activate the plugin (require the gem).
+      def activate!
+        begin
+          require gem_name
+        rescue LoadError
+          raise PluginNotFound, "The plugin '#{gem_name}' was not found!"
+        end
+        self.active = true
+        self.enabled = true
+      end
+
+      alias active? active
+      alias enabled? enabled
+    end
+
+    def initialize
+      @plugins = []
+    end
+
+    # Find all installed Pry plugins and store them in an internal array.
+    def locate_plugins
+      Gem.refresh
+      (Gem::Specification.respond_to?(:each) ? Gem::Specification : Gem.source_index.find_name('')).each do |gem|
+        next if gem.name !~ PRY_PLUGIN_PREFIX
+        plugin_name = gem.name.split('-', 2).last
+        @plugins << Plugin.new(plugin_name, gem.name, gem, true) if !gem_located?(gem.name)
+      end
+      @plugins
+    end
+
+    # @return [Hash] A hash with all plugin names (minus the 'pry-') as
+    #   keys and Plugin objects as values.
+    def plugins
+      h = Pry.config.plugins.strict_loading ? {} : Hash.new { MessageSink }
+      @plugins.each do |plugin|
+        h[plugin.name] = plugin
+      end
+      h
+    end
+
+    # Require all enabled plugins, disabled plugins are skipped.
+    def load_plugins
+      @plugins.each do |plugin|
+        plugin.activate! if plugin.enabled?
+      end
+    end
+
+    private
+    def gem_located?(gem_name)
+      @plugins.any? { |plugin| plugin.gem_name == gem_name }
+    end
+  end
+
+end
+

data/lib/pry/pry_class.rb

@@ -1,3 +1,7 @@
+require 'ostruct'
+require 'forwardable'
+require 'pry/config'
+
 # @author John Mair (banisterfiend)
 class Pry
 
@@ -6,6 +10,13 @@ class Pry
 
   # class accessors
   class << self
+    extend Forwardable
+
+    # convenience method
+    def self.delegate_accessors(delagatee, *names)
+      def_delegators delagatee, *names
+      def_delegators delagatee, *names.map { |v| "#{v}=" }
+    end
 
     # Get nesting data.
     # This method should not need to be accessed directly.
@@ -27,41 +38,6 @@ class Pry
     # @return [Pry] The active Pry instance.
     attr_accessor :active_instance
 
-    # Get/Set the object to use for input by default by all Pry instances.
-    # @return [#readline] The object to use for input by default by all
-    #   Pry instances.
-    attr_accessor :input
-
-    # Get/Set the object to use for output by default by all Pry instances.
-    # @return [#puts] The object to use for output by default by all
-    #   Pry instances.
-    attr_accessor :output
-
-    # Get/Set the object to use for commands by default by all Pry instances.
-    # @return [Pry::CommandBase] The object to use for commands by default by all
-    #   Pry instances.
-    attr_accessor :commands
-
-    # Get/Set the Proc to use for printing by default by all Pry
-    # instances.
-    # This is the 'print' component of the REPL.
-    # @return [Proc] The Proc to use for printing by default by all
-    #   Pry instances.
-    attr_accessor :print
-
-    # @return [Proc] The Proc to use for printing exceptions by default by all
-    #   Pry instances.
-    attr_accessor :exception_handler
-
-    # Get/Set the Hash that defines Pry hooks used by default by all Pry
-    # instances.
-    # @return [Hash] The hooks used by default by all Pry instances.
-    # @example
-    #   Pry.hooks :before_session => proc { puts "hello" },
-    #     :after_session => proc { puts "goodbye" }
-    attr_accessor :hooks
-
-
     # Get/Set the Proc that defines extra Readline completions (on top
     # of the ones defined for IRB).
     # @return [Proc] The Proc that defines extra Readline completions (on top
@@ -69,49 +45,31 @@ class Pry
     #   Pry.custom_completions = proc { Dir.entries('.') }
     attr_accessor :custom_completions
 
-    # Get the array of Procs to be used for the prompts by default by
-    # all Pry instances.
-    # @return [Array<Proc>] The array of Procs to be used for the
-    #   prompts by default by all Pry instances.
-    attr_accessor :prompt
-
     # Value returned by last executed Pry command.
     # @return [Object] The command value
     attr_accessor :cmd_ret_value
 
-    # Determines whether colored output is enabled.
-    # @return [Boolean]
-    attr_accessor :color
+    # @return [Fixnum] The current input line.
+    attr_accessor :current_line
+
+    # @return [Array] The Array of evaluated expressions.
+    attr_accessor :line_buffer
 
-    # Determines whether paging (of long blocks of text) is enabled.
-    # @return [Boolean]
-    attr_accessor :pager
+    # @return [String] The __FILE__ for the `eval()`. Should be "(pry)"
+    #   by default.
+    attr_accessor :eval_path
 
-    # Determines whether the rc file (~/.pryrc) should be loaded.
-    # @return [Boolean]
-    attr_accessor :should_load_rc
+    # @return [OpenStruct] Return Pry's config object.
+    attr_accessor :config
 
-    # Set to true if Pry is invoked from command line using `pry` executable
-    # @return [Boolean]
+    # @return [Boolean] Whether Pry was activated from the command line.
     attr_accessor :cli
 
-    # Set to true if the pry-doc extension is loaded.
-    # @return [Boolean]
-    attr_accessor :has_pry_doc
-
-    # The default editor to use. Defaults to $EDITOR or nano if
-    # $EDITOR is not defined.
-    # If `editor` is a String then that string is used as the shell
-    # command to invoke the editor. If `editor` is callable (e.g a
-    # Proc) then `file` and `line` are passed in as parameters and the
-    # return value of that callable invocation is used as the exact
-    # shell command to invoke the editor.
-    # @example String
-    #   Pry.editor = "emacsclient"
-    # @example Callable
-    #   Pry.editor = proc { |file, line| "emacsclient #{file} +#{line}" }
-    # @return [String, #call]
-    attr_accessor :editor
+    # plugin forwardables
+    def_delegators :@plugin_manager, :plugins, :load_plugins, :locate_plugins
+
+    delegate_accessors :@config, :input, :output, :commands, :prompt, :print, :exception_handler,
+      :hooks, :color, :pager, :editor, :memory_size
   end
 
   # Load the rc files given in the `Pry::RC_FILES` array.
@@ -133,25 +91,26 @@ class Pry
   # @example
   #   Pry.start(Object.new, :input => MyInput.new)
   def self.start(target=TOPLEVEL_BINDING, options={})
-    if should_load_rc && !@rc_loaded
-      load_rc
-      @rc_loaded = true
+    if initial_session?
+      # note these have to be loaded here rather than in pry_instance as
+      # we only want them loaded once per entire Pry lifetime, not
+      # multiple times per each new session (i.e in debugging)
+      load_rc if Pry.config.should_load_rc
+      load_plugins if Pry.config.plugins.enabled
+      load_history if Pry.config.history.should_load
+
+      @initial_session = false
     end
 
     new(options).repl(target)
   end
 
-  # A custom version of `Kernel#inspect`.
+  # A custom version of `Kernel#pretty_inspect`.
   # This method should not need to be accessed directly.
   # @param obj The object to view.
   # @return [String] The string representation of `obj`.
   def self.view(obj)
-    case obj
-    when String, Hash, Array, Symbol, Exception, nil
-      obj.inspect
-    else
-      obj.to_s
-    end
+    obj.pretty_inspect
 
   rescue NoMethodError
     "unknown"
@@ -163,17 +122,27 @@ class Pry
   # @param max_size The maximum number of chars before clipping occurs.
   # @return [String] The string representation of `obj`.
   def self.view_clip(obj, max_size=60)
-    if Pry.view(obj).size < max_size
-      Pry.view(obj)
+    if obj.inspect.size < max_size
+      obj.inspect
     else
       "#<#{obj.class}:%#x>" % (obj.object_id << 1)
     end
   end
 
+  # Load Readline history if required.
+  def self.load_history
+    history_file = File.expand_path(Pry.config.history.file)
+    Readline::HISTORY.push(*File.readlines(history_file).map(&:chomp)) if File.exists?(history_file)
+  end
+
+  # @return [Boolean] Whether this is the first time a Pry session has
+  #   been started since loading the Pry class.
+  def self.initial_session?
+    @initial_session
+  end
+
   # Run a Pry command from outside a session. The commands available are
   # those referenced by `Pry.commands` (the default command set).
-  # Command output is suppresed by default, this is because the return
-  # value (if there is one) is likely to be more useful.
   # @param [String] arg_string The Pry command (including arguments,
   #   if any).
   # @param [Hash] options Optional named parameters.
@@ -181,35 +150,24 @@ class Pry
   # @option options [Object, Binding] :context The object context to run the
   #   command under. Defaults to `TOPLEVEL_BINDING` (main).
   # @option options [Boolean] :show_output Whether to show command
-  #   output. Defaults to false.
+  #   output. Defaults to true.
   # @example Run at top-level with no output.
   #   Pry.run_command "ls"
   # @example Run under Pry class, returning only public methods.
   #   Pry.run_command "ls -m", :context => Pry
   # @example Display command output.
   #   Pry.run_command "ls -av", :show_output => true
-  def self.run_command(arg_string, options={})
-    name, arg_string = arg_string.split(/\s+/, 2)
-    arg_string = "" if !arg_string
-
+  def self.run_command(command_string, options={})
     options = {
       :context => TOPLEVEL_BINDING,
-      :show_output => false,
+      :show_output => true,
       :output => Pry.output,
       :commands => Pry.commands
     }.merge!(options)
 
-    null_output = StringIO.new
+    output = options[:show_output] ? options[:output] : StringIO.new
 
-    context = CommandContext.new
-    commands = options[:commands]
-
-    context.opts        = {}
-    context.output      = options[:show_output] ? options[:output] : null_output
-    context.target      = Pry.binding_for(options[:context])
-    context.command_set = commands
-
-    commands.run_command(context, name, *Shellwords.shellwords(arg_string))
+    Pry.new(:output => output, :input => StringIO.new(command_string), :commands => options[:commands]).rep(options[:context])
   end
 
   def self.default_editor_for_platform
@@ -220,25 +178,53 @@ class Pry
     end
   end
 
+  def self.set_config_defaults
+    config.input = Readline
+    config.output = $stdout
+    config.commands = Pry::Commands
+    config.prompt = DEFAULT_PROMPT
+    config.print = DEFAULT_PRINT
+    config.exception_handler = DEFAULT_EXCEPTION_HANDLER
+    config.hooks = DEFAULT_HOOKS
+    config.color = true
+    config.pager = true
+    config.editor = default_editor_for_platform
+    config.should_load_rc = true
+
+    config.plugins ||= OpenStruct.new
+    config.plugins.enabled = true
+    config.plugins.strict_loading = true
+
+    config.history ||= OpenStruct.new
+    config.history.should_save = true
+    config.history.should_load = true
+    config.history.file = File.expand_path("~/.pry_history")
+
+    config.memory_size = 100
+    config.results_pager = true
+  end
+
   # Set all the configurable options back to their default values
   def self.reset_defaults
-    @input = Readline
-    @output = $stdout
-    @commands = Pry::Commands
-    @prompt = DEFAULT_PROMPT
-    @print = DEFAULT_PRINT
-    @exception_handler = DEFAULT_EXCEPTION_HANDLER
-    @hooks = DEFAULT_HOOKS
-    @custom_completions = DEFAULT_CUSTOM_COMPLETIONS
-    @color = true
-    @pager = true
-    @should_load_rc = true
-    @rc_loaded = false
-    @cli = false
-    @editor = default_editor_for_platform
+    set_config_defaults
+
+    @initial_session = true
+
+    self.custom_completions = DEFAULT_CUSTOM_COMPLETIONS
+    self.cli = false
+    self.current_line = 0
+    self.line_buffer = []
+    self.eval_path = "(pry)"
   end
 
-  self.reset_defaults
+  # Basic initialization.
+  def self.init
+    @plugin_manager ||= PluginManager.new
+
+    self.config ||= Config.new
+    reset_defaults
+    locate_plugins
+  end
 
   @nesting = []
   def @nesting.level
@@ -269,3 +255,5 @@ class Pry
     end
   end
 end
+
+Pry.init