pry 0.8.4pre1-i386-mswin32 → 0.9.0-i386-mswin32

data/.gitignore

@@ -2,6 +2,7 @@ Makefile
 *.so
 *.o
 *.def
+*.rbc
 doc/
 pkg/
 coverage/

data/CHANGELOG

@@ -1,3 +1,22 @@
+17/6/2011 version 0.9.0
+* plugin system
+* regex commands
+* show-method works on methods defined in REPL
+* new command system/API
+* rubinius core support
+* inp/out special locals
+* _ex_ backtrace navigation object (_ex_.line, _ex_.file)
+* readline history saving/loading
+* prompt stack
+* more hooks
+* amend-line
+* play
+* show-input
+* edit
+* much more comprehensive test suite
+* support for new and old rubygems API
+* changed -s behaviour of ls (now excludes Object methods)
+
 26/3/2011 version 0.7.6.1
 * added slightly better support for YARD
 * now @param and @return tags are colored green and markdown `code` is syntax highlighted using coderay
@@ -24,11 +43,11 @@
 * --color mode for pry commandline
 * clean up requires (put them all in one place)
 * simple-prompt command and toggle-color commandd.
-	
+
 28/2/2011 version 0.6.3
 * Using MethodSource 0.3.4 so 1.8 show-method support provided
 * `Set` class added to list of classes that are inspected
-	
+
 26/2/2011 version 0.6.1
 * !@ command alias for exit_all
 * `cd /` for breaking out to pry top level (jump-to 0)
@@ -40,11 +59,11 @@
 22/2/2011 version 0.5.8
 * Added -c (context) option to show-doc, show-methods and eval-file
 * Fixed up ordering issue of -c and -r parameters to command line pry
-	
+
 21/2/2011 version 0.5.7
 * Added pry executable, auto-loads .pryrc in user's home directory, if it
 	exists.
-	
+
 19/2/2011 version 0.5.5
 * Added Pry.run_command
 * More useful error messages
@@ -65,7 +84,7 @@
 * Get rid of ls_method and ls_imethods (subsumed by more powerful ls)
 * Get rid of show_idoc and show_imethod
 * Add special eval-file command that evals target file in current context
