pry 0.9.7.4-i386-mswin32 → 0.9.8-i386-mswin32

data/man/pry.1.ronn

@@ -0,0 +1,141 @@
+PRY(1) -- A Reference to the PRY repl.
+======================================
+
+##Synopsis
+
+
+`pry` [`--version`] [`--exec`] [`--no-pager`] [`--no-history`] [`--no-color`] [`-f`] [`--no-plugins`] [`--installed-plugins`] [`--simple-prompt`] [`--require` _file_] [`-I`] [`--context`] [`--help`]
+
+## DESCRIPTION
+
+
+Pry is a powerful alternative to the standard IRB shell for Ruby. It is written from scratch to provide a number of advanced features.
+
+## HOMEPAGE
+
+
+http://pry.github.com/
+
+##OPTIONS
+
+
+* `-v --version`:
+  Prints the version of Pry.
+
+* `-e --exec`:
+  Executes argument in context before the session starts.
+
+* `--no-pager`:
+  Disable pager for long output.
+
+* `--no-history`:
+  Disable history loading.
+
+* `--no-color`:
+  Disable syntax highlighting for session.
+
+* `-f`:
+  Prevent loading of ~/.pryrc for session.
+
+* `--no-plugins`:
+  Supress loading of plugins.
+
+* `--installed-plugins`:
+  List installed plugins.
+
+* `--simple-prompt`:
+  Enable simple prompt mode (eg, >>).
+
+* `-r --require`:
+  Require a ruby script at startup.
+
+* `-I`:
+  Add a path to the $LOAD_PATH
+
+* `-c --context`:
+  Start the session in the specified context.  Equivalent to `context.pry` in a session.
+
+##FILES
+
+
+~/.pryrc Personal pry initialization
+
+##EXAMPLES
+
+###Basic Usage
+
+
+    $ pry
+    [1] pry(main)>4 + 5
+    => 9
+    [2] pry(main)> def hello_world
+    [2] pry(main)*   puts "Hello, World!"
+    [2] pry(main)* end  
+    => nil
+    [3] pry(main)> hello_world
+    Hello, World!
+    => nil
+
+###Command Line Interaction
+
+
+Prefix any command you want your shell to execute with a period and pry will return the results from your shell.
+
+    [1] pry(main)> .date
+    Fri Nov 11 09:52:07 EST 2011
+
+On the command line enter `shell-mode` to incorporate the current working directory into the Pry prompt.
+
+    pry(main)> shell-mode
+    pry main:/Users/john/ruby/projects/pry $ .cd ..
+    pry main:/Users/john/ruby/projects $ .cd ~
+    pry main:/Users/john $ .pwd
+    /Users/john
+    pry main:/Users/john $ shell-mode
+    pry(main)>
+
+###State Navigation
+
+
+The cd command is used to move into a new object (or scope) inside a Pry session.  When inside the new scope it becomes the self for the session and all commands and methods will operate on this new self.
+
+    pry(main)> self
+    => main
+    pry(main)> cd Pry
+    pry(Pry):1> self
+    => Pry
+    pry(Pry):1> cd ..
+    pry(main)>
+
+The ls command is essentially a unified wrapper to a number of Ruby's introspection mechanisms, including (but not limited to) the following methods: methods, instance\_variables, constants, local\_variables, instance\_methods, class_variables and all the various permutations thereof.
+
+By default typing ls will return a list of just the local and instance variables available in the current context.
+
+* The -M option selects public instance methods (if available).
+* The -m option selects public methods.
+* The -c option selects constants.
+* The -i option select just instance variables.
+* The -l option selects just local variables.
+* The -s option modifies the -c and -m and -M options to go up the superclass chain (excluding Object).
+* The --grep REGEX prunes the list to items that match the regex.
+
+###Source Browsing
+
+
+Simply typing show-method method_name will pull the source for the method and display it with syntax highlighting. You can also look up the source for multiple methods at the same time, by typing show-method method1 method2. As a convenience, Pry looks up both instance methods and class methods using this syntax, with priority given to instance methods.
+
+    pry(Pry):1> show-method rep
+
+    From: /Users/john/ruby/projects/pry/lib/pry/pry_instance.rb @ line 191:
+    Number of lines: 6
+
+    def rep(target=TOPLEVEL_BINDING)
+      target = Pry.binding_for(target)
+      result = re(target)
+
+      show_result(result) if should_print?
+    end
+
+##AUTHORS
+
+Pry is primarily the work of John Mair (banisterfiend)

