pry 0.9.0pre3-java → 0.9.4pre2-java

data/lib/pry/version.rb

@@ -1,3 +1,3 @@
 class Pry
-  VERSION = "0.9.0pre3"
+  VERSION = "0.9.4pre2"
 end

data/pry.gemspec

@@ -0,0 +1,46 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{pry}
+  s.version = "0.9.4pre1"
+
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
+  s.authors = [%q{John Mair (banisterfiend)}]
+  s.date = %q{2011-09-07}
+  s.description = %q{An IRB alternative and runtime developer console}
+  s.email = %q{jrmair@gmail.com}
+  s.executables = [%q{pry}]
+  s.files = [%q{.document}, %q{.gemtest}, %q{.gitignore}, %q{.yardopts}, %q{CHANGELOG}, %q{CONTRIBUTORS}, %q{LICENSE}, %q{README.markdown}, %q{Rakefile}, %q{TODO}, %q{bin/pry}, %q{examples/example_basic.rb}, %q{examples/example_command_override.rb}, %q{examples/example_commands.rb}, %q{examples/example_hooks.rb}, %q{examples/example_image_edit.rb}, %q{examples/example_input.rb}, %q{examples/example_input2.rb}, %q{examples/example_output.rb}, %q{examples/example_print.rb}, %q{examples/example_prompt.rb}, %q{examples/helper.rb}, %q{lib/pry.rb}, %q{lib/pry/command_context.rb}, %q{lib/pry/command_processor.rb}, %q{lib/pry/command_set.rb}, %q{lib/pry/commands.rb}, %q{lib/pry/completion.rb}, %q{lib/pry/config.rb}, %q{lib/pry/core_extensions.rb}, %q{lib/pry/custom_completions.rb}, %q{lib/pry/default_commands/basic.rb}, %q{lib/pry/default_commands/context.rb}, %q{lib/pry/default_commands/documentation.rb}, %q{lib/pry/default_commands/easter_eggs.rb}, %q{lib/pry/default_commands/gems.rb}, %q{lib/pry/default_commands/input.rb}, %q{lib/pry/default_commands/introspection.rb}, %q{lib/pry/default_commands/ls.rb}, %q{lib/pry/default_commands/shell.rb}, %q{lib/pry/extended_commands/experimental.rb}, %q{lib/pry/extended_commands/user_command_api.rb}, %q{lib/pry/helpers.rb}, %q{lib/pry/helpers/base_helpers.rb}, %q{lib/pry/helpers/command_helpers.rb}, %q{lib/pry/helpers/text.rb}, %q{lib/pry/history.rb}, %q{lib/pry/history_array.rb}, %q{lib/pry/plugins.rb}, %q{lib/pry/pry_class.rb}, %q{lib/pry/pry_instance.rb}, %q{lib/pry/version.rb}, %q{pry.gemspec}, %q{test/helper.rb}, %q{test/test_command_helpers.rb}, %q{test/test_command_processor.rb}, %q{test/test_command_set.rb}, %q{test/test_completion.rb}, %q{test/test_default_commands.rb}, %q{test/test_default_commands/test_context.rb}, %q{test/test_default_commands/test_documentation.rb}, %q{test/test_default_commands/test_gems.rb}, %q{test/test_default_commands/test_input.rb}, %q{test/test_default_commands/test_introspection.rb}, %q{test/test_default_commands/test_shell.rb}, %q{test/test_history_array.rb}, %q{test/test_pry.rb}, %q{test/test_pry_history.rb}, %q{test/test_pry_output.rb}, %q{test/test_special_locals.rb}, %q{test/testrc}, %q{wiki/Customizing-pry.md}, %q{wiki/Home.md}]
+  s.homepage = %q{http://pry.github.com}
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.6}
+  s.summary = %q{An IRB alternative and runtime developer console}
+  s.test_files = [%q{test/helper.rb}, %q{test/test_command_helpers.rb}, %q{test/test_command_processor.rb}, %q{test/test_command_set.rb}, %q{test/test_completion.rb}, %q{test/test_default_commands.rb}, %q{test/test_default_commands/test_context.rb}, %q{test/test_default_commands/test_documentation.rb}, %q{test/test_default_commands/test_gems.rb}, %q{test/test_default_commands/test_input.rb}, %q{test/test_default_commands/test_introspection.rb}, %q{test/test_default_commands/test_shell.rb}, %q{test/test_history_array.rb}, %q{test/test_pry.rb}, %q{test/test_pry_history.rb}, %q{test/test_pry_output.rb}, %q{test/test_special_locals.rb}, %q{test/testrc}]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<ruby_parser>, [">= 2.0.5"])
+      s.add_runtime_dependency(%q<coderay>, [">= 0.9.8"])
+      s.add_runtime_dependency(%q<slop>, ["~> 2.1.0"])
+      s.add_runtime_dependency(%q<method_source>, [">= 0.6.0"])
+      s.add_development_dependency(%q<bacon>, [">= 1.1.0"])
+      s.add_development_dependency(%q<open4>, ["~> 1.0.1"])
+    else
+      s.add_dependency(%q<ruby_parser>, [">= 2.0.5"])
+      s.add_dependency(%q<coderay>, [">= 0.9.8"])
+      s.add_dependency(%q<slop>, ["~> 2.1.0"])
+      s.add_dependency(%q<method_source>, [">= 0.6.0"])
+      s.add_dependency(%q<bacon>, [">= 1.1.0"])
+      s.add_dependency(%q<open4>, ["~> 1.0.1"])
+    end
+  else
+    s.add_dependency(%q<ruby_parser>, [">= 2.0.5"])
+    s.add_dependency(%q<coderay>, [">= 0.9.8"])
+    s.add_dependency(%q<slop>, ["~> 2.1.0"])
+    s.add_dependency(%q<method_source>, [">= 0.6.0"])
+    s.add_dependency(%q<bacon>, [">= 1.1.0"])
+    s.add_dependency(%q<open4>, ["~> 1.0.1"])
+  end
+end