-	
+
 27/1/2011 version 0.4.5
 * fixed show_method (though fragile as it references __binding_impl__
 	directly, making a name change to that method difficult
@@ -99,4 +118,4 @@
 * now rescuing SyntaxError as well as Racc::Parser error in valid_expression?
 8/12/2010 version 0.1.0
 * release!
-	
+

data/README.markdown

@@ -1,9 +1,18 @@
-![Alt text](http://dl.dropbox.com/u/26521875/pry_logo_shade.png)
+![Alt text](http://dl.dropbox.com/u/15761219/pry_horizontal_red.png)
 
 (C) John Mair (banisterfiend) 2011
 
 _Get to the code_
 
+## These docs are now out of date for the 0.9.0 release.
+
+** New documentation will be available shortly, please see the CHANGELOG and Pry's own livehelp system for information in the meantime.
+
+Also note that JRuby is not yet supported in this release, but will be soon.
+
+Thanks **
+
+
 Pry is a powerful alternative to the standard IRB shell for Ruby. It is
 written from scratch to provide a number of advanced features, some of
 these include:
@@ -549,8 +558,6 @@ Problems or questions contact me at [github](http://github.com/banister)
 The Pry team consists of:
 
 * [banisterfiend](http://github.com/banister)
-* [epitron](http://github.com/epitron)
 * [injekt](http://github.com/injekt)
 * [Mon_Ouie](http://github.com/mon-ouie)
-
-
+* [Rob Gleeson](https://github.com/robgleeson)

data/Rakefile

@@ -5,7 +5,8 @@ $:.unshift 'lib'
 require 'pry/version'
 
 CLOBBER.include("**/*~", "**/*#*", "**/*.log")
-CLEAN.include("**/*#*", "**/*#*.*", "**/*_flymake*.*", "**/*_flymake", "**/*.rbc")
+CLEAN.include("**/*#*", "**/*#*.*", "**/*_flymake*.*", "**/*_flymake",
+              "**/*.rbc", "**/.#*.*")
 
 def apply_spec_defaults(s)
   s.name = "pry"
@@ -16,25 +17,25 @@ def apply_spec_defaults(s)
   s.email = 'jrmair@gmail.com'
   s.description = s.summary
   s.homepage = "http://banisterfiend.wordpress.com"
-  s.has_rdoc = 'yard'
   s.executables = ["pry"]
   s.files = `git ls-files`.split("\n")
   s.test_files = `git ls-files -- test/*`.split("\n")
   s.add_dependency("ruby_parser",">=2.0.5")
   s.add_dependency("coderay",">=0.9.8")
-  s.add_dependency("slop",">=1.5.3")
-  s.add_dependency("method_source",">=0.4.0")
+  s.add_dependency("slop","~>1.9.0")
+  s.add_dependency("method_source",">=0.6.0")
   s.add_development_dependency("bacon",">=1.1.0")
+  s.add_development_dependency("open4", "~>1.0.1")
 end
 
+desc "Run tests"
 task :test do
   sh "bacon -Itest -rubygems -a"
 end
 
 desc "run pry"
 task :pry do
-  require 'pry'
-  binding.pry
+  load 'bin/pry'
 end
 
 desc "show pry version"
@@ -52,6 +53,13 @@ namespace :ruby do
     pkg.need_zip = false
     pkg.need_tar = false
   end
+
+  desc  "Generate gemspec file"
+  task :gemspec do
+    File.open("#{spec.name}.gemspec", "w") do |f|
+      f << spec.to_ruby
+    end
+  end
 end
 
 [:mingw32, :mswin32].each do |v|
@@ -69,20 +77,8 @@ end
   end
 end
 
-namespace :jruby do
-  spec = Gem::Specification.new do |s|
-    apply_spec_defaults(s)
-    s.platform = "java"
-  end
-
-  Rake::GemPackageTask.new(spec) do |pkg|
-    pkg.need_zip = false
-    pkg.need_tar = false
-  end
-end
-
 desc "build all platform gems at once"
-task :gems => [:clean, :rmgems, "ruby:gem", "jruby:gem", "mswin32:gem", "mingw32:gem"]
+task :gems => [:clean, :rmgems, "ruby:gem", "mswin32:gem", "mingw32:gem"]
 
 desc "remove all platform gems"
 task :rmgems => ["ruby:clobber_package"]

data/TODO

@@ -1,13 +1,39 @@
 
+ROADMAP
+
 FUTURE
-* allows pipes (|) for commands
+--------
+* Pry server and Pry client for SLIME style remote repl connectinos.
+* i18n support
+
+0.9.0
+Major features
+--------------
+* Restructure command system and helpers (almost complete)
+* Delete unnecessary commands, add a couple of new ones (e.g amend-line)
+* Readline history
+* Plugin support
+* Support Rubinius core methods
+* in[] and out[] arrays
+* Improve test coverage (test some commands, etc)
+
+Minor changes
+-------------
+* improve edit-method support for various editors
+* ensure all commands have appropriate error handing and informative error messages
+* show-doc should include signature of method
+
+Optional
+--------
+* multi-line readline support
+
 
 0.8.0
 * allow #{} interpolation of all commands
 * update documentation! new commands and features and change in behaviour of `run`
 * add ; at end of line to suppress return value output
 * Remove message spam (before/after hooks)
-* stop commands returning a value 
+* stop commands returning a value
 * use `redo` in the r() method when encounter a command
 * shell functionality should just use system(), but redirect in and
    out to Pry.input and Pry.output by reassining $stdin and $stdout

data/bin/pry

@@ -20,8 +20,26 @@ See: `https://github.com/banister` for more information.
 }
 
   on :e, :exec, "A line of code to execute in context before the session starts", true
-  on :f, "Suppress loading of ~/.pryrc"
-  on "no-color", "Disable syntax highlighting for session"
+
+  on "no-pager", "Disable pager for long output" do
+    Pry.pager = false
+  end
+
+  on "no-color", "Disable syntax highlighting for session" do
+    Pry.color = false
+  end
+
+  on :f, "Suppress loading of ~/.pryrc" do
+    # load ~/.pryrc, if not suppressed with -f option
+    Pry.config.should_load_rc = false
+  end
+
+  on "no-plugins", "Suppress loading of plugins." do
+    # suppress plugins if given --no-plugins optino
+    Pry.config.plugins.enabled = false
+  end
+
+  on "installed-plugins", "List installed plugins."
 
   on "simple-prompt", "Enable simple prompt mode" do
     Pry.prompt = Pry::SIMPLE_PROMPT
@@ -47,18 +65,17 @@ See: `https://github.com/banister` for more information.
     )
 end
 
-# invoked via cli
-Pry.cli = true
-
-Pry::Commands.instance_eval do
-  command "reset", "Reset the REPL to a clean state." do
-    output.puts "Pry reset."
-    exec("pry")
+if opts["installed-plugins"]
+  puts "Installed Plugins:"
+  puts "--"
+  Pry.locate_plugins.each do |plugin|
+    puts "#{plugin.name}".ljust(18) + plugin.spec.summary
   end
+  exit
 end
 
-# load ~/.pryrc, if not suppressed with -f option
-Pry.should_load_rc = !opts.f?
+# invoked via cli
+Pry.cli = true
 
 # create the actual context
 context = Pry.binding_for(eval(opts[:context]))

data/examples/example_basic.rb

@@ -1,7 +1,4 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 # define a local.
 a = "a local variable"
@@ -14,4 +11,5 @@ end
 # Start pry session at top-level.
 # The local variable `a` and the `hello` method will
 # be accessible.
+puts __LINE__
 binding.pry

data/examples/example_command_override.rb

@@ -1,7 +1,4 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 # Inherit standard command set, but tweak them by importing some and
 # overriding others.
@@ -18,7 +15,7 @@ class MyCommands < Pry::CommandBase
 
   # analogy to Ruby's native alias_method idiom for decorating a method
   alias_command "old_status", "status", ""
-  
+
   # Invoke one command from within another using `run`
   command "status", "Modified status."  do |x|
     output.puts "About to show status, are you ready?"

data/examples/example_commands.rb

@@ -1,7 +1,4 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 class MathCommands < Pry::CommandBase
   command "greet", "Greet a person, e.g: greet john" do |name|

data/examples/example_hooks.rb

@@ -1,12 +1,9 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 my_hooks = {
   :before_session => proc { |out, target| out.puts "Opening #{target.eval('self')}." },
   :after_session => proc { |out, target| out.puts "Closing #{target.eval('self')}." }
 }
-           
+
 # Start a Pry session using the hooks hash defined in my_hooks
 Pry.start(TOPLEVEL_BINDING, :hooks => my_hooks)

data/examples/example_image_edit.rb

@@ -1,7 +1,7 @@
 # Note: this requires you to have Gosu and TexPlay installed.
 # `gem install gosu`
 # `gem install texplay`
-# 
+#
 # Extra instructions for installing Gosu on Linux can be found here:
 # http://code.google.com/p/gosu/wiki/GettingStartedOnLinux
 #
@@ -10,11 +10,7 @@
 #
 # Have fun! :)
 
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "texplay"
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 WIDTH = 640
 HEIGHT = 480
@@ -42,12 +38,12 @@ class WinClass < Gosu::Window
     @img.rect 0, 0, @img.width - 1, @img.height - 1
 
     @binding = Pry.binding_for(@img)
-    
+
     @pry_instance = Pry.new(:commands => ImageCommands, :prompt => IMAGE_PROMPT)
   end
 
   def draw
-    @img.draw_rot(WIDTH / 2, HEIGHT / 2, 1, 0, 0.5, 0.5) 
+    @img.draw_rot(WIDTH / 2, HEIGHT / 2, 1, 0, 0.5, 0.5)
   end
 
   def update

data/examples/example_input.rb

@@ -1,7 +1,4 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 # Create a StringIO that contains the input data
 str_input = StringIO.new("puts 'hello world!'\nputs \"I am in \#{self}\"\nexit")

data/examples/example_input2.rb

@@ -1,7 +1,4 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 # Create a StringIO that contains the input data for all the Pry objects
 cmds = <<-CMDS

data/examples/example_output.rb

@@ -1,7 +1,4 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 # Create a StringIO to contain the output data
 str_output = StringIO.new

data/examples/example_print.rb

@@ -1,9 +1,6 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 my_print = proc { |out, value| out.puts "Output is: #{value.inspect}" }
-           
+
 # Start a Pry session using the print object defined in my_print
 Pry.start(TOPLEVEL_BINDING, :print => my_print)

data/examples/example_prompt.rb

@@ -1,12 +1,9 @@
-direc = File.dirname(__FILE__)
-
-require 'rubygems'
-require "#{direc}/../lib/pry"
+require File.expand_path(File.join(File.dirname(__FILE__), 'helper'))
 
 # Remember, first prompt in array is the main prompt, second is the wait
 # prompt (used for multiline input when more input is required)
 my_prompt = [ proc { |obj, *| "inside #{obj}> " },
            proc { |obj, *| "inside #{obj}* "} ]
-           
+
 # Start a Pry session using the prompt defined in my_prompt
 Pry.start(TOPLEVEL_BINDING, :prompt => my_prompt)

data/examples/helper.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+unless Object.const_defined? 'Pry'
+  $:.unshift File.expand_path '../../lib', __FILE__
+  require 'pry'
+end
+

data/lib/pry.rb

@@ -1,6 +1,63 @@
 # (C) John Mair (banisterfiend) 2011
 # MIT License
 
+require 'pp'
+require 'pry/helpers/base_helpers'
+class Pry
+  # The default hooks - display messages when beginning and ending Pry sessions.
+  DEFAULT_HOOKS = {
+    :before_session => proc do |out, target|
+      # ensure we're actually in a method
+      meth_name = target.eval('__method__')
+      file = target.eval('__FILE__')
+
+      # /unknown/ for rbx
+      if file !~ /(\(.*\))|<.*>/ && file !~ /__unknown__/ && file != "" && file != "-e"
+        Pry.run_command "whereami 5", :output => out, :show_output => true, :context => target, :commands => Pry::Commands
+      end
+    end
+  }
+
+  # The default prints
+  DEFAULT_PRINT = proc do |output, value|
+    Helpers::BaseHelpers.stagger_output("=> #{Helpers::BaseHelpers.colorize_code(value.pretty_inspect)}", output)
+  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}"
+  end
+
+  # The default prompt; includes the target and nesting level
+  DEFAULT_PROMPT = [
+    proc { |target_self, nest_level|
+      if nest_level == 0
+        "pry(#{Pry.view_clip(target_self)})> "
+      else
+        "pry(#{Pry.view_clip(target_self)}):#{Pry.view_clip(nest_level)}> "
+      end
+    },
+
+    proc { |target_self, nest_level|
+      if nest_level == 0
+        "pry(#{Pry.view_clip(target_self)})* "
+      else
+        "pry(#{Pry.view_clip(target_self)}):#{Pry.view_clip(nest_level)}* "
+      end
+    }
+  ]
+
+  # A simple prompt - doesn't display target or nesting level
+  SIMPLE_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} * " }
+  ]
+
+end
+
 require "method_source"
 require 'shellwords'
 require "readline"
@@ -20,15 +77,14 @@ if RUBY_PLATFORM =~ /mswin/ || RUBY_PLATFORM =~ /mingw/
 end
 
 require "pry/version"
-require "pry/hooks"
-require "pry/print"
+require "pry/history_array"
 require "pry/helpers"
 require "pry/command_set"
 require "pry/commands"
 require "pry/command_context"
-require "pry/prompts"
 require "pry/custom_completions"
 require "pry/completion"
+require "pry/plugins"
 require "pry/core_extensions"
 require "pry/pry_class"
 require "pry/pry_instance"