pry 0.9.0pre3-java → 0.9.4pre2-java

data/lib/pry/commands.rb

@@ -22,8 +22,5 @@ class Pry
     import DefaultCommands::Shell
     import DefaultCommands::Introspection
     import DefaultCommands::EasterEggs
-
-#    Helpers::CommandHelpers.try_to_load_pry_doc
-
   end
 end

data/lib/pry/completion.rb

@@ -94,7 +94,7 @@ class Pry
           begin
             candidates = eval("#{receiver}.constants.collect{|m| m.to_s}", bind)
             candidates |= eval("#{receiver}.methods.collect{|m| m.to_s}", bind)
-          rescue Exception
+          rescue RescuableException
             candidates = []
           end
           candidates.grep(/^#{message}/).collect{|e| receiver + "::" + e}
@@ -114,7 +114,7 @@ class Pry
 
           begin
             candidates = eval(receiver, bind).methods.collect{|m| m.to_s}
-          rescue Exception
+          rescue RescuableException
             candidates = []
           end
           select_message(receiver, message, candidates)
@@ -126,7 +126,7 @@ class Pry
 
           begin
             candidates = eval(receiver, bind).methods.collect{|m| m.to_s}
-          rescue Exception
+          rescue RescuableException
             candidates = []
           end
           select_message(receiver, message, candidates)
@@ -149,7 +149,7 @@ class Pry
             # Foo::Bar.func
             begin
               candidates = eval("#{receiver}.methods", bind).collect{|m| m.to_s}
-            rescue Exception
+            rescue RescuableException
               candidates = []
             end
           else
@@ -157,8 +157,8 @@ class Pry
             candidates = []
             ObjectSpace.each_object(Module){|m|
               begin
-                name = m.name
-              rescue Exception
+                name = m.name.to_s
+              rescue RescuableException
                 name = ""
               end
               next if name != "IRB::Context" and

data/lib/pry/config.rb

@@ -51,12 +51,17 @@ class Pry
     # return value of that callable invocation is used as the exact
     # shell command to invoke the editor.
     # @example String
-    #   Pry.editor = "emacsclient"
+    #   Pry.config.editor = "emacsclient"
     # @example Callable
-    #   Pry.editor = proc { |file, line| "emacsclient #{file} +#{line}" }
+    #   Pry.config.editor = proc { |file, line| "emacsclient #{file} +#{line}" }
     # @return [String, #call]
     attr_accessor :editor
 
+    # A string that must precede all Pry commands (e.g., if command_prefix is
+    # set to "%", the "cd" command must be invoked as "%cd").
+    # @return [String]
+    attr_accessor :command_prefix
+
     # @return [Boolean] Toggle Pry color on and off.
     attr_accessor :color
 
@@ -71,13 +76,21 @@ class Pry
     # @return [Boolean]
     attr_accessor :should_load_plugins
 
+    # Determines whether to load files specified with the -r flag.
+    # @return [Boolean]
+    attr_accessor :should_load_requires
+
+    # Determines whether to disable edit-method's auto-reloading behavior.
+    # @return [Boolean]
+    attr_accessor :disable_auto_reload
+
     # Config option for history.
     # sub-options include hist.file, hist.load, and hist.save
     # hist.file is the file to save/load history too, e.g
     # Pry.config.history.file = "~/.pry_history".
-    # hist.load is a boolean that determines whether history will be
+    # hist.should_load is a boolean that determines whether history will be
     # loaded from hist.file at session start.
-    # hist.save is a boolean that determines whether history will be
+    # hist.should_save is a boolean that determines whether history will be
     # saved to hist.file at session end.
     # @return [OpenStruct]
     attr_accessor :history
@@ -89,8 +102,15 @@ class Pry
     # @return [OpenStruct]
     attr_accessor :plugins
 
-    # @return [Integer] Amount of results that will be stored into _out_
+    # @return [Array<String>] Ruby files to be required after loading any plugins.
+    attr_accessor :requires
+
+    # @return [Integer] Amount of results that will be stored into out
     attr_accessor :memory_size
+
+    # @return [Proc] The proc that manages ^D presses in the REPL.
+    #   The proc is passed the current eval_string and the current pry instance.
+    attr_accessor :control_d_handler
   end
 end
 

data/lib/pry/default_commands/basic.rb

@@ -8,23 +8,44 @@ class Pry
       end
 
       command "simple-prompt", "Toggle the simple prompt." do
-        case Pry.active_instance.prompt
+        case _pry_.prompt
         when Pry::SIMPLE_PROMPT
-          Pry.active_instance.pop_prompt
+          _pry_.pop_prompt
         else
-          Pry.active_instance.push_prompt Pry::SIMPLE_PROMPT
+          _pry_.push_prompt Pry::SIMPLE_PROMPT
         end
       end
 
-      command "version", "Show Pry version." do
+      command "pry-version", "Show Pry version." do
         output.puts "Pry version: #{Pry::VERSION} on Ruby #{RUBY_VERSION}."
       end
 
-      command "import", "Import a command set" do |command_set_name|
+      command "import-set", "Import a command set" do |command_set_name|
         next output.puts "Provide a command set name" if command_set.nil?
 
         set = target.eval(arg_string)
-        Pry.active_instance.commands.import set
+        _pry_.commands.import set
+      end
+
+      command "reload-method", "Reload the source file that contains the specified method" do |meth_name|
+        if (meth = get_method_object(meth_name, target, {})).nil?
+          output.puts "Invalid method name: #{meth_name}."
+          next
+        end
+
+        if is_a_c_method?(meth)
+          output.puts "Error: Can't reload a C method."
+        elsif is_a_dynamically_defined_method?(meth)
+          output.puts "Error: Can't reload an eval method."
+        else
+          file_name = meth.source_location.first
+          load file_name
+          output.puts "Reloaded #{file_name}."
+        end
+      end
+
+      command "req", "Require file(s) and expand their paths." do |*args|
+        args.each { |file_name| load File.expand_path(file_name) }
       end
 
       command "reset", "Reset the REPL to a clean state." do

data/lib/pry/default_commands/context.rb

@@ -6,74 +6,122 @@ class Pry
     Context = Pry::CommandSet.new do
       import Ls
 
-      command "cd", "Start a Pry session on VAR (use `cd ..` to go back and `cd /` to return to Pry top-level)",  :keep_retval => true do |obj|
-        case obj
-        when nil
-          output.puts "Must provide an object."
-          next
-        when ".."
-          throw(:breakout, opts[:nesting].level)
-        when "/"
-          throw(:breakout, 1) if opts[:nesting].level > 0
-          next
-        when "::"
-          TOPLEVEL_BINDING.pry
-          next
+      command "cd", "Move into a new context (use `cd ..` to go back and `cd /` to return to Pry top-level). Complex syntax (e.g cd ../@x/y) also supported."  do |obj|
+        path   = arg_string.split(/\//)
+        stack  = _pry_.binding_stack.dup
+
+        # special case when we only get a single "/", return to root
+        stack  = [stack.first] if path.empty?
+
+        resolve_failure = false
+        path.each do |context|
+          begin
+            case context.chomp
+            when ""
+              stack = [stack.first]
+            when "::"
+              stack.push(TOPLEVEL_BINDING)
+            when "."
+              next
+            when ".."
+              if stack.one?
+                _pry_.binding_stack.clear
+                throw(:breakout)
+              else
+                stack.pop
+              end
+            else
+              stack.push(Pry.binding_for(stack.last.eval(context)))
+            end
+
+          rescue RescuableException
+            output.puts "Bad object path: #{arg_string}. Failed trying to resolve: #{context}"
+            resolve_failure = true
+          end
+        end
+
+        next if resolve_failure
+
+        _pry_.binding_stack = stack
+      end
+
+      command "switch-to", "Start a new sub-session on a binding in the current stack (numbered by nesting)." do |selection|
+        selection = selection.to_i
+
+        if selection < 0 || selection > _pry_.binding_stack.size - 1
+          output.puts "Invalid binding index #{selection} - use `nesting` command to view valid indices."
         else
-          Pry.start target.eval(arg_string)
+          Pry.start(_pry_.binding_stack[selection])
         end
       end
 
       command "nesting", "Show nesting information." do
-        nesting = opts[:nesting]
-
         output.puts "Nesting status:"
         output.puts "--"
-        nesting.each do |level, obj|
+        _pry_.binding_stack.each_with_index do |obj, level|
           if level == 0
-            output.puts "#{level}. #{Pry.view_clip(obj)} (Pry top level)"
+            output.puts "#{level}. #{Pry.view_clip(obj.eval('self'))} (Pry top level)"
           else
-            output.puts "#{level}. #{Pry.view_clip(obj)}"
+            output.puts "#{level}. #{Pry.view_clip(obj.eval('self'))}"
           end
         end
       end
 
-      command "jump-to", "Jump to a Pry session further up the stack, exiting all sessions below." do |break_level|
+      command "jump-to", "Jump to a binding further up the stack, popping all bindings below." do |break_level|
         break_level = break_level.to_i
-        nesting = opts[:nesting]
+        nesting_level = _pry_.binding_stack.size - 1
 
         case break_level
-        when nesting.level
-          output.puts "Already at nesting level #{nesting.level}"
-        when (0...nesting.level)
-          throw(:breakout, break_level + 1)
+        when nesting_level
+          output.puts "Already at nesting level #{nesting_level}"
+        when (0...nesting_level)
+          _pry_.binding_stack.slice!(break_level + 1, _pry_.binding_stack.size)
+
         else
-          max_nest_level = nesting.level - 1
+          max_nest_level = nesting_level - 1
           output.puts "Invalid nest level. Must be between 0 and #{max_nest_level}. Got #{break_level}."
         end
       end
 
-      command "exit", "End the current Pry session. Accepts optional return value. Aliases: quit, back" do
-        throw(:breakout, [opts[:nesting].level, target.eval(arg_string)])
+      command "exit-all", "End the current Pry session (popping all bindings) and returning to caller. Accepts optional return value. Aliases: !!@" do
+        # clear the binding stack
+        _pry_.binding_stack.clear
+
+        # break out of the repl loop
+        throw(:breakout, target.eval(arg_string))
       end
 
-      alias_command "quit", "exit", ""
-      alias_command "back", "exit", ""
+      alias_command "!!@", "exit-all", ""
+
+      command "exit", "Pop the current binding and return to the one immediately prior. Note this does NOT exit the program. Aliases: quit", :keep_retval => true do
+        if _pry_.binding_stack.one?
+          # when breaking out of top-level then behave like `exit-all`
+          _pry_.binding_stack.clear
+          throw(:breakout, target.eval(arg_string))
+        else
+          # otherwise just pop a binding
+          popped_object = _pry_.binding_stack.pop.eval('self')
 
-      command "exit-all", "End all nested Pry sessions. Accepts optional return value. Aliases: !!@" do
-        throw(:breakout, [0, target.eval(arg_string)])
+          # return a user-specified value if given
+          if !arg_string.empty?
+            target.eval(arg_string)
+          else
+            popped_object
+          end
+        end
       end
 
-      alias_command "!!@", "exit-all", ""
+      alias_command "quit", "exit", ""
 
       command "exit-program", "End the current program. Aliases: quit-program, !!!" do
-        exit
+        Pry.save_history if Pry.config.history.should_save
+        Kernel.exit target.eval(arg_string).to_i
       end
 
       alias_command "quit-program", "exit-program", ""
       alias_command "!!!", "exit-program", ""
 
-      command "!pry", "Start a Pry session on current self; this even works mid-expression." do
+      command "!pry", "Start a Pry session on current self; this even works mid multi-line expression." do
         target.pry
       end
 
@@ -99,6 +147,7 @@ class Pry
         set_file_and_dir_locals(file)
         output.puts "\n#{text.bold('From:')} #{file} @ line #{line_num} in #{klass}##{meth_name}:\n\n"
 
+
         # This method inspired by http://rubygems.org/gems/ir_b
         File.open(file).each_with_index do |line, index|
           line_n = index + 1

data/lib/pry/default_commands/documentation.rb

@@ -11,7 +11,7 @@ class Pry
         target = target()
 
         opts = Slop.parse!(args) do |opt|
-          opt.banner = "Usage: show-doc [OPTIONS] [METH]\n" \
+          opt.banner = "Usage: show-doc [OPTIONS] [METH 1] [METH 2] [METH N]\n" \
                        "Show the comments above method METH. Tries instance methods first and then methods by default.\n" \
                        "e.g show-doc hello_method"
 
@@ -28,25 +28,30 @@ class Pry
 
         next if opts.help?
 
-        meth_name = args.shift
-        if (meth = get_method_object(meth_name, target, opts.to_hash(true))).nil?
-          output.puts "Invalid method name: #{meth_name}. Type `show-doc --help` for help"
-          next
-        end
-
-        doc, code_type = doc_and_code_type_for(meth)
-        next if !doc
+        args = [nil] if args.empty?
+        args.each do |method_name|
+          meth_name = method_name
+          if (meth = get_method_object(meth_name, target, opts.to_hash(true))).nil?
+            output.puts "Invalid method name: #{meth_name}. Type `show-doc --help` for help"
+            next
+          end
 
-        next output.puts("No documentation found.") if doc.empty?
-        doc = process_comment_markup(doc, code_type)
-        output.puts make_header(meth, code_type, doc)
-        render_output(opts.flood?, false, doc)
-        doc
+          doc, code_type = doc_and_code_type_for(meth)
+          next if !doc
+
+          next output.puts("No documentation found.") if doc.empty?
+          doc = process_comment_markup(doc, code_type)
+          output.puts make_header(meth, code_type, doc)
+          output.puts "#{text.bold("visibility: ")} #{method_visibility(meth).to_s}"
+          output.puts "#{text.bold("signature: ")} #{signature_for(meth)}"
+          output.puts
+          render_output(opts.flood?, false, doc)
+          doc
+        end
       end
 
       alias_command "?", "show-doc", ""
 
-
       command "stat", "View method information and set _file_ and _dir_ locals. Type `stat --help` for more info." do |*args|
         target = target()
 
@@ -73,23 +78,20 @@ class Pry
           next
         end
 
-        code, code_type = code_and_code_type_for(meth)
-        next if !code
-        doc, code_type = doc_and_code_type_for(meth)
-
-        output.puts make_header(meth, code_type, code)
-        output.puts text.bold("Method Name: ") + meth_name
-        output.puts text.bold("Method Owner: ") + (meth.owner.to_s ? meth.owner.to_s : "Unknown")
-        output.puts text.bold("Method Language: ") + code_type.to_s.capitalize
-        output.puts text.bold("Method Type: ") + (meth.is_a?(Method) ? "Bound" : "Unbound")
-        output.puts text.bold("Method Arity: ") + meth.arity.to_s
-
-        name_map = { :req => "Required:", :opt => "Optional:", :rest => "Rest:" }
-        if meth.respond_to?(:parameters)
-          output.puts text.bold("Method Parameters: ") + meth.parameters.group_by(&:first).
-            map { |k, v| "#{name_map[k]} #{v.map { |kk, vv| vv ? vv.to_s : "noname" }.join(", ")}" }.join(". ")
+        if !is_a_c_method?(meth) && !is_a_dynamically_defined_method?(meth)
+          set_file_and_dir_locals(path_line_for(meth).first)
         end
-        output.puts text.bold("Comment length: ") + (doc.empty? ? 'No comment.' : (doc.lines.count.to_s + ' lines.'))
+
+        output.puts "Method Information:"
+        output.puts "--"
+        output.puts "Name: " + meth_name
+        output.puts "Owner: " + (meth.owner.to_s ? meth.owner.to_s : "Unknown")
+        output.puts "Visibility: " + method_visibility(meth).to_s
+        output.puts "Type: " + (meth.is_a?(Method) ? "Bound" : "Unbound")
+        output.puts "Arity: " + meth.arity.to_s
+        output.puts "Method Signature: " + signature_for(meth)
+
+        output.puts "Source location: " + (meth.source_location ? meth.source_location.join(":") : "Not found.")
       end
 
       command "gist-method", "Gist a method to github. Type `gist-method --help` for more info.", :requires_gem => "gist" do |*args|
@@ -140,6 +142,42 @@ class Pry
         output.puts "Gist created at #{link}"
       end
 
+      helpers do
+
+        # paraphrased from awesome_print gem
+        def signature_for(method)
+          if method.respond_to?(:parameters)
+
+            args = method.parameters.inject([]) do |arr, (type, name)|
+              name ||= (type == :block ? 'block' : "arg#{arr.size + 1}")
+              arr << case type
+                     when :req        then name.to_s
+                     when :opt, :rest then "*#{name}"
+                     when :block      then "&#{name}"
+                     else '?'
+                     end
+            end
+          else 
+            args = (1..method.arity.abs).map { |i| "arg#{i}" }
+            args[-1] = "*#{args[-1]}" if method.arity < 0
+          end
+
+          "#{method.name}(#{args.join(', ')})"
+        end
+        
+        def method_visibility(meth)
+          if meth.owner.public_instance_methods.include? meth.name
+            :public
+          elsif meth.owner.protected_instance_methods.include? meth.name
+            :protected
+          elsif meth.owner.private_instance_methods.include? meth.name
+            :private
+          else
+            :none
+          end
+        end
+      end
+
     end
 
   end