pry 0.9.0pre3-java → 0.9.4pre2-java

data/.gitignore

@@ -7,3 +7,4 @@ doc/
 pkg/
 coverage/
 .yardoc/
+/tags

data/CHANGELOG

@@ -1,3 +1,81 @@
+*/8/2011 version 0.9.4
+* tempfile should end in .rb (for edit -t)
+* ls output should not be in array format
+* fix history saving (should not save all of Readline::HISTORY, but only what changed)
+* prevent blank lines going to Readline::HISTORY (thanks cirwin!)
+* ensure that cat --ex emulates the `whereami` format - includes line numbers and formatted the same, etc
+* fixed bug #200 ( https://github.com/pry/pry/issues/200 )- string interpolation bug (thanks to ryanf)
+* show-doc and stat now display method visibility (update WIKI)
+* got rid of warnings caused by stricter ruby 1.9.3 rules
+* remove interpolation of command names and fix interpolation error messag (update WIKI) (thanks ryanf!)
+* 'nested sessions' now use binding stacks (so each instance manages its own collection of bindings without spawning other instances)
+* changed `exit` command so that it now called Kernel#exit (after saving history)
+* 'quit' now behaves like 'exit-all' (and aliased to exit-all) - it breaks out of the repl loop and sets empties the binding_stack
+* 'cd ..' just pops a binding off the binding_stack with special behaviour when only one binding in stack - it breaks out of the repl loop
+* added switch-to command (like jump-to but doesnt unwind the stack)
+* show-method and show-doc now accept multiple method names
+* control_d hook added (Pry.config.control_d_handler)
+* behaviour of ^d is now to break out of current expr if in multi-line expr, or break out of current context if nested, or break out of pry repl loop if at top-level
+* can no longer interpolate command name itself e.g #{x}-#{y} where x = "show" and y = "doc"
+* ^C no longer captured
+* got rid of Pry.active_instance, Pry.last_exception and friends.
+* also special locals now shared among bindings in a pry instance (i.e _ex_ (and friends) re-injected into new binding entered with 'cd')
+* renamed inp and out to _in_ and _out_ (to avoid collisions with actual locals in debugging scope)
+* added third parameter to prompts, the pry instance itself (_pry) see https://github.com/pry/pry/issues/233 for why it's important
+* cd behaviour when no args performs the same as `cd /`
+* commands with keep_retval can now return nil (to suppress output now return 'void' instead)
+* Pry::CommandProcessor::Result introduced
+* Pry.view_clip() modified to be more robust and properly display Class#name
+* edit command when invoked with no args now works like edit -t
+* when edit is invoked (with no args or with -t) inside a multi-line expression input buffer, it dumps that buffer into a temp file and takes you to it
+* got rid of Pry#null_input? since all that was needed was eval_string.empty?
+* cd command now supports complex syntax: cd ../@y/y/../z
+* JRuby is no longer a 2nd class citizen, almost full JRuby support, passing 100% tests
+
+*/7/2011 version 0.9.3
+* cat --ex (cats 5 lines above and below line in file where exception was raised)
+* edit --ex (edits line in file where exception was raised)
+* edit -t (opens a temporary file and evals it in current context when closed)
+* `pry -r` requires now happen after plugin loading (so as not to interfere with
+* new Pry.config.disable_auto_reload option, for turning off auto reloading by edit-method and related (thanks ryanf)
+* add better error messages for `cd` command
+* fixed exotic object regression - BasicObject.new etc now return "=> unknown"
+* added reload-method command (reloads the associated file of a method)
+* converted: import => import-set, version => pry-version, install => install-command
+* Pry.config.command_prefix support (thanks ryanf!)
+* fixed indentation for simple-prompt
+* hist command now excludes last line of input (the command invocation itself)
+* hist now has `history` alias
+* missing plugins no longer raise exception, just print a warning to $stderr
+* fixed jedit editor support
+
+21/6/2011 version 0.9.2
+* fixed string interpolation bug (caused valid ruby code not to execute, sorry!)
+* fixed `ls` command, so it can properly display members of Object and classes, and BasicObject, etc
+* added a few git related commands to experimental command set, blame and diff
+
+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
+* more backports to ruby 1.8
+* 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)
+* removed eval-file, lls, lcd, and a few other commands
+
+
 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 +102,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 +118,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 +143,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 +177,4 @@
 * now rescuing SyntaxError as well as Racc::Parser error in valid_expression?
 8/12/2010 version 0.1.0
 * release!