data/pry.gemspec

@@ -1,49 +1,46 @@
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
-  s.name = "pry"
-  s.version = "0.9.7.4"
+  s.name = %q{pry}
+  s.version = "0.9.8pre7"
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["John Mair (banisterfiend)"]
-  s.date = "2011-11-05"
-  s.description = "An IRB alternative and runtime developer console"
-  s.email = "jrmair@gmail.com"
-  s.executables = ["pry"]
-  s.files = [".document", ".gemtest", ".gitignore", ".travis.yml", ".yardopts", "CHANGELOG", "CONTRIBUTORS", "Gemfile", "LICENSE", "README.markdown", "Rakefile", "TODO", "bin/pry", "examples/example_basic.rb", "examples/example_command_override.rb", "examples/example_commands.rb", "examples/example_hooks.rb", "examples/example_image_edit.rb", "examples/example_input.rb", "examples/example_input2.rb", "examples/example_output.rb", "examples/example_print.rb", "examples/example_prompt.rb", "examples/helper.rb", "lib/pry.rb", "lib/pry/command_context.rb", "lib/pry/command_processor.rb", "lib/pry/command_set.rb", "lib/pry/commands.rb", "lib/pry/completion.rb", "lib/pry/config.rb", "lib/pry/core_extensions.rb", "lib/pry/custom_completions.rb", "lib/pry/default_commands/basic.rb", "lib/pry/default_commands/context.rb", "lib/pry/default_commands/documentation.rb", "lib/pry/default_commands/easter_eggs.rb", "lib/pry/default_commands/gems.rb", "lib/pry/default_commands/input.rb", "lib/pry/default_commands/introspection.rb", "lib/pry/default_commands/ls.rb", "lib/pry/default_commands/shell.rb", "lib/pry/extended_commands/experimental.rb", "lib/pry/extended_commands/user_command_api.rb", "lib/pry/helpers.rb", "lib/pry/helpers/base_helpers.rb", "lib/pry/helpers/command_helpers.rb", "lib/pry/helpers/options_helpers.rb", "lib/pry/helpers/text.rb", "lib/pry/history.rb", "lib/pry/history_array.rb", "lib/pry/indent.rb", "lib/pry/method.rb", "lib/pry/plugins.rb", "lib/pry/pry_class.rb", "lib/pry/pry_instance.rb", "lib/pry/rbx_method.rb", "lib/pry/rbx_path.rb", "lib/pry/version.rb", "pry.gemspec", "test/helper.rb", "test/test_command_helpers.rb", "test/test_command_processor.rb", "test/test_command_set.rb", "test/test_completion.rb", "test/test_default_commands.rb", "test/test_default_commands/test_context.rb", "test/test_default_commands/test_documentation.rb", "test/test_default_commands/test_gems.rb", "test/test_default_commands/test_input.rb", "test/test_default_commands/test_introspection.rb", "test/test_default_commands/test_ls.rb", "test/test_default_commands/test_shell.rb", "test/test_exception_whitelist.rb", "test/test_history_array.rb", "test/test_indent.rb", "test/test_input_stack.rb", "test/test_method.rb", "test/test_pry.rb", "test/test_pry_history.rb", "test/test_pry_output.rb", "test/test_special_locals.rb", "test/testrc", "test/testrcbad", "wiki/Customizing-pry.md", "wiki/Home.md"]
-  s.homepage = "http://pry.github.com"
-  s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.11"
-  s.summary = "An IRB alternative and runtime developer console"
-  s.test_files = ["test/helper.rb", "test/test_command_helpers.rb", "test/test_command_processor.rb", "test/test_command_set.rb", "test/test_completion.rb", "test/test_default_commands.rb", "test/test_default_commands/test_context.rb", "test/test_default_commands/test_documentation.rb", "test/test_default_commands/test_gems.rb", "test/test_default_commands/test_input.rb", "test/test_default_commands/test_introspection.rb", "test/test_default_commands/test_ls.rb", "test/test_default_commands/test_shell.rb", "test/test_exception_whitelist.rb", "test/test_history_array.rb", "test/test_indent.rb", "test/test_input_stack.rb", "test/test_method.rb", "test/test_pry.rb", "test/test_pry_history.rb", "test/test_pry_output.rb", "test/test_special_locals.rb", "test/testrc", "test/testrcbad"]
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
+  s.authors = [%q{John Mair (banisterfiend)}]
+  s.date = %q{2012-01-20}
+  s.description = %q{An IRB alternative and runtime developer console}
+  s.email = %q{jrmair@gmail.com}
+  s.executables = [%q{pry}]
+  s.files = [%q{.document}, %q{.gemtest}, %q{.gitignore}, %q{.travis.yml}, %q{.yardopts}, %q{CHANGELOG}, %q{CONTRIBUTORS}, %q{Gemfile}, %q{LICENSE}, %q{README.markdown}, %q{Rakefile}, %q{TODO}, %q{bin/pry}, %q{examples/example_basic.rb}, %q{examples/example_command_override.rb}, %q{examples/example_commands.rb}, %q{examples/example_hooks.rb}, %q{examples/example_image_edit.rb}, %q{examples/example_input.rb}, %q{examples/example_input2.rb}, %q{examples/example_output.rb}, %q{examples/example_print.rb}, %q{examples/example_prompt.rb}, %q{examples/helper.rb}, %q{lib/pry.rb}, %q{lib/pry/cli.rb}, %q{lib/pry/code.rb}, %q{lib/pry/command.rb}, %q{lib/pry/command_set.rb}, %q{lib/pry/commands.rb}, %q{lib/pry/completion.rb}, %q{lib/pry/config.rb}, %q{lib/pry/core_extensions.rb}, %q{lib/pry/custom_completions.rb}, %q{lib/pry/default_commands/basic.rb}, %q{lib/pry/default_commands/context.rb}, %q{lib/pry/default_commands/documentation.rb}, %q{lib/pry/default_commands/easter_eggs.rb}, %q{lib/pry/default_commands/gems.rb}, %q{lib/pry/default_commands/input.rb}, %q{lib/pry/default_commands/introspection.rb}, %q{lib/pry/default_commands/ls.rb}, %q{lib/pry/default_commands/shell.rb}, %q{lib/pry/extended_commands/experimental.rb}, %q{lib/pry/helpers.rb}, %q{lib/pry/helpers/base_helpers.rb}, %q{lib/pry/helpers/command_helpers.rb}, %q{lib/pry/helpers/options_helpers.rb}, %q{lib/pry/helpers/text.rb}, %q{lib/pry/history.rb}, %q{lib/pry/history_array.rb}, %q{lib/pry/hooks.rb}, %q{lib/pry/indent.rb}, %q{lib/pry/method.rb}, %q{lib/pry/plugins.rb}, %q{lib/pry/pry_class.rb}, %q{lib/pry/pry_instance.rb}, %q{lib/pry/rbx_method.rb}, %q{lib/pry/rbx_path.rb}, %q{lib/pry/version.rb}, %q{lib/pry/wrapped_module.rb}, %q{man/pry.1}, %q{man/pry.1.html}, %q{man/pry.1.ronn}, %q{pry.gemspec}, %q{test/helper.rb}, %q{test/test_cli.rb}, %q{test/test_code.rb}, %q{test/test_command.rb}, %q{test/test_command_helpers.rb}, %q{test/test_command_integration.rb}, %q{test/test_command_set.rb}, %q{test/test_completion.rb}, %q{test/test_default_commands.rb}, %q{test/test_default_commands/test_context.rb}, %q{test/test_default_commands/test_documentation.rb}, %q{test/test_default_commands/test_gems.rb}, %q{test/test_default_commands/test_input.rb}, %q{test/test_default_commands/test_introspection.rb}, %q{test/test_default_commands/test_ls.rb}, %q{test/test_default_commands/test_shell.rb}, %q{test/test_exception_whitelist.rb}, %q{test/test_history_array.rb}, %q{test/test_hooks.rb}, %q{test/test_indent.rb}, %q{test/test_input_stack.rb}, %q{test/test_method.rb}, %q{test/test_pry.rb}, %q{test/test_pry_defaults.rb}, %q{test/test_pry_history.rb}, %q{test/test_pry_output.rb}, %q{test/test_special_locals.rb}, %q{test/test_syntax_checking.rb}, %q{test/test_wrapped_module.rb}, %q{test/testrc}, %q{test/testrcbad}, %q{wiki/Customizing-pry.md}, %q{wiki/Home.md}]
+  s.homepage = %q{http://pry.github.com}
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.6}
+  s.summary = %q{An IRB alternative and runtime developer console}
+  s.test_files = [%q{test/helper.rb}, %q{test/test_cli.rb}, %q{test/test_code.rb}, %q{test/test_command.rb}, %q{test/test_command_helpers.rb}, %q{test/test_command_integration.rb}, %q{test/test_command_set.rb}, %q{test/test_completion.rb}, %q{test/test_default_commands.rb}, %q{test/test_default_commands/test_context.rb}, %q{test/test_default_commands/test_documentation.rb}, %q{test/test_default_commands/test_gems.rb}, %q{test/test_default_commands/test_input.rb}, %q{test/test_default_commands/test_introspection.rb}, %q{test/test_default_commands/test_ls.rb}, %q{test/test_default_commands/test_shell.rb}, %q{test/test_exception_whitelist.rb}, %q{test/test_history_array.rb}, %q{test/test_hooks.rb}, %q{test/test_indent.rb}, %q{test/test_input_stack.rb}, %q{test/test_method.rb}, %q{test/test_pry.rb}, %q{test/test_pry_defaults.rb}, %q{test/test_pry_history.rb}, %q{test/test_pry_output.rb}, %q{test/test_special_locals.rb}, %q{test/test_syntax_checking.rb}, %q{test/test_wrapped_module.rb}, %q{test/testrc}, %q{test/testrcbad}]
 
   if s.respond_to? :specification_version then
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<ruby_parser>, [">= 2.3.1"])
-      s.add_runtime_dependency(%q<coderay>, ["~> 0.9.8"])
-      s.add_runtime_dependency(%q<slop>, ["~> 2.1.0"])
-      s.add_runtime_dependency(%q<method_source>, ["~> 0.6.7"])
-      s.add_development_dependency(%q<bacon>, ["~> 1.1.0"])
-      s.add_development_dependency(%q<open4>, ["~> 1.0.1"])
+      s.add_runtime_dependency(%q<coderay>, ["~> 1.0.5"])
+      s.add_runtime_dependency(%q<slop>, ["< 3", ">= 2.4.3"])
+      s.add_runtime_dependency(%q<method_source>, ["~> 0.7"])
+      s.add_development_dependency(%q<bacon>, ["~> 1.1"])
+      s.add_development_dependency(%q<open4>, ["~> 1.3"])
       s.add_development_dependency(%q<rake>, ["~> 0.9"])
     else
