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

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,18 +1,21 @@
-[![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>
-![Alt text](http://dl.dropbox.com/u/26521875/pry_logo_350.png)
-
-(C) John Mair (banisterfiend) 2011<br>
+![The Pry Logo](https://dl.dropbox.com/u/26521875/pry%20stuff/logo/pry_logo_350.png)
 
+© 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](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/>
 
 **Other Resources**
 
@@ -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;
     }
@@ -280,7 +275,7 @@ picked up by `rdoc`. Pry also has a basic understanding of both the
 rdoc and yard formats and will attempt to syntax highlight the
 documentation appropriately.
 
-Nonetheless The `ri` functionality is very good and
+Nonetheless, the `ri` functionality is very good and
 has an advantage over Pry's system in that it allows documentation
 lookup for classes as well as methods. Pry therefore has good
 integration with  `ri` through the `ri` command. The syntax
@@ -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
@@ -395,6 +401,6 @@ Problems or questions? file an issue at [github](https://github.com/pry/pry/issu
 
 ### Contributors
 
-Pry is primarily the work of [John Mair (banisterfiend)]((http://github.com/banister)), for full list
+Pry is primarily the work of [John Mair (banisterfiend)](http://github.com/banister), for full list
 of contributors see the
 [CONTRIBUTORS](https://github.com/pry/pry/blob/master/CONTRIBUTORS) file.

data/lib/pry.rb

@@ -1,115 +1,107 @@
-# (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|
-    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
-
-    colorized = Helpers::BaseHelpers.colorize_code(stringified.gsub(/#</, "%<#{nonce}"))
-
-    # avoid colour-leak from CodeRay and any of the users' previous output
-    colorized = colorized.sub(/(\n*)$/, "\e[0m\\1") if Pry.color
-
-    Helpers::BaseHelpers.stagger_output("=> #{colorized.gsub(/%<(.*?)#{nonce}/, '#<\1')}", output)
   end
 
   # may be convenient when working with enormous objects and
   # pretty_print is too slow
   SIMPLE_PRINT = proc do |output, value|
     begin
-      output.puts "=> #{value.inspect}"
+      output.puts value.inspect
     rescue RescuableException
-      output.puts "=> unknown"
+      output.puts "unknown"
     end
   end
 
   # 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
   DEFAULT_EXCEPTION_HANDLER = proc do |output, exception, _|
-    output.puts "#{exception.class}: #{exception.message}"
-    output.puts "from #{exception.backtrace.first}"
+    if UserError === exception && SyntaxError === exception
+      output.puts "SyntaxError: #{exception.message.sub(/.*syntax error, */m, '')}"
+    else
+      output.puts "#{exception.class}: #{exception.message}"
+      output.puts "from #{exception.backtrace.first}"
+    end
   end
 
-  # Don't catch these exceptions
-  DEFAULT_EXCEPTION_WHITELIST = [SystemExit, SignalException]
+  DEFAULT_PROMPT_NAME = 'pry'
 
   # The default prompt; includes the target and nesting level
   DEFAULT_PROMPT = [
                     proc { |target_self, nest_level, pry|
-                      "[#{pry.input_array.size}] pry(#{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(#{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 #{Pry.view_clip(target_self)}:#{Dir.pwd} $ " },
-                  proc { |target_self, _, _| "pry #{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 |_, level, pry|
-                  tree = pry.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
-                  "[#{pry.input_array.size}] (pry) #{tree}: #{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 |_, level, pry|
-                  tree = pry.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
-                  "[#{pry.input_array.size}] (pry) #{tree}: #{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,
                ]
 
-  # Deal with the ^D key being pressed, different behaviour in
-  # different cases:
-  # 1) In an expression     - behave like `!` command   (clear input buffer)
-  # 2) At top-level session - behave like `exit command (break out of repl loop)
-  # 3) In a nested session  - behave like `cd ..`       (pop a binding)
+  # Deal with the ^D key being pressed. Different behaviour in different cases:
+  #   1. In an expression behave like `!` command.
+  #   2. At top-level session behave like `exit` command.
+  #   3. In a nested session behave like `cd ..`.
   DEFAULT_CONTROL_D_HANDLER = proc do |eval_string, _pry_|
     if !eval_string.empty?
-      # Clear input buffer.
-      eval_string.replace("")
+      eval_string.replace('') # Clear input buffer.
     elsif _pry_.binding_stack.one?
-      # ^D at top-level breaks out of a REPL loop.
       _pry_.binding_stack.clear
       throw(:breakout)
     else
       # 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"].old_stack = _pry_.binding_stack.dup
+      _pry_.command_state["cd"] ||= Pry::Config.from_hash({}) # FIXME
+      _pry_.command_state['cd'].old_stack = _pry_.binding_stack.dup
       _pry_.binding_stack.pop
     end
   end
@@ -120,99 +112,50 @@ class Pry
     end
   end
 
-  # 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
-
-  # 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 NonMethodContextError < CommandError; end
-
-  # indicates obsolete API
-  class ObsoleteError < StandardError; end
+  # Store the current working directory. This allows show-source etc. to work if
+  # your process has changed directory since boot. [Issue #675]
+  INITIAL_PWD = Dir.pwd
 
   # This is to keep from breaking under Rails 3.2 for people who are doing that
   # IRB = Pry thing.
-  module ExtendCommandBundle
-  end
+  module ExtendCommandBundle; end
 end
 
-if Pry::Helpers::BaseHelpers.mri_18?
-  begin
-  require 'ruby18_source_location'
-  rescue LoadError
-  end
-end
-
-require "method_source"
+require 'method_source'
 require 'shellwords'
-require "stringio"
-require "coderay"
-require "optparse"
-require "slop"
-require "rbconfig"
-
-begin
-  require 'readline'
-rescue LoadError
-  warn "You're running a version of ruby with no Readline support"
-  warn "Please `gem install rb-readline` or recompile ruby --with-readline."
-  exit!
-end
-
-if Pry::Helpers::BaseHelpers.jruby?
-  begin
-    require 'ffi'
-  rescue LoadError
-    warn "Need to `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, please use ansicon: http://adoxa.3eeweb.com/ansicon/"
-  end
-end
-
-require "pry/version"
-require "pry/rbx_method"
-require "pry/rbx_path"
-require "pry/code"
-require "pry/method"
-require "pry/wrapped_module"
-require "pry/history_array"
-require "pry/helpers"
-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 'stringio'
+require 'coderay'
+require 'slop'
+require 'rbconfig'
+require 'tempfile'
+require 'pathname'
+
+require 'pry/version'
+require 'pry/repl'
+require 'pry/rbx_path'
+require 'pry/code'
+require 'pry/history_array'
+require 'pry/helpers'
+require 'pry/code_object'
+require 'pry/method'
+require 'pry/wrapped_module'
+require 'pry/history'
+require 'pry/command'
+require 'pry/command_set'
+require 'pry/commands'
+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'