data/test/helper.rb

@@ -20,18 +20,38 @@ class << Pry
     Pry.pager = false
     Pry.config.should_load_rc = false
     Pry.config.plugins.enabled = false
-    Pry.config.history.load = false
-    Pry.config.history.save = false
+    Pry.config.history.should_load = false
+    Pry.config.history.should_save = false
   end
 end
 
+# are we on Jruby platform?
+def jruby?
+  defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /jruby/
+end
+
+# are we on rbx platform?
+def rbx?
+  defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /rbx/
+end
+
 Pry.reset_defaults
 
+# this is to test exception code (cat --ex)
+def broken_method
+  this method is broken
+end
+
 # sample doc
 def sample_method
   :sample
 end
 
+# another sample doc
+def another_sample_method
+  :another_sample
+end
+
 def redirect_pry_io(new_in, new_out)
   old_in = Pry.input
   old_out = Pry.output
@@ -46,6 +66,17 @@ def redirect_pry_io(new_in, new_out)
   end
 end
 
+def mock_pry(*args)
+  input = InputTester.new(*args)
+  output = StringIO.new
+
+  redirect_pry_io(input, output) do
+    Pry.start
+  end
+
+  output.string
+end
+
 def redirect_global_pry_input(new_io)
   old_io = Pry.input
     Pry.input = new_io
@@ -74,12 +105,15 @@ end
 
 class InputTester
   def initialize(*actions)
+    if actions.last.is_a?(Hash) && actions.last.keys == [:history]
+      @hist = actions.pop[:history]
+    end
     @orig_actions = actions.dup
     @actions = actions
   end
 
   def readline(*)
-    @actions.shift
+    @actions.shift.tap{ |line| @hist << line if @hist }
   end
 
   def rewind

data/test/test_command_processor.rb

@@ -18,9 +18,6 @@ describe "Pry::CommandProcessor" do
 
     valid = @command_processor.valid_command? "blah"
     valid.should == false
-
-    a = "test-command"
-    lambda { @command_processor.valid_command? '#{a}' }.should.raise NameError
   end
 
   it 'should correctly match a simple string command' do
@@ -84,6 +81,57 @@ describe "Pry::CommandProcessor" do
     pos.should == command.name.length
   end
 
