pry 0.2.8 → 0.3.0

data/README.markdown

@@ -144,8 +144,8 @@ end.
 * Pry sessions can nest arbitrarily deeply -- to go back one level of nesting type 'exit' or 'quit' or 'back'
 * Use `_` to recover last result.
 * Pry has multi-line support built in.
-* Pry has unique commands not found in any other REPL: `show_method`,
-`jump_to`, `ls`, `cd`
+* Pry has unique commands not found in any other REPL: `show_method`, `show_doc`
+`jump_to`, `ls`, `cd`, `cat`
 * Pry gives good control over nested sessions (important when exploring complicated runtime state)
 * Pry is not based on the IRB codebase.
 * Pry uses [RubyParser](https://github.com/seattlerb/ruby_parser) to
@@ -202,11 +202,15 @@ If you want to access a method of the same name, prefix the invocation by whites
   are nested sessions).
 * `ls` returns a list of local variables and instance variables in the
   current scope
+* `cat <var>` calls `inspect` on `<var>`
 * `cd <var>` starts a `Pry` session on the variable <var>. E.g `cd @x`
 * `show_method <methname>` Displays the sourcecode for the method
   <methname>. E.g `show_method hello`
-* `show_instance_method <methname>` Displays the sourcecode for the
-  instance method <methname>. E.g `show_instance_method goodbye`
+* `show_imethod <methname>` Displays the sourcecode for the
+  instance method <methname>. E.g `show_imethod goodbye`
+* `show_doc <methname>` Displays comments for `<methname>`
+* `show_idoc <methname>` Displays comments for instance
+  method `<methname>`
 * `exit_program` or `quit_program` will end the currently running
   program.
 * `nesting` shows Pry nesting information.

data/Rakefile

@@ -20,7 +20,7 @@ def apply_spec_defaults(s)
   s.description = s.summary
   s.require_path = 'lib'
   s.add_dependency("ruby_parser",">=2.0.5")
