pry 0.4.5 → 0.4.6

data/README.markdown

@@ -16,9 +16,10 @@ It is not based on the IRB codebase, and implements some unique REPL
 commands such as `show_method` and `show_doc`
 
 Pry is also fairly flexible and allows significant user
-customization. It 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.
+[customization](http://rdoc.info/github/banister/pry/master/file/wiki/Customizing-pry.md). It
+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.
 
 * Install the [gem](https://rubygems.org/gems/pry): `gem install pry`
 * Read the [documentation](http://rdoc.info/github/banister/pry/master/file/README.markdown)
@@ -262,6 +263,23 @@ If you want to access a method of the same name, prefix the invocation by whites
   current one with `obj` as the receiver of the new session. Very useful
   when exploring large or complicated runtime state.
 
+Bindings and objects
+--------------------
+
+Pry ultimately operates on `Binding` objects. If you invoke Pry with a
+Binding object it uses that Binding. If you invoke Pry with anything
+other than a `Binding`, Pry will generate a Binding for that
+object and use that.
+
+If you want to open a Pry session on the current context and capture
+the locals you should use: `binding.pry`. If you do not care about
+capturing the locals you can simply use `pry` (which will generate a
+fresh `Binding` for the receiver).
+
+Top-level is a special case; you can start a Pry session on top-level
+*and* capture locals by simply using: `pry`. This is because Pry
+automatically uses `TOPLEVEL_BINDING` for the top-level object (main).
+
 Example Programs
 ----------------
 

data/examples/example_command_override.rb

@@ -16,7 +16,7 @@ class MyCommands < Pry::CommandBase
   # bring in just the status command from Pry::Commands
   import_from Pry::Commands, "status"
 
-  # analagy to Ruby's native alias_method idiom for decorating a method
+  # 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`

data/lib/pry/command_base.rb

@@ -87,9 +87,11 @@ class Pry
       # Create an alias for a command.
       # @param [String] new_command The alias name.
       # @param [String] orig_command The original command name.
+      # @param [String] desc The optional description.
       # @example
       #   class MyCommands < Pry::CommandBase
       #     alias_command "help_alias", "help"
+      #   end
       def alias_command(new_command_name, orig_command_name, desc=nil)
         commands[new_command_name] = commands[orig_command_name].dup
         commands[new_command_name][:description] = desc if desc

data/lib/pry/commands.rb

@@ -51,8 +51,18 @@ class Pry
       throw(:breakout, 0) 
     end
 
-    command "ls", "Show the list of vars in the current scope." do
-      output.puts "#{Pry.view(target.eval('local_variables + instance_variables'))}"
+    command "ls", "Show the list of vars in the current scope. Use -c to include constants." do |arg|
+      with_constants = (arg == "-c")
+      target_self = target.eval('self')
+
+      case target_self
+      when Module
+        c = with_constants ? target_self.constants : []
+        output.puts "#{Pry.view(target.eval("local_variables + instance_variables + #{c}"))}"
+      else
+        c = with_constants ? target_self.class.constants : []
+        output.puts "#{Pry.view(target.eval("local_variables + instance_variables + #{c}"))}"
+      end
     end
 
     command "cat", "Show output of <var>.inspect." do |obj|

data/lib/pry/pry_instance.rb

@@ -3,10 +3,10 @@ require 'readline'
 class Pry
 
   # The list of configuration options.
-  ConfigOptions = [:input, :output, :commands, :print,
+  CONFIG_OPTIONS = [:input, :output, :commands, :print,
                    :prompt, :hooks]
 
-  attr_accessor *ConfigOptions
+  attr_accessor *CONFIG_OPTIONS
 
   # Create a new `Pry` object.
   # @param [Hash] options The optional configuration parameters.
@@ -21,12 +21,11 @@ class Pry
   #   component of the REPL. (see print.rb)
   def initialize(options={})
 
-    h = {}
-    ConfigOptions.each { |v| h[v] = Pry.send(v) }
-    default_options = h
+    default_options = {}
+    CONFIG_OPTIONS.each { |v| default_options[v] = Pry.send(v) }
     default_options.merge!(options)
 
-    ConfigOptions.each do |key|
+    CONFIG_OPTIONS.each do |key|
       instance_variable_set("@#{key}", default_options[key])
     end
   end

data/lib/pry/version.rb

@@ -1,3 +1,3 @@
 class Pry
-  VERSION = "0.4.5"
+  VERSION = "0.4.6"
 end

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: pry
 version: !ruby/object:Gem::Version 
+  hash: 3
   prerelease: false
   segments: 
   - 0
   - 4
-  - 5
-  version: 0.4.5
+  - 6
+  version: 0.4.6
 platform: ruby
 authors: 
 - John Mair (banisterfiend)
@@ -14,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-27 00:00:00 +13:00
+date: 2011-02-02 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,6 +42,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 23
         segments: 
         - 0
         - 2
@@ -55,6 +58,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 19
         segments: 
         - 1
         - 1
@@ -112,6 +116,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
@@ -120,6 +125,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"