-      s.add_dependency(%q<ruby_parser>, [">= 2.3.1"])
-      s.add_dependency(%q<coderay>, ["~> 0.9.8"])
-      s.add_dependency(%q<slop>, ["~> 2.1.0"])
-      s.add_dependency(%q<method_source>, ["~> 0.6.7"])
-      s.add_dependency(%q<bacon>, ["~> 1.1.0"])
-      s.add_dependency(%q<open4>, ["~> 1.0.1"])
+      s.add_dependency(%q<coderay>, ["~> 1.0.5"])
+      s.add_dependency(%q<slop>, ["< 3", ">= 2.4.3"])
+      s.add_dependency(%q<method_source>, ["~> 0.7"])
+      s.add_dependency(%q<bacon>, ["~> 1.1"])
+      s.add_dependency(%q<open4>, ["~> 1.3"])
       s.add_dependency(%q<rake>, ["~> 0.9"])
     end
   else
-    s.add_dependency(%q<ruby_parser>, [">= 2.3.1"])
-    s.add_dependency(%q<coderay>, ["~> 0.9.8"])
-    s.add_dependency(%q<slop>, ["~> 2.1.0"])
-    s.add_dependency(%q<method_source>, ["~> 0.6.7"])
-    s.add_dependency(%q<bacon>, ["~> 1.1.0"])
-    s.add_dependency(%q<open4>, ["~> 1.0.1"])
+    s.add_dependency(%q<coderay>, ["~> 1.0.5"])
+    s.add_dependency(%q<slop>, ["< 3", ">= 2.4.3"])
+    s.add_dependency(%q<method_source>, ["~> 0.7"])
+    s.add_dependency(%q<bacon>, ["~> 1.1"])
+    s.add_dependency(%q<open4>, ["~> 1.3"])
     s.add_dependency(%q<rake>, ["~> 0.9"])
   end
 end