-  s.add_dependency("method_source",">=0.1.4")
+  s.add_dependency("method_source",">=0.2.0")
   s.homepage = "http://banisterfiend.wordpress.com"
   s.has_rdoc = 'yard'
   s.files = Dir["ext/**/extconf.rb", "ext/**/*.h", "ext/**/*.c", "lib/**/*.rb",

data/lib/pry.rb

@@ -3,14 +3,13 @@
 
 direc = File.dirname(__FILE__)
 
-require 'ruby_parser'
-require 'method_source'
+require "method_source"
 require "#{direc}/pry/version"
 require "#{direc}/pry/input"
 require "#{direc}/pry/output"
 
 class Pry
-  def self.start(target)
+  def self.start(target=TOPLEVEL_BINDING)
     new.repl(target)
   end
 
@@ -158,18 +157,32 @@ class Pry
     when "ls"
       output.ls(target)
       eval_string.clear
+    when /^cat\s+(.+)/
+      var = $~.captures.first
+      output.cat(target, var)
+      eval_string.clear
     when /^cd\s+(.+)/
       obj = $~.captures.first
       target.eval("#{obj}.pry")
       eval_string.clear
+    when /^show_doc\s*(.+)/
+      meth_name = ($~.captures).first
+      doc = target.eval("method(:#{meth_name})").comment
+      output.show_doc doc
+      eval_string.clear
+    when /^show_idoc\s*(.+)/
+      meth_name = ($~.captures).first
+      doc = target.eval("instance_method(:#{meth_name})").comment
+      output.show_doc doc
+      eval_string.clear
     when /^show_method\s*(.+)/
       meth_name = ($~.captures).first
-      code = get_method_source(target, meth_name, :method)
+      code = target.eval("method(:#{meth_name})").source
       output.show_method code
       eval_string.clear
-    when /^show_instance_method\s*(.+)/
+    when /^show_instance_method\s*(.+)/, /^show_imethod\s*(.+)/
       meth_name = ($~.captures).first
-      code = get_method_source(target, meth_name, :instance_method)
+      code = target.eval("instance_method(:#{meth_name})").source
       output.show_method code
       eval_string.clear
     when /^jump_to\s*(\d*)/
@@ -190,10 +203,6 @@ class Pry
     end
   end
 
-  def get_method_source(target, meth_name, kind)
-    target.eval("#{kind}(:#{meth_name}).source")
-  end
-
   def prompt(eval_string, target, nest)
     target_self = target.eval('self')
     
@@ -212,6 +221,7 @@ class Pry
     end
     
   else
+    require 'ruby_parser'
     
     def valid_expression?(code)
       RubyParser.new.parse(code)

data/lib/pry/output.rb

@@ -1,79 +1,96 @@
 class Pry
   class Output
+    attr_reader :out
+    
+    def initialize(out=STDOUT)
+      @out = out
+    end
+    
     def refresh
-      puts "Refreshed REPL"
+      out.puts "Refreshed REPL"
     end
 
     def session_start(obj)
-      puts "Beginning Pry session for #{Pry.view(obj)}"
+      out.puts "Beginning Pry session for #{Pry.view(obj)}"
     end
 
     def session_end(obj)
-      puts "Ending Pry session for #{Pry.view(obj)}"
+      out.puts "Ending Pry session for #{Pry.view(obj)}"
     end
 
     # the print component of READ-EVAL-PRINT-LOOP
     def print(value)
       case value
       when Exception
-        puts "#{value.class}: #{value.message}"
+        out.puts "#{value.class}: #{value.message}"
       else
-        puts "=> #{Pry.view(value)}"
+        out.puts "=> #{Pry.view(value)}"
       end
     end
 
     def show_help
-      puts "Command list:"
-      puts "--"
-      puts "help                             This menu"
-      puts "status                           Show status information"
-      puts "!                                Refresh the REPL"
-      puts "nesting                          Show nesting information"
-      puts "ls                               Show the list of variables in the current scope"
-      puts "cd <var>                         Start a Pry session on <var> (use `cd ..` to go back)"
-      puts "show_method <methname>           Show the sourcecode for the method <method_name>"
-      puts "show_instance_method <methname>  Show the sourcecode for the instance method <method_name>"
-      puts "exit/quit/back                   End the current Pry session"
-      puts "exit_all                         End all nested Pry sessions"
-      puts "exit_program/quit_program        End the current program"
-      puts "jump_to <level>                  Jump to a Pry session further up the stack, exiting all sessions below"
+      out.puts "Command list:"
+      out.puts "--"
+      out.puts "help                             This menu"
+      out.puts "status                           Show status information"
+      out.puts "!                                Refresh the REPL"
+      out.puts "nesting                          Show nesting information"
+      out.puts "ls                               Show the list of variables in the current scope"
+      out.puts "cat <var>                        Show output of <var>.inspect"
+      out.puts "cd <var>                         Start a Pry session on <var> (use `cd ..` to go back)"
+      out.puts "show_method <methname>           Show the sourcecode for the method <methname>"
+      out.puts "show_imethod <methname>          Show the sourcecode for the instance method <method_name>"
+      out.puts "show_doc <methname>              Show the comments above <methname>"
+      out.puts "show_idoc <methname>             Show the comments above instance method <methname>"
+      out.puts "exit/quit/back                   End the current Pry session"
+      out.puts "exit_all                         End all nested Pry sessions"
+      out.puts "exit_program/quit_program        End the current program"
+      out.puts "jump_to <level>                  Jump to a Pry session further up the stack, exiting all sessions below"
     end
 
     def show_nesting(nesting)
-      puts "Nesting status:"
-      puts "--"
+      out.puts "Nesting status:"
+      out.puts "--"
       nesting.each do |level, obj|
         if level == 0
-          puts "#{level}. #{Pry.view(obj)} (Pry top level)"
+          out.puts "#{level}. #{Pry.view(obj)} (Pry top level)"
         else
-          puts "#{level}. #{Pry.view(obj)}"
+          out.puts "#{level}. #{Pry.view(obj)}"
         end
       end
     end
 
     def show_status(nesting, target)
-      puts "Status:"
-      puts "--"
-      puts "Receiver: #{Pry.view(target.eval('self'))}"
-      puts "Nesting level: #{nesting.level}"
-      puts "Local variables: #{target.eval('Pry.view(local_variables)')}"
-      puts "Last result: #{Pry.view(Pry.last_result)}"
+      out.puts "Status:"
+      out.puts "--"
+      out.puts "Receiver: #{Pry.view(target.eval('self'))}"
+      out.puts "Nesting level: #{nesting.level}"
+      out.puts "Local variables: #{target.eval('Pry.view(local_variables)')}"
+      out.puts "Last result: #{Pry.view(Pry.last_result)}"
     end
 
     def ls(target)
-      puts "#{target.eval('Pry.view(local_variables + instance_variables)')}"
+      out.puts "#{target.eval('Pry.view(local_variables + instance_variables)')}"
+    end
+
+    def cat(target, var)
+      out.puts target.eval("#{var}.inspect")
     end
     
     def show_method(code)
-      code.display
+      out.puts code
+    end
+
+    def show_doc(doc)
+      out.puts doc
     end
 
     def warn_already_at_level(nesting_level)
-      puts "Already at nesting level #{nesting_level}"
+      out.puts "Already at nesting level #{nesting_level}"
     end
     
     def err_invalid_nest_level(nest_level, max_nest_level)
-      puts "Invalid nest level. Must be between 0 and #{max_nest_level}. Got #{nest_level}."
+      out.puts "Invalid nest level. Must be between 0 and #{max_nest_level}. Got #{nest_level}."
     end
 
     def exit() end

data/lib/pry/version.rb

@@ -1,3 +1,3 @@
 class Pry
-  VERSION = "0.2.8"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: pry
 version: !ruby/object:Gem::Version 
+  hash: 19
   prerelease: false
   segments: 
   - 0
-  - 2
-  - 8
-  version: 0.2.8
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
 authors: 
 - John Mair (banisterfiend)
@@ -14,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-18 00:00:00 +13:00
+date: 2010-12-19 00:00:00 +13:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -25,6 +26,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 5
         segments: 
         - 2
         - 0
@@ -40,11 +42,12 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 23
         segments: 
         - 0
-        - 1
-        - 4
-        version: 0.1.4
+        - 2
+        - 0
+        version: 0.2.0
   type: :runtime
   version_requirements: *id002
 description: attach an irb-like session to any object at runtime
@@ -77,6 +80,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
@@ -85,6 +89,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"