+  it 'should correctly match a command preceded by the command_prefix if one is defined' do
+    Pry.config.command_prefix = "%"
+
+    @pry.commands.command("test-command") {}
+    command, captures, pos = @command_processor.command_matched "%test-command hello", binding
+
+    command.name.should == "test-command"
+    captures.should == []
+    pos.should == "test-command".length + "%".length
+
+    Pry.config.command_prefix = ''
+  end
+
+  it 'should not match a command not preceded by the command_prefix if one is defined' do
+    Pry.config.command_prefix = "%"
+
+    @pry.commands.command("test-command") {}
+    command, captures, pos = @command_processor.command_matched "test-command hello", binding
+
+    command.should == nil
+    captures.should == nil
+
+    Pry.config.command_prefix = ''
+  end
+
+  it 'should match a command preceded by the command_prefix when :use_prefix => false' do
+    Pry.config.command_prefix = "%"
+
+    @pry.commands.command("test-command", "", :use_prefix => false) {}
+    command, captures, pos = @command_processor.command_matched "%test-command hello", binding
+
+    command.name.should == "test-command"
+    captures.should == []
+    pos.should == "test-command".length + "%".length
+
+    Pry.config.command_prefix = ''
+  end
+
+  it 'should match a command not preceded by the command_prefix when :use_prefix => false' do
+    Pry.config.command_prefix = "%"
+
+    @pry.commands.command("test-command", "", :use_prefix => false) {}
+    command, captures, pos = @command_processor.command_matched "test-command hello", binding
+
+    command.name.should == "test-command"
+    captures.should == []
+    pos.should == "test-command".length
+
+    Pry.config.command_prefix = ''
+  end
+
   it 'should correctly match a regex command with spaces in its name' do
     regex_command_name = /test\s+(.+)\s+command/
     @pry.commands.command(regex_command_name) {}
@@ -108,26 +156,21 @@ describe "Pry::CommandProcessor" do
     pos.should == sample_text.size
   end
 
-  it 'should correctly match a command whose name is interpolated' do
-    @pry.commands.command("blah") {}
-    a = "bl"
-    b = "ah"
-    command, captures, pos = @command_processor.command_matched '#{a}#{b}', binding
-
-    command.name.should == "blah"
-    captures.should == []
-    pos.should == command.name.length
-  end
-
-  it 'should NOT match a command whose name is interpolated when :interpolate => false' do
+  it 'should not interpolate commands that have :interpolate => false (interpolate_string should *not* be called)' do
     @pry.commands.command("boast", "", :interpolate => false) {}
-    a = "boa"
-    b = "st"
 
     # remember to use '' instead of "" when testing interpolation or
     # you'll cause yourself incredible confusion
-    command, captures, pos = @command_processor.command_matched '#{a}#{b}', binding
+    lambda { @command_processor.command_matched('boast #{c}', binding) }.should.not.raise NameError
+  end
 
-    command.should == nil
+  it 'should only execute the contents of an interpolation once' do
+    $obj = 'a'
+
+    redirect_pry_io(InputTester.new('cat #{$obj.succ!}'), StringIO.new) do
+      Pry.new.rep
+    end
+
+    $obj.should == 'b'
   end
 end

data/test/test_command_set.rb

@@ -112,9 +112,9 @@ describe Pry::CommandSet do
     @set.commands['foo'].description.should == 'baz'
   end
 
-  it 'should return nil for commands by default' do
+  it 'should return Pry::CommandContext::VOID_VALUE for commands by default' do
     @set.command('foo') { 3 }
-    @set.run_command(nil, 'foo').should == nil
+    @set.run_command(nil, 'foo').should == Pry::CommandContext::VOID_VALUE
   end
 
   it 'should be able to keep return values' do
@@ -122,6 +122,11 @@ describe Pry::CommandSet do
     @set.run_command(nil, 'foo').should == 3
   end
 
+  it 'should be able to keep return values, even if return value is nil' do
+    @set.command('foo', '', :keep_retval => true) { nil }
+    @set.run_command(nil, 'foo').should == nil
+  end
+
   it 'should be able to have its own helpers' do
     @set.command('foo') do
       should.respond_to :my_helper
@@ -187,4 +192,37 @@ describe Pry::CommandSet do
     @set.command 'foo', "", :listing => 'bar' do;end
     @set.commands['foo'].options[:listing].should == 'bar'
   end
+
+  it "should provide a 'help' command" do
+    context = Pry::CommandContext.new
+    context.command_set = @set
+    context.output = StringIO.new
+
+    lambda {
+      @set.run_command(context, 'help')
+    }.should.not.raise
+  end
+
+  it "should sort the output of the 'help' command" do
+    @set.command 'foo', "Fooerizes" do; end
+    @set.command 'goo', "Gooerizes" do; end
+    @set.command 'moo', "Mooerizes" do; end
+    @set.command 'boo', "Booerizes" do; end
+
+    context = Pry::CommandContext.new
+    context.command_set = @set
+    context.output = StringIO.new
+
+    @set.run_command(context, 'help')
+
+    doc = context.output.string
+
+    order = [doc.index("boo"),
+             doc.index("foo"),
+             doc.index("goo"),
+             doc.index("help"),
+             doc.index("moo")]
+
+    order.should == order.sort
+  end
 end