data/test/helper.rb

@@ -3,11 +3,16 @@ unless Object.const_defined? 'Pry'
   require 'pry'
 end
 
-puts "Ruby v#{RUBY_VERSION} (#{defined?(RUBY_ENGINE) ? RUBY_ENGINE : "ruby"}), Pry v#{Pry::VERSION}, method_source v#{MethodSource::VERSION}, CodeRay v#{CodeRay::VERSION}"
+puts "Ruby v#{RUBY_VERSION} (#{defined?(RUBY_ENGINE) ? RUBY_ENGINE : "ruby"}), Pry v#{Pry::VERSION}, method_source v#{MethodSource::VERSION}, CodeRay v#{CodeRay::VERSION}, Slop v#{Slop::VERSION}"
 
 require 'bacon'
 require 'open4'
 
+
+# turn warnings off (esp for Pry::Hooks which will generate warnings
+# in tests)
+$VERBOSE = nil
+
 # Ensure we do not execute any rc files
 Pry::RC_FILES.clear
 
@@ -21,41 +26,21 @@ class << Pry
     Pry.color = false
     Pry.pager = false
     Pry.config.should_load_rc      = false
-    Pry.config.plugins.enabled     = false
+    Pry.config.should_load_plugins = false
     Pry.config.history.should_load = false
     Pry.config.history.should_save = false
     Pry.config.auto_indent         = false
