pry 0.9.12.6-i386-mingw32 → 0.10.0-i386-mingw32

data/LICENSE

@@ -1,9 +1,9 @@
 License
 -------
 
-(The MIT License) 
+(The MIT License)
 
-Copyright (c) 2011 John Mair (banisterfiend)
+Copyright (c) 2013 John Mair (banisterfiend)
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/{README.markdown → README.md}

@@ -1,16 +1,19 @@
-[![Build Status](https://secure.travis-ci.org/pry/pry.png)](http://travis-ci.org/pry/pry)
+[![Build Status](https://img.shields.io/travis/pry/pry.svg)](https://travis-ci.org/pry/pry)
+[![Code Climate](https://img.shields.io/codeclimate/github/pry/pry.svg)](https://codeclimate.com/github/pry/pry)
+[![Inline docs](http://inch-pages.github.io/github/pry/pry.svg)](http://inch-pages.github.io/github/pry/pry)
 
 <center>
 ![The Pry Logo](https://dl.dropbox.com/u/26521875/pry%20stuff/logo/pry_logo_350.png)
 
-© John Mair (banisterfiend) 2012<br>
+© John Mair ([banisterfiend](https://twitter.com/banisterfiend)) 2013<br>
 
 **Please** [DONATE](http://www.pledgie.com/campaigns/15899) to the Pry project - Pry was a **huge** amount of work and every donation received is encouraging and supports Pry's continued development!
 
 **Sponsors**
 
+[Tealeaf Academy](http://www.gotealeaf.com)<br/>
 [Atomic Object](http://www.atomicobject.com/)<br/>
-[Bendyworks](http://bendyworks.com/)<br/>
+[Hashrocket](http://hashrocket.com/)<br/>
 [Intridea](http://intridea.com/)<br/>
 [Gaslight](http://gaslight.co/home)<br/>
 
@@ -27,7 +30,7 @@ including:
 * Source code browsing (including core C source with the pry-doc gem)
 * Documentation browsing
 * Live help system
-* Open methods in editors (`edit-method Class#method`)
+* Open methods in editors (`edit Class#method`)
 * Syntax highlighting
 * Command shell integration (start editors, run git, and rake from within Pry)
 * Gist integration
@@ -36,7 +39,6 @@ including:
 * Exotic object support (BasicObject instances, IClasses, ...)
 * A Powerful and flexible command system
 * Ability to view and replay history
-
 * Many convenience commands inspired by IPython, Smalltalk and other advanced REPLs
 * A wide-range number of [plugins](https://github.com/pry/pry/wiki/Available-plugins) that provide remote sessions, full debugging functionality, and more.
 
@@ -65,13 +67,6 @@ methods. The additional docs are accessed through the `show-doc` and
 * Read the [YARD API documentation](http://rdoc.info/github/pry/pry/master/file/README.markdown)
 * See the [source code](http://github.com/pry/pry)
 
-Pry also has `rubygems-test` support; to participate, first install
-Pry, then:
-
-1. Install rubygems-test: `gem install rubygems-test`
-2. Run the test: `gem test pry`
-3. Finally choose 'Yes' to upload the results.
-
 ### Commands
 
 Nearly every piece of functionality in a Pry session is implemented as
@@ -102,9 +97,9 @@ an instance variable inside that class:
     pry(Hello):1> ls -i
     instance variables: @x
     pry(Hello):1> cd @x
-    pry(20:2)> self + 10
+    pry(20):2> self + 10
     => 30
-    pry(20:2)> cd ..
+    pry(20):2> cd ..
     pry(Hello):1> cd ..
     pry(main)> cd ..
 
@@ -112,7 +107,7 @@ The number after the `:` in the pry prompt indicates the nesting
 level. To display more information about nesting, use the `nesting`
 command. E.g
 
-    pry("friend":3)> nesting
+    pry("friend"):3> nesting
     Nesting status:
     0. main (Pry top level)
     1. Hello
@@ -123,7 +118,7 @@ command. E.g
 We can then jump back to any of the previous nesting levels by using
 the `jump-to` command:
 
-    pry("friend":3)> jump-to 1
+    pry("friend"):3> jump-to 1
     => 100
     pry(Hello):1>
 
@@ -224,7 +219,7 @@ In the following example we will enter the `Pry` class, list the
 instance methods beginning with 're' and display the source code for the `rep` method:
 
     pry(main)> cd Pry
-    pry(Pry)> ls -M --grep re
+    pry(Pry):1> ls -M --grep re
     Pry#methods: re  readline  refresh  rep  repl  repl_epilogue  repl_prologue  retrieve_line
     pry(Pry):1> show-method rep -l
 
@@ -256,9 +251,9 @@ Note that we can also view C methods (from Ruby Core) using the
         RETURN_ENUMERATOR(ary, 0, 0);
         result = rb_ary_new2(RARRAY_LEN(ary));
         for (i = 0; i < RARRAY_LEN(ary); i++) {
-        if (RTEST(rb_yield(RARRAY_PTR(ary)[i]))) {
-            rb_ary_push(result, rb_ary_elt(ary, i));
-        }
+            if (RTEST(rb_yield(RARRAY_PTR(ary)[i]))) {
+                rb_ary_push(result, rb_ary_elt(ary, i));
+            }
         }
         return result;
     }
@@ -332,7 +327,7 @@ You can see the actual gist generated here: [https://gist.github.com/5332c38afc4
 
 ### Edit methods
 
-You can use `edit-method Class#method` or `edit-method my_method`
+You can use `edit Class#method` or `edit my_method`
 (if the method is in scope) to open a method for editing directly in
 your favorite editor. Pry has knowledge of a few different editors and
 will attempt to open the file at the line the method is defined.
@@ -341,13 +336,13 @@ You can set the editor to use by assigning to the `Pry.editor`
 accessor. `Pry.editor` will default to `$EDITOR` or failing that will
 use `nano` as the backup default. The file that is edited will be
 automatically reloaded after exiting the editor - reloading can be
-suppressed by passing the `--no-reload` option to `edit-method`
+suppressed by passing the `--no-reload` option to `edit`
 
 In the example below we will set our default editor to "emacsclient"
 and open the `Pry#repl` method for editing:
 
     pry(main)> Pry.editor = "emacsclient"
-    pry(main)> edit-method Pry#repl
+    pry(main)> edit Pry#repl
 
 ### Live Help System
 
@@ -360,11 +355,19 @@ avaiable.
 
 ### Use Pry as your Rails Console
 
-    pry -r ./config/environment
+The recommended way to use Pry as your Rails console is to add
+[the `pry-rails` gem](https://github.com/rweng/pry-rails) to
+your Gemfile. This replaces the default console with Pry, in
+addition to loading the Rails console helpers and adding some
+useful Rails-specific commands.
+
+If you don't want to change your Gemfile, you can still run a Pry
+console in your app's environment using Pry's `-r` flag:
 
-MyArtChannel has kindly provided a hack to replace the `rails console` command in Rails 3: [https://gist.github.com/941174](https://gist.github.com/941174) This is not recommended for code bases with multiple developers, as they may not all want to use Pry.
+    pry -r ./config/environment
 
-Also check out the [wiki](https://github.com/pry/pry/wiki/Setting-up-Rails-or-Heroku-to-use-Pry) for other strategies on integrating Pry with rails, notably the [pry-rails](https://github.com/pry/pry/wiki/Setting-up-Rails-or-Heroku-to-use-Pry#wiki-pry_rails) plugin.
+Also check out the [wiki](https://github.com/pry/pry/wiki/Setting-up-Rails-or-Heroku-to-use-Pry)
+for more information about integrating Pry with Rails.
 
 ### Limitations:
 
@@ -373,17 +376,20 @@ Also check out the [wiki](https://github.com/pry/pry/wiki/Setting-up-Rails-or-He
 
 ### Syntax Highlighting
 
-Syntax highlighting is on by default in Pry. You can toggle it on and
-off in a session by using the `toggle-color` command. Alternatively,
-you can turn it off permanently by putting the line `Pry.color =
-false` in your `~/.pryrc` file.
+Syntax highlighting is on by default in Pry. If you want to change
+the colors, check out the [pry-theme](https://github.com/kyrylo/pry-theme)
+gem.
+
+You can toggle the syntax highlighting on and off in a session by
+using the `toggle-color` command. Alternatively, you can turn it off
+permanently by putting the line `Pry.color = false` in your `~/.pryrc`
+file.
 
 ### Future Directions
 
 Many new features are planned such as:
 
 * Increase modularity (rely more on plugin system)
-* Much improved tab completion (using [Bond](http://github.com/cldwalker/bond))
 * Much improved documentation system, better support for YARD
 * Better support for code and method reloading and saving code
 * Extended and more sophisticated command system, allowing piping

data/lib/pry.rb

@@ -1,53 +1,27 @@
-# (C) John Mair (banisterfiend) 2011
+# (C) John Mair (banisterfiend) 2013
 # MIT License
 #
-
 require 'pp'
+
+require 'pry/input_lock'
+require 'pry/exceptions'
 require 'pry/helpers/base_helpers'
 require 'pry/hooks'
+require 'forwardable'
 
 class Pry
   # The default hooks - display messages when beginning and ending Pry sessions.
   DEFAULT_HOOKS = Pry::Hooks.new.add_hook(:before_session, :default) do |out, target, _pry_|
     next if _pry_.quiet?
-    _pry_.run_command("whereami --quiet", "", target)
+    _pry_.run_command("whereami --quiet")
   end
 
   # The default print
-  DEFAULT_PRINT = proc do |output, value|
-    output_with_default_format(output, value, :hashrocket => true)
-  end
-
-  def self.output_with_default_format(output, value, options = {})
-    stringified = begin
-                    value.pretty_inspect
-                  rescue RescuableException
-                    nil
-                  end
-
-    unless String === stringified
-      # Read the class name off of the singleton class to provide a default
-      # inspect.
-      klass = (class << value; self; end).ancestors.first
-      stringified = "#<#{klass}:0x#{value.__id__.to_s(16)}>"
+  DEFAULT_PRINT = proc do |output, value, _pry_|
+    _pry_.pager.open do |pager|
+      pager.print _pry_.config.output_prefix
+      Pry::ColorPrinter.pp(value, pager, Pry::Terminal.width! - 1)
     end
-
-    nonce = rand(0x100000000).to_s(16) # whatever
-
-    stringified.gsub!(/#</, "%<#{nonce}")
-    # Don't recolorize output with color (for cucumber, looksee, etc.) [Issue #751]
-    colorized = if stringified =~ /\e\[/
-                  stringified
-                else
-                  Helpers::BaseHelpers.colorize_code(stringified)
-                end
-
-    # avoid colour-leak from CodeRay and any of the users' previous output
-    colorized = colorized.sub(/(\n*)\z/, "\e[0m\\1") if Pry.color
-
-    result = colorized.gsub(/%<(.*?)#{nonce}/, '#<\1')
-    result = "=> #{result}"if options[:hashrocket]
-    Helpers::BaseHelpers.stagger_output(result, output)
   end
 
   # may be convenient when working with enormous objects and
@@ -62,7 +36,7 @@ class Pry
 
   # useful when playing with truly enormous objects
   CLIPPED_PRINT = proc do |output, value|
-    output.puts Pry.view_clip(value)
+    output.puts Pry.view_clip(value, id: true)
   end
 
   # Will only show the first line of the backtrace
@@ -80,32 +54,36 @@ class Pry
   # The default prompt; includes the target and nesting level
   DEFAULT_PROMPT = [
                     proc { |target_self, nest_level, pry|
-                      "[#{pry.input_array.size}] #{Pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}> "
+                      "[#{pry.input_array.size}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}> "
                     },
 
                     proc { |target_self, nest_level, pry|
-                      "[#{pry.input_array.size}] #{Pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}* "
+                      "[#{pry.input_array.size}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}* "
                     }
                    ]
 
+  DEFAULT_PROMPT_SAFE_OBJECTS = [String, Numeric, Symbol, nil, true, false]
+
   # A simple prompt - doesn't display target or nesting level
   SIMPLE_PROMPT = [proc { ">> " }, proc { " | " }]
 
+  NO_PROMPT = [proc { '' }, proc { '' }]
+
   SHELL_PROMPT = [
-                  proc { |target_self, _, _| "#{Pry.config.prompt_name} #{Pry.view_clip(target_self)}:#{Dir.pwd} $ " },
-                  proc { |target_self, _, _| "#{Pry.config.prompt_name} #{Pry.view_clip(target_self)}:#{Dir.pwd} * " }
+                  proc { |target_self, _, _pry_| "#{_pry_.config.prompt_name} #{Pry.view_clip(target_self)}:#{Dir.pwd} $ " },
+                  proc { |target_self, _, _pry_| "#{_pry_.config.prompt_name} #{Pry.view_clip(target_self)}:#{Dir.pwd} * " }
                  ]
 
   # A prompt that includes the full object path as well as
   # input/output (_in_ and _out_) information. Good for navigation.
   NAV_PROMPT = [
-                proc do |conf|
-                  tree = conf.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
-                  "[#{conf.expr_number}] (#{Pry.config.prompt_name}) #{tree}: #{conf.nesting_level}> "
+                proc do |_, _, _pry_|
+                  tree = _pry_.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
+                  "[#{_pry_.input_array.count}] (#{_pry_.config.prompt_name}) #{tree}: #{_pry_.binding_stack.size - 1}> "
                 end,
-                proc do |conf|
-                  tree = conf.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
-                  "[#{conf.expr_number}] (#{ Pry.config.prompt_name}) #{tree}: #{conf.nesting_level}* "
+                proc do |_, _, _pry_|
+                  tree = _pry_.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
+                  "[#{_pry_.input_array.count}] (#{ _pry_.config.prompt_name}) #{tree}: #{_pry_.binding_stack.size - 1}* "
                 end,
                ]
 
@@ -120,10 +98,9 @@ class Pry
       _pry_.binding_stack.clear
       throw(:breakout)
     else
-      # Store the entire binding stack before popping. Useful for `cd -`.
-      if _pry_.command_state['cd'].nil?
-        _pry_.command_state['cd'] = OpenStruct.new
-      end
+      # Otherwise, saves current binding stack as old stack and pops last
+      # binding out of binding stack (the old stack still has that binding).
+      _pry_.command_state["cd"] ||= Pry::Config.from_hash({}) # FIXME
       _pry_.command_state['cd'].old_stack = _pry_.binding_stack.dup
       _pry_.binding_stack.pop
     end
@@ -139,80 +116,9 @@ class Pry
   # your process has changed directory since boot. [Issue #675]
   INITIAL_PWD = Dir.pwd
 
-  # As a REPL, we often want to catch any unexpected exceptions that may have
-  # been raised; however we don't want to go overboard and prevent the user
-  # from exiting Pry when they want to.
-  module RescuableException
-    def self.===(exception)
-      case exception
-        # Catch when the user hits ^C (Interrupt < SignalException), and assume
-        # that they just wanted to stop the in-progress command (just like bash etc.)
-      when Interrupt
-        true
-        # Don't catch signals (particularly not SIGTERM) as these are unlikely to be
-        # intended for pry itself. We should also make sure that Kernel#exit works.
-      when *Pry.config.exception_whitelist
-        false
-        # All other exceptions will be caught.
-      else
-        true
-      end
-    end
-  end
-
-  # An Exception Tag (cf. Exceptional Ruby) that instructs Pry to show the error in
-  # a more user-friendly manner. This should be used when the exception happens within
-  # Pry itself as a direct consequence of the user typing something wrong.
-  #
-  # This allows us to distinguish between the user typing:
-  #
-  # pry(main)> def )
-  # SyntaxError: unexpected )
-  #
-  # pry(main)> method_that_evals("def )")
-  # SyntaxError: (eval):1: syntax error, unexpected ')'
-  # from ./a.rb:2 in `eval'
-  module UserError; end
-
-  # Catches SecurityErrors if $SAFE is set
-  module TooSafeException
-    def self.===(exception)
-      $SAFE > 0 && SecurityError === exception
-    end
-  end
-
-  # Don't catch these exceptions
-  DEFAULT_EXCEPTION_WHITELIST = [SystemExit, SignalException, Pry::TooSafeException]
-
-  # CommandErrors are caught by the REPL loop and displayed to the user. They
-  # indicate an exceptional condition that's fatal to the current command.
-  class CommandError < StandardError; end
-  class MethodNotFound < CommandError; end
-
-  # indicates obsolete API
-  class ObsoleteError < StandardError; end
-
   # This is to keep from breaking under Rails 3.2 for people who are doing that
   # IRB = Pry thing.
-  module ExtendCommandBundle
-  end
-
-  def self.require_readline
-    return false if @required_readline
-    require 'readline'
-    @required_readline = true
-  rescue LoadError
-    warn "Sorry, you can't use Pry without Readline or a compatible library."
-    warn "Please `gem install rb-readline` or recompile Ruby --with-readline."
-    raise
-  end
-end
-
-if Pry::Helpers::BaseHelpers.mri_18?
-  begin
-  require 'ruby18_source_location'
-  rescue LoadError
-  end
+  module ExtendCommandBundle; end
 end
 
 require 'method_source'
@@ -222,34 +128,10 @@ require 'coderay'
 require 'slop'
 require 'rbconfig'
 require 'tempfile'
-
-if Pry::Helpers::BaseHelpers.jruby?
-  begin
-    require 'ffi'
-  rescue LoadError
-    warn "For a better Pry experience on JRuby, please `gem install ffi`."
-  end
-end
-
-if Pry::Helpers::BaseHelpers.windows? && !Pry::Helpers::BaseHelpers.windows_ansi?
-  begin
-    require 'win32console'
-  # The mswin and mingw versions of pry require win32console, so this should
-  # only fail on jruby (where win32console doesn't work).
-  # Instead we'll recommend ansicon, which does.
-  rescue LoadError
-    warn "For a better Pry experience on Windows, please use ansicon:"
-    warn "   http://adoxa.3eeweb.com/ansicon/"
-  end
-end
-
-begin
-  require 'bond'
-rescue LoadError
-end
+require 'pathname'
 
 require 'pry/version'
-require 'pry/rbx_method'
+require 'pry/repl'
 require 'pry/rbx_path'
 require 'pry/code'
 require 'pry/history_array'
@@ -261,14 +143,19 @@ require 'pry/history'
 require 'pry/command'
 require 'pry/command_set'
 require 'pry/commands'
-require 'pry/custom_completions'
-require 'pry/completion'
 require 'pry/plugins'
 require 'pry/core_extensions'
 require 'pry/pry_class'
 require 'pry/pry_instance'
 require 'pry/cli'
+require 'pry/color_printer'
 require 'pry/pager'
 require 'pry/terminal'
 require 'pry/editor'
 require 'pry/rubygem'
+require "pry/indent"
+require "pry/last_exception"
+require "pry/prompt"
+require "pry/inspector"
+require 'pry/object_path'
+require 'pry/output'