data/test/test_completion.rb

@@ -0,0 +1,27 @@
+require 'helper'
+
+describe Pry::InputCompleter do
+
+  before do
+    # The AMQP gem has some classes like this:
+    #  pry(main)> AMQP::Protocol::Test::ContentOk.name
+    #  => :content_ok
+    module SymbolyName
+      def self.name; :symboly_name; end
+    end
+  end
+
+  after do
+    Object.remove_const :SymbolyName
+  end
+
+  # another jruby hack :((
+  if !jruby?
+    it "should not crash if there's a Module that has a symbolic name." do
+      completer = Pry::InputCompleter.build_completion_proc(Pry.binding_for(Object.new))
+      binding.pry
+      lambda{ completer.call "a.to_s." }.should.not.raise Exception
+    end
+  end
+end
+

data/test/test_default_commands/test_context.rb

@@ -1,6 +1,104 @@
 require 'helper'
 
 describe "Pry::DefaultCommands::Context" do
+  describe "exit-all" do
+    it 'should break out of the repl loop of Pry instance (returning target of session)' do
+      redirect_pry_io(InputTester.new("exit-all"), StringIO.new) do
+        Pry.new.repl(0).should == 0
+      end
+    end
+
+    it 'should break out of the repl loop of Pry instance wth a user specified value' do
+      redirect_pry_io(InputTester.new("exit-all 'message'"), StringIO.new) do
+        Pry.new.repl(0).should == 'message'
+      end
+    end
+
+    it 'should break of the repl loop even if multiple bindings still on stack' do
+      ins = nil
+      redirect_pry_io(InputTester.new("cd 1", "cd 2", "exit-all 'message'"), StringIO.new) do
+        ins = Pry.new.tap { |v| v.repl(0).should == 'message' }
+      end
+    end
+
+    it 'binding_stack should be empty after breaking out of the repl loop' do
+      ins = nil
+      redirect_pry_io(InputTester.new("cd 1", "cd 2", "exit-all"), StringIO.new) do
+        ins = Pry.new.tap { |v| v.repl(0) }
+      end
+
+      ins.binding_stack.empty?.should == true
+    end
+  end
+
+  describe "exit" do
+    it 'should pop a binding with exit' do
+      b = Pry.binding_for(:outer)
+      b.eval("x = :inner")
+
+      redirect_pry_io(InputTester.new("cd x", "$inner = self;", "exit", "$outer = self", "exit-all"), StringIO.new) do
+        b.pry
+      end
+      $inner.should == :inner
+      $outer.should == :outer
+    end
+
+    it 'should break out of the repl loop of Pry instance when binding_stack has only one binding with exit' do
+      Pry.start(0, :input => StringIO.new("exit")).should == 0
+    end
+
+    it 'should break out of the repl loop of Pry instance when binding_stack has only one binding with exit, and return user-given value' do
+      Pry.start(0, :input => StringIO.new("exit :john")).should == :john
+    end
+  end
+
+  describe "jump-to" do
+    it 'should jump to the proper binding index in the stack' do
+      outp = StringIO.new
+      redirect_pry_io(InputTester.new("cd 1", "cd 2", "jump-to 1", "$blah = self", "exit-all"), outp) do
+        Pry.start(0)
+      end
+
+      $blah.should == 1
+    end
+
+    it 'should print error when trying to jump to a non-existent binding index' do
+      outp = StringIO.new
+      redirect_pry_io(InputTester.new("cd 1", "cd 2", "jump-to 100", "exit-all"), outp) do
+        Pry.start(0)
+      end
+
+      outp.string.should =~ /Invalid nest level/
+    end
+
+    it 'should print error when trying to jump to the same binding index' do
+      outp = StringIO.new
+      redirect_pry_io(InputTester.new("cd 1", "cd 2", "jump-to 2", "exit-all"), outp) do
+        Pry.new.repl(0)
+      end
+
+      outp.string.should =~ /Already/
+    end
+  end
+
+  describe "exit-program" do
+    it 'should raise SystemExit' do
+      redirect_pry_io(InputTester.new("exit-program"), StringIO.new) do
+        lambda { Pry.new.repl(0).should == 0 }.should.raise SystemExit
+      end
+    end
+
+    it 'should exit the program with the provided value' do
+      redirect_pry_io(InputTester.new("exit-program 66"), StringIO.new) do
+        begin
+          Pry.new.repl(0)
+        rescue SystemExit => e
+          e.status.should == 66
+        end
+      end
+    end
+  end
+
   describe "cd" do
     after do
       $obj = nil