-    Pry.config.hooks = { }
+    Pry.config.hooks               = Pry::Hooks.new
+    Pry.config.collision_warning   = false
   end
 end
 
-class MockPryException
-  attr_accessor :bt_index
-  attr_accessor :backtrace
-
-  def initialize(*backtrace)
-    @backtrace = backtrace
-    @bt_index = 0
-  end
-
-  def message
-    "mock exception"
+def mock_exception(*mock_backtrace)
+  e = StandardError.new("mock exception")
+  (class << e; self; end).class_eval do
+    define_method(:backtrace) { mock_backtrace }
   end
-
-  def bt_source_location_for(index)
-    backtrace[index] =~ /(.*):(\d+)/
-    [$1, $2.to_i]
-  end
-end
-
-# are we on Jruby platform?
-def jruby?
-  defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /jruby/
-end
-
-# are we on rbx platform?
-def rbx?
-  defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /rbx/
+  e
 end
 
 Pry.reset_defaults
@@ -107,6 +92,12 @@ def mock_pry(*args)
   output.string
 end
 
+def mock_command(cmd, args=[], opts={})
+  output = StringIO.new
+  ret = cmd.new(opts.merge(:output => output)).call_safely(*args)
+  Struct.new(:output, :return).new(output.string, ret)
+end
+
 def redirect_global_pry_input(new_io)
   old_io = Pry.input
     Pry.input = new_io
@@ -135,15 +126,12 @@ end
 
 class InputTester
   def initialize(*actions)
-    if actions.last.is_a?(Hash) && actions.last.keys == [:history]
-      @hist = actions.pop[:history]
-    end
     @orig_actions = actions.dup
     @actions = actions
   end
 
   def readline(*)
-    @actions.shift.tap{ |line| @hist << line if @hist }
+    @actions.shift
   end
 
   def rewind
@@ -162,11 +150,11 @@ end
 
 # Open a temp file and yield it to the block, closing it after
 # @return [String] The path of the temp file