-	
+

data/CONTRIBUTORS

@@ -0,0 +1,13 @@
+   564	John Mair
+    76	Rob Gleeson
+    50	Lee Jarvis
+    46	Mon ouïe
+    18	David Palm
+    13	epitron
+     8	Conrad Irwin
+     6	Ryan Fitzgerald
+     2	Darrick Wiebe
+     2	Xavier Shay
+     2	Eric Christopherson
+     1	Josh Cheek
+     1	Tim Pope

data/README.markdown

@@ -1,9 +1,17 @@
-![Alt text](http://dl.dropbox.com/u/15761219/pry_horizontal_red.png)
+![Alt text](http://dl.dropbox.com/u/26521875/pry_logo_350.png)
 
 (C) John Mair (banisterfiend) 2011
 
 _Get to the code_
 
+**Note that JRuby is not yet supported in this release, but will be
+  soon.**
+  
+ **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!
+
+[Skip to the website (recommended)](http://pry.github.com) <br />
+[Skip to the wiki](https://github.com/pry/pry/wiki)
+
 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:
@@ -28,7 +36,7 @@ currently not nearly as powerful as tools like [SLIME](http://en.wikipedia.org/w
 general direction Pry is heading.
 
 Pry is also fairly flexible and allows significant user
-[customization](http://rdoc.info/github/banister/pry/master/file/wiki/Customizing-pry.md). It
+[customization](https://github.com/pry/pry/wiki/Customization-and-configuration)
 is trivial to set it to read from any object that has a `readline` method and write to any object that has a
 `puts` method - many other aspects of Pry are also configurable making
 it a good choice for implementing custom shells.
@@ -43,8 +51,9 @@ methods. The additional docs are accessed through the `show-doc` and
 `show-method` commands.
 
 * Install the [gem](https://rubygems.org/gems/pry): `gem install pry`
-* Read the [documentation](http://rdoc.info/github/banister/pry/master/file/README.markdown)
-* See the [source code](http://github.com/banister/pry)
+* Browse the comprehensive [documentation at the official Pry wiki](https://github.com/pry/pry/wiki)
+* 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:
@@ -62,7 +71,7 @@ whitespace in between. Commands support a flexible syntax and allow
 Pry command will show a list of all private instance methods (in
 scope) that begin with 'pa'
 
-    pry(YARD::Parser::SourceParser):5> ls -Mp --grep pa
+    pry(YARD::Parser::SourceParser):5> ls -Mp --grep ^pa
     [:parser_class, :parser_type=, :parser_type_for_filename]
 
 ### Navigating around state
@@ -193,8 +202,6 @@ current directory and count the number of lines in that file with
 
 ### Code Browsing
 
-#### show-method
-
 You can browse method source code with the `show-method` command. Nearly all Ruby methods (and some C methods, with the pry-doc
 gem) can have their source viewed. Code that is longer than a page is
 sent through a pager (such as less), and all code is properly syntax
@@ -224,7 +231,7 @@ instance methods beginning with 're' and display the source code for the `rep` m
     148: end
 
 Note that we can also view C methods (from Ruby Core) using the
-`pry-doc` gem; we also show off the alternate syntax for
+`pry-doc` plugin; we also show off the alternate syntax for
 `show-method`:
 
     pry(main)> show-method Array#select
@@ -248,47 +255,6 @@ Note that we can also view C methods (from Ruby Core) using the
         return result;
     }
 
-#### Special locals
-
-Some commands such as `show-method`, `show-doc`, `show-command`, `stat`
-and `cat` update the `_file_` and `_dir_` local variables after they
-run. These locals contain the full path to the file involved in the
-last command as well as the directory containing that file.
-
-You can then use these special locals in conjunction with shell
-commands to do such things as change directory into the directory
-containing the file, open the file in an editor, display the file using `cat`, and so on.
-
-In the following example we wil use Pry to fix a bug in a method:
-
-    pry(main)> greet "john"
-    hello johnhow are you?=> nil
-    pry(main)> show-method greet
-
-    From: /Users/john/ruby/play/bug.rb @ line 2:
-    Number of lines: 4
-
-    def greet(name)
-      print "hello #{name}"
-      print "how are you?"
-    end
-    pry(main)> .emacsclient #{_file_}
-    pry(main)> load _file_
-    pry(main)> greet "john"
-    hello john
-    how are you?
-    => nil
-    pry(main)> show-method greet
-
-    From: /Users/john/ruby/play/bug.rb @ line 2:
-    Number of lines: 4
-
-    def greet(name)
-      puts "hello #{name}"
-      puts "how are you?"
-    end
-
-
 ### Documentation Browsing
 
 One use-case for Pry is to explore a program at run-time by `cd`-ing
@@ -343,63 +309,6 @@ We can also use `ri` in the normal way:
 
             a -- b -- c --
 
-
-### History
-
-Readline history can be viewed and replayed using the `hist`
-command. When `hist` is invoked with no arguments it simply displays
-the history (passing the output through a pager if necessary))
-when the `--replay` option is used a line or a range of lines of
-history can be replayed.
-
-In the example below we will enter a few lines in a Pry session and
-then view history; we will then replay one of those lines:
-
-    pry(main)> hist
-    0: hist -h
-    1: ls
-    2: ls
-    3: show-method puts
-    4: x = rand
-    5: hist
-    pry(main)> hist --replay 3
-
-    From: io.c in Ruby Core (C Method):
-    Number of lines: 8
-
-    static VALUE
-    rb_f_puts(int argc, VALUE *argv, VALUE recv)
-    {
-        if (recv == rb_stdout) {
-        return rb_io_puts(argc, argv, recv);
-        }
-        return rb_funcall2(rb_stdout, rb_intern("puts"), argc, argv);
-    }
-
-In the next example we will replay a range of lines in history. Note
-that we replay to a point where a class definition is still open and so
-we can continue to add instance methods to the class:
-
-    pry(main)> hist
-    0: class Hello
-    1:   def hello_world
-    2:     puts "hello world!"
-    3:   end
-    4: end
-    5: hist
-    pry(main)> hist --replay 0..3
-    pry(main)* def goodbye_world
-    pry(main)*   puts "goodbye world!"
-    pry(main)* end
-    pry(main)* end
-    => nil
-    pry(main)> Hello.new.goodbye_world;
-    goodbye world!
-    pry(main)>
-
-Also note that in the above the line `Hello.new.goodbye_world;` ends
-with a semi-colon which causes expression evaluation output to be suppressed.
-
 ### Gist integration
 
 If the `gist` gem is installed then method source or documentation can be gisted to github with the
@@ -447,54 +356,12 @@ avaiable.
 
 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.
 
-### Other Features and limitations
-
-#### Other Features:
-
-* Pry can be invoked both at the command-line and used as a more
-powerful alternative to IRB or it can be invoked at runtime and used
-as a developer consoler / debugger.
-* Additional documentation and source code for Ruby Core methods are supported when the `pry-doc` gem is installed.
-* Pry sessions can nest arbitrarily deeply -- to go back one level of nesting type 'exit' or 'quit' or 'back'
-* Pry comes with syntax highlighting on by default just use the `toggle-color` command to turn it on and off.
-* Use `_` to recover last result.
-* Use `_pry_` to reference the Pry instance managing the current session.
-* Use `_ex_` to recover the last exception.
-* Use `_file_` and `_dir_` to refer to the associated file or
-  directory containing the definition for a method.
-* A trailing `;` on an entered expression suppresses the display of
-  the evaluation output.
-* Typing `!` on a line by itself will clear the input buffer - useful for
-  getting you out of a situation where the parsing process
-  goes wrong and you get stuck in an endless read loop.
-* Pry supports tab completion.
-* Pry has multi-line support built in.
-* Use `^d` (control-d) to quickly break out of a session.
-* Pry has special commands not found in many other Ruby REPLs: `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 allows significant customizability.
-* Pry uses the [method_source](https://github.com/banister/method_source) gem; so
-this functionality is available to a Pry session.
-* Pry uses [RubyParser](https://github.com/seattlerb/ruby_parser) to
-validate expressions in 1.8, and [Ripper](http://rdoc.info/docs/ruby-core/1.9.2/Ripper) for 1.9.
-* Pry implements all the methods in the REPL chain separately: `Pry#r`
-for reading; `Pry#re` for eval; `Pry#rep` for printing; and `Pry#repl`
-for the loop (`Pry.start` simply wraps `Pry.new.repl`). You can
-invoke any of these methods directly depending on exactly what aspect of the functionality you need.
-
-#### Limitations:
-
-* Some Pry commands (e.g `show-command`) do not work in Ruby 1.8
-  MRI. But many other commands do work in Ruby 1.8 MRI, e.g
-  `show-method`, due to a functional 1.8 source_location implementation.
+### Limitations:
+
 * JRuby not officially supported due to currently too many quirks and
- strange behaviour. Nonetheless most functionality should still work
- OK in JRuby. Full JRuby support coming in a future version.
-* `method_source` functionality does not work in JRuby with Ruby 1.8
+ strange behaviour. This will be fixed soon.
 * Tab completion is currently a bit broken/limited this will have a
-   major overhaul in a future version.
+  major overhaul in a future version.
 
 ### Syntax Highlighting
 
@@ -503,40 +370,15 @@ 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.
 
-### Example Programs
-
-Pry comes bundled with a few example programs to illustrate some
-features, see the `examples/` directory.
-
-* `example_basic.rb`             - Demonstrate basic Pry functionality
-* `example_input.rb`             - Demonstrates how to set the `input` object.
-* `example_output.rb`            - Demonstrates how to set the `output` object.
-* `example_hooks.rb`             - Demonstrates how to set the `hooks` hash.
-* `example_print.rb`             - Demonstrates how to set the `print` object.
-* `example_prompt.rb`            - Demonstrates how to set the `prompt`.
-* `example_input2.rb`            - An advanced `input` example.
-* `example_commands.rb`          - Implementing a mathematical command set.
-* `example_commands_override.rb` - An advanced `commands` example.
-* `example_image_edit.rb`        - A simple image editor using a Pry REPL (requires `Gosu` and `TexPlay` gems).
-
-### Customizing Pry
-
-Pry allows a large degree of customization.
-
-[Read how to customize Pry here.](http://rdoc.info/github/banister/pry/master/file/wiki/Customizing-pry.md)
-
 ### 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))
 * Improved JRuby support
-* Support for viewing source-code of binary gems and C stdlib
-* git integration
 * Much improved documentation system, better support for YARD
-* A proper plugin system
-* Get rid of `.` prefix for shell commands in `shell-mode`
-* Better support for code and method reloading
+* Better support for code and method reloading and saving code
 * Extended and more sophisticated command system, allowing piping
 between commands and running commands in background
 
@@ -549,8 +391,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)
+* [Rob Gleeson](https://github.com/robgleeson)
 * [Mon_Ouie](http://github.com/mon-ouie)
-
-
+* [injekt](http://github.com/injekt)

data/Rakefile

@@ -10,24 +10,25 @@ CLEAN.include("**/*#*", "**/*#*.*", "**/*_flymake*.*", "**/*_flymake",
 
 def apply_spec_defaults(s)
   s.name = "pry"
-  s.summary = "an IRB alternative and runtime developer console"
+  s.summary = "An IRB alternative and runtime developer console"
   s.version = Pry::VERSION
   s.date = Time.now.strftime '%Y-%m-%d'
   s.author = "John Mair (banisterfiend)"
   s.email = 'jrmair@gmail.com'
   s.description = s.summary
-  s.homepage = "http://banisterfiend.wordpress.com"
+  s.homepage = "http://pry.github.com"
   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.6.0")
-  s.add_dependency("method_source",">=0.4.0")
+  s.add_dependency("slop","~>2.1.0")
+  s.add_dependency("method_source",">=0.6.5")
   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
@@ -52,15 +53,29 @@ namespace :ruby do
     pkg.need_zip = false
     pkg.need_tar = false
   end
-  
+
   desc  "Generate gemspec file"
   task :gemspec do
-    File.open("#{spec.name}-#{spec.version}.gemspec", "w") do |f|
+    File.open("#{spec.name}.gemspec", "w") do |f|
       f << spec.to_ruby
     end
   end
 end
 
+namespace :jruby do
+  spec = Gem::Specification.new do |s|
+    apply_spec_defaults(s)
+    s.add_dependency("spoon", ">=0.0.1")
+    s.platform = "java"
+  end
+
+  Rake::GemPackageTask.new(spec) do |pkg|
+    pkg.need_zip = false
+    pkg.need_tar = false
+  end
+end
+
+
 [:mingw32, :mswin32].each do |v|
   namespace v do
     spec = Gem::Specification.new do |s|
@@ -76,20 +91,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", "jruby:gem"]
 
 desc "remove all platform gems"
 task :rmgems => ["ruby:clobber_package"]