@@ -28,6 +126,10 @@ describe "Pry::DefaultCommands::Context" do
       $outer.should == :outer
     end
 
+    it 'should break out of the repl loop of Pry instance when binding_stack has only one binding with cd ..' do
+      Pry.start(0, :input => StringIO.new("cd ..")).should == 0
+    end
+
     it 'should break out to outer-most session with cd /' do
       b = Pry.binding_for(:outer)
       b.eval("x = :inner")
@@ -40,9 +142,91 @@ describe "Pry::DefaultCommands::Context" do
       $outer.should == :outer
     end
 
-    it 'should start a session on TOPLEVEL_BINDING with cd ::' do
+    it 'should break out to outer-most session with just cd (no args)' do
       b = Pry.binding_for(:outer)
+      b.eval("x = :inner")
+
+      redirect_pry_io(InputTester.new("cd x", "$inner = self;", "cd 5", "$five = self", "cd", "$outer = self", "exit-all"), StringIO.new) do
+        b.pry
+      end
+      $inner.should == :inner
+      $five.should == 5
+      $outer.should == :outer
+    end
+
+    it 'should cd into an object and its ivar using cd obj/@ivar syntax' do
+      $obj = Object.new
+      $obj.instance_variable_set(:@x, 66)
+
+      redirect_pry_io(InputTester.new("cd $obj/@x", "$result = _pry_.binding_stack.dup", "exit-all"), StringIO.new) do
+        Pry.start
+      end
+      $result.size.should == 3
+      $result[1].eval('self').should == $obj
+      $result[2].eval('self').should == 66
+    end
 
+    it 'should cd into an object and its ivar using cd obj/@ivar/ syntax (note following /)' do
+      $obj = Object.new
+      $obj.instance_variable_set(:@x, 66)
+
+      redirect_pry_io(InputTester.new("cd $obj/@x/", "$result = _pry_.binding_stack.dup", "exit-all"), StringIO.new) do
+        Pry.start
+      end
+      $result.size.should == 3
+      $result[1].eval('self').should == $obj
+      $result[2].eval('self').should == 66
+    end
+
+    it 'should cd into previous object and its local using cd ../local syntax' do
+      $obj = Object.new
+      $obj.instance_variable_set(:@x, 66)
+
+      redirect_pry_io(InputTester.new("cd $obj", "local = :local", "cd @x", "cd ../local", "$result = _pry_.binding_stack.dup", "exit-all"), StringIO.new) do
+        Pry.start
+      end
+      $result.size.should == 3
+      $result[1].eval('self').should == $obj
+      $result[2].eval('self').should == :local
+    end
+
+    it 'should cd into an object and its ivar and back again using cd obj/@ivar/.. syntax' do
+      $obj = Object.new
+      $obj.instance_variable_set(:@x, 66)
+
+      redirect_pry_io(InputTester.new("cd $obj/@x/..", "$result = _pry_.binding_stack.dup", "exit-all"), StringIO.new) do
+        Pry.start
+      end
+      $result.size.should == 2
+      $result[1].eval('self').should == $obj
+    end
+
+    it 'should cd into an object and its ivar and back and then into another ivar using cd obj/@ivar/../@y syntax' do
+      $obj = Object.new
+      $obj.instance_variable_set(:@x, 66)
+      $obj.instance_variable_set(:@y, 79)
+
+      redirect_pry_io(InputTester.new("cd $obj/@x/../@y", "$result = _pry_.binding_stack.dup", "exit-all"), StringIO.new) do
+        Pry.start
+      end
+      $result.size.should == 3
+      $result[1].eval('self').should == $obj
+      $result[2].eval('self').should == 79
+    end
+
+    it 'should cd back to top-level and then into another ivar using cd /@ivar/ syntax' do
+      $obj = Object.new
+      $obj.instance_variable_set(:@x, 66)
+      TOPLEVEL_BINDING.eval('@z = 20')
+
+      redirect_pry_io(InputTester.new("cd $obj/@x/", "cd /@z", "$result = _pry_.binding_stack.dup", "exit-all"), StringIO.new) do
+        Pry.start
+      end
+      $result.size.should == 2
+      $result[1].eval('self').should == 20
+    end
+
+    it 'should start a session on TOPLEVEL_BINDING with cd ::' do
       redirect_pry_io(InputTester.new("cd ::", "$obj = self", "exit-all"), StringIO.new) do
         5.pry
       end