-def temp_file
-  file = Tempfile.new("tmp")
+def temp_file(ext='.rb')
+  file = Tempfile.new(['pry', ext])
   yield file
 ensure
-  file.close
+  file.close(true) if file
 end
 
 
@@ -179,3 +167,11 @@ CommandTester = Pry::CommandSet.new do
     output.puts arg
   end
 end
+
+# to help with tracking down bugs that cause an infinite loop in the test suite
+if ENV["SET_TRACE_FUNC"]
+  require 'set_trace' if Pry::Helpers::BaseHelpers.rbx?
+  set_trace_func proc { |event, file, line, id, binding, classname|
+     STDERR.printf "%8s %s:%-2d %10s %8s\n", event, file, line, id, classname
+  }
+end

data/test/test_cli.rb

@@ -0,0 +1,78 @@
+require 'helper'
+
+describe Pry::Hooks do
+  before do
+    Pry::CLI.reset
+  end
+
+  describe "parsing options" do
+    it 'should raise if no options defined' do
+      lambda { Pry::CLI.parse_options(["--nothing"]) }.should.raise Pry::CLI::NoOptionsError
+    end
+  end
+
+  describe "adding options" do
+    it "should be able to add an option" do
+      run = false
+
+      Pry::CLI.add_options do
+        on :optiontest, "A test option" do
+          run = true
+        end
+      end.parse_options(["--optiontest"])
+
+      run.should == true
+    end
+
+    it "should be able to add multiple options" do
+      run = false
+      run2 = false
+
+      Pry::CLI.add_options do
+        on :optiontest, "A test option" do
+          run = true
+        end
+      end.add_options do
+        on :optiontest2, "Another test option" do
+          run2 = true
+        end
+      end.parse_options(["--optiontest", "--optiontest2"])
+
+      run.should == true
+      run2.should == true
+    end
+
+  end
+
+  describe "processing options" do
+    it "should be able to process an option" do
+      run = false
+
+      Pry::CLI.add_options do
+        on :optiontest, "A test option"
+      end.process_options do |opts|
+        run = true if opts.present?(:optiontest)
+      end.parse_options(["--optiontest"])
+
+      run.should == true
+    end
+
+    it "should be able to  process multiple options" do
+      run = false
+      run2 = false
+
+      Pry::CLI.add_options do
+        on :optiontest, "A test option"
+        on :optiontest2, "Another test option"
+      end.process_options do |opts|
+        run = true if opts.present?(:optiontest)
+      end.process_options do |opts|
+        run2 = true if opts.present?(:optiontest2)
+      end.parse_options(["--optiontest", "--optiontest2"])
+
+      run.should == true
+      run2.should == true
+    end
+
+  end
+end

data/test/test_code.rb

@@ -0,0 +1,201 @@
+require 'helper'
+
+describe Pry::Code do
+  describe '.from_file' do
+    should 'read lines from a file on disk' do
+      Pry::Code.from_file('lib/pry.rb').length.should > 0
+    end
+
+    should 'read lines from Pry\'s line buffer' do
+      mock_pry(':hay_guys')
+      Pry::Code.from_file('(pry)').grep(/:hay_guys/).length.should == 1
+    end
+
+    should 'default to Ruby' do
+      temp_file('') do |f|
+        Pry::Code.from_file(f.path).code_type.should == :ruby
+      end
+    end
+
+    should 'check the extension' do
+      temp_file('.c') do |f|
+        Pry::Code.from_file(f.path).code_type.should == :c
+      end
+    end
+
+    should 'raise an error if the file doesn\'t exist' do
+      proc do
+        Pry::Code.from_file('/knalkjsdnalsd/alkjdlkq')
+      end.should.raise(Pry::CommandError)
+    end
+  end
+
+  describe '.from_method' do
+    should 'read lines from a method\'s definition' do
+      m = Pry::Method.from_obj(Pry, :load_history)
+      Pry::Code.from_method(m).length.should > 0
+    end
+  end
+
+  describe '#initialize' do
+    before do
+      @str = Pry::Helpers::CommandHelpers.unindent <<-CODE
+        def hay
+          :guys
+        end
+      CODE
+
+      @array = ['def hay', '  :guys', 'end']
+    end
+
+    should 'break a string into lines' do
+      Pry::Code.new(@str).length.should == 3
+    end
+
+    should 'accept an array' do
+      Pry::Code.new(@array).length.should == 3
+    end
+
+    it 'an array or string should produce an equivalent object' do
+      Pry::Code.new(@str).should == Pry::Code.new(@array)
+    end
+  end
+
+  describe 'filters and formatters' do
+    before do
+      @code = Pry::Code(Pry::Helpers::CommandHelpers.unindent <<-STR)
+        class MyProgram
+          def self.main
+            puts 'Hello, world!'
+          end
+        end
+      STR
+    end
+
+    describe 'filters' do
+      describe '#between' do
+        should 'work with an inclusive range' do
+          @code = @code.between(1..3)
+          @code.length.should == 3
+          @code.should =~ /\Aclass MyProgram/
+          @code.should =~ /world!'\Z/
+        end
+
+        should 'default to an inclusive range' do
+          @code = @code.between(3, 5)
+          @code.length.should == 3
+        end
+
+        should 'work with an exclusive range' do
+          @code = @code.between(2...4)
+          @code.length.should == 2
+          @code.should =~ /\A  def self/
+          @code.should =~ /world!'\Z/
+        end
+
+        should 'use real line numbers for positive indices' do
+          @code = @code.after(3, 3)
+          @code = @code.between(4, 4)
+          @code.length.should == 1
+          @code.should =~ /\A  end\Z/
+        end
+      end
+
+      describe '#before' do
+        should 'work' do
+          @code = @code.before(3, 1)
+          @code.should =~ /\A  def self\.main\Z/
+        end
+      end
+
+      describe '#around' do
+        should 'work' do
+          @code = @code.around(3, 1)
+          @code.length.should == 3
+          @code.should =~ /\A  def self/
+          @code.should =~ /  end\Z/
+        end
+      end
+
+      describe '#after' do
+        should 'work' do
+          @code = @code.after(3, 1)
+          @code.should =~ /\A  end\Z/
+        end
+      end
+
+      describe '#grep' do
+        should 'work' do
+          @code = @code.grep(/end/)
+          @code.length.should == 2
+        end
+      end
+    end
+
+    describe 'formatters' do
+      describe '#with_line_numbers' do
+        should 'show line numbers' do
+          @code = @code.with_line_numbers
+          @code.should =~ /1:/
+        end
+
+        should 'disable line numbers when falsy' do
+          @code = @code.with_line_numbers
+          @code = @code.with_line_numbers(false)
+          @code.should.not =~ /1:/
+        end
+      end
+
+      describe '#with_marker' do
+        should 'show a marker in the right place' do
+          @code = @code.with_marker(2)
+          @code.should =~ /^ =>   def self/
+        end
+
+        should 'disable the marker when falsy' do
+          @code = @code.with_marker(2)
+          @code = @code.with_marker(false)
+          @code.should =~ /^  def self/
+        end
+      end
+
+      describe '#with_indentation' do
+        should 'indent the text' do
+          @code = @code.with_indentation(2)
+          @code.should =~ /^    def self/
+        end
+
+        should 'disable the indentation when falsy' do
+          @code = @code.with_indentation(2)
+          @code = @code.with_indentation(false)
+          @code.should =~ /^  def self/
+        end
+      end
+    end
+
+    describe 'composition' do
+      describe 'grep and with_line_numbers' do
+        should 'work' do
+          @code = @code.grep(/end/).with_line_numbers
+          @code.should =~ /\A4:   end/
+          @code.should =~ /5: end\Z/
+        end
+      end
+
+      describe 'grep and before and with_line_numbers' do
+        should 'work' do
+          @code = @code.grep(/e/).before(5, 5).with_line_numbers
+          @code.should =~ /\A2:   def self.main\n3:/
+          @code.should =~ /4:   end\Z/
+        end
+      end
+
+      describe 'before and after' do
+        should 'work' do
+          @code = @code.before(4, 2).after(2)
+          @code.should == "    puts 'Hello, world!'"
+        end
+      end
+    end
+  end
+end