binding.repl 1.0.4.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9efd8499161c382b7cac61e1e4f7e8e255e5a41c
-  data.tar.gz: 5500700763ba3b2c6528001dcafffdafdc3b0595
+  metadata.gz: efdbef0970558803105b9fd7dded3ffdf38fb120
+  data.tar.gz: ff8b0424aeba9a3b5cc299a97a66a553e8ed9735
 SHA512:
-  metadata.gz: d2249eb630d7d069bd6163d00d2305c54c75d4d8c76793b205750d41625afd664c99ee346fb4e0232b6371953a33780e273004a33df4ebfe86b971f3e4a289c2
-  data.tar.gz: 08acad9f98824bed9f95d1732be4cbfd09aee7061d03c70883c850f4abc49340f5da7f872da130798a5dac2e7cdfa38ca661c1d137523df7f9ed1e166ec63823
+  metadata.gz: f31c9e90899e97cc0834b3cf2ca36c9ebdbe3aa36f16e681388d9ff68ed3bb3b42c1961728f83518398504ba7c2fadeae081a3d44cd7c03b15fd2c4c31176f38
+  data.tar.gz: 6fb64450c68878cecbeee80d12af3f3224fbc854c0d5030b919948a8822f6d0262e3d4e46711caf9c476578d4ad78751f3128d8ad42047ae8cc93ff1a3bc8080

data/.bundle/config

@@ -0,0 +1,3 @@
+---
+BUNDLE_PATH: ".gems"
+BUNDLE_DISABLE_SHARED_GEMS: '1'

data/.gitignore

@@ -0,0 +1,6 @@
+Gemfile.lock
+pkg/
+.gems/
+*.md~
+*.rb~
+*.rb#

data/.travis.yml

@@ -0,0 +1,12 @@
+install: bundle install
+script: ruby -S rake
+
+rvm:
+  - 1.9.3
+  - 2.1.3
+  - ruby-head
+  - jruby
+  - rbx-2
+
+notifications:
+  email: true

data/ChangeLog.txt

@@ -0,0 +1,9 @@
+== v3.0.0
+   * Remove Binding.repl 
+   * Remove bin/binding.repl
+   * Remove BindingRepl::Runner
+   * Remove BindingRepl::ExitValue#success?
+   * Remove BindingRepl::ExitValue.unknown
+   * Remove BindingRepl::ENV
+   * Remove support for $auto shell var
+   

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+gemspec
+group :test do
+  gem 'rspec-core'
+  gem 'rspec-mocks'
+  gem 'minitest', require: ['minitest', 'minitest/unit']
+end

data/MIT-LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 rpag
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,58 @@
+__binding.repl__
+
+[![Build Status](https://travis-ci.org/rpag/binding.repl.svg?branch=master)](https://travis-ci.org/rpag/binding.repl)  
+[![Code Climate](https://codeclimate.com/github/rpag/binding.repl/badges/gpa.svg)](https://codeclimate.com/github/rpag/binding.repl)
+
+"binding.pry" for every ruby repl.
+
+__Features__
+
+* Start the repl pry, irb, ripl, rib or ir at runtime
+* Auto-discover and start the first found repl at runtime
+* Require of a repl is delayed until you call "binding.repl.<repl name>" 
+* Require of a repl is never duplicated
+* Easily extended to support new repls
+
+__Examples__
+
+__1.__
+
+An example of how you can start a repl of your choice in a
+[sinatra](https://github.com/sinatra/sinatra) web application:
+
+```ruby
+get "/greet" do
+  binding.repl.{pry,irb,ripl,rib,ir}
+  ["hello", "hola"].sample
+end
+```
+__2.__
+
+Auto-discover and start the first found repl:
+
+```ruby
+class Apple
+  # auto discover and start the first found repl.
+  binding.repl.auto
+
+  # same as 'binding.repl.auto' but with less characters to type.
+  binding.repl!
+end
+```
+
+__Install__
+
+rubygems:
+
+    gem install binding.repl
+
+git:
+
+    git clone https://github.com/rpag/binding.repl.git
+    cd binding.repl
+    gem build binding.repl.gemspec
+    gem install *.gem
+
+__License__
+
+See MIT-LICENSE.txt file.

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = false
+end
+task :default => :test

data/binding.repl.gemspec

@@ -0,0 +1,12 @@
+$LOAD_PATH.push 'lib'
+Kernel.require 'binding.repl/version'
+Gem::Specification.new do |spec|
+  spec.name          = 'binding.repl'
+  spec.version       = BindingRepl::VERSION
+  spec.authors       = ['rpag']
+  spec.email         = ['rpag@singletonclass.com']
+  spec.summary       = '"binding.pry" for every ruby repl'
+  spec.homepage      = 'https://github.com/rpag/binding.repl'
+  spec.files         = `git ls-files`.split($/)
+  spec.license       = 'MIT'
+end

data/examples/ir.rb

@@ -0,0 +1,2 @@
+require_relative '../lib/binding.repl'
+binding.repl.ir

data/examples/irb.rb

@@ -0,0 +1,3 @@
+require_relative '../lib/binding.repl'
+binding.repl.irb
+

data/examples/pry.rb

@@ -0,0 +1,2 @@
+require_relative '../lib/binding.repl'
+binding.repl.pry

data/examples/rib.rb

@@ -0,0 +1,2 @@
+require_relative '../lib/binding.repl'
+binding.repl.rib

data/examples/ripl.rb

@@ -0,0 +1,2 @@
+require_relative '../lib/binding.repl'
+binding.repl.ripl

data/lib/binding.repl.rb

@@ -1,14 +1,39 @@
 class BindingRepl
-  LOOKUP = {}
-  LOOKUP.default = [proc { true }, proc { :'binding.repl.unknown_console' }]
-  DEFAULT_AUTO_ORDER = ["pry", "ripl", "rib", "irb"].freeze
+  DEFAULT_AUTO = ['pry', 'irb', 'ripl', 'rib', 'ir']
 
-  def self.auto_order=(list)
-    @auto_order = list
+  #
+  # @param [String] name
+  #   the name of a repl, callable through `binding.repl.<name>`.
+  #
+  # @param [Array<Proc, Proc>] valuep
+  #   a Proc pair that defines an initializer and a runner for a repl.
+  #
+  # @raise
+  #   (see BindingRepl#start)
+  #
+  def self.[]=(name, valuep)
+    define_method(name) do |options = {}|
+      start(name.to_s, @binding, valuep, options)
+    end
+  end
+
+  #
+  #  @return [Array<String>]
+  #    returns an array of repl names.
+  #
+  def self.auto
+    @auto ||= DEFAULT_AUTO
   end
 
-  def self.auto_order
-    @auto_order or BindingRepl::ENV.auto_order or DEFAULT_AUTO_ORDER
+  #
+  #  @param [Array<String>] list
+  #    defines a new order for the {#auto} method.
+  #
+  #  @return [Array<String>]
+  #    returns the argument.
+  #
+  def self.auto=(list)
+    @auto = list
   end
 
   #
@@ -32,7 +57,7 @@ class BindingRepl
 
   #
   # disable binding.repl
-  # future calls to `binding.repl.{auto,pry,rib,ripl}` become a no-op.
+  # future calls to `binding.repl.{auto,fry,rib,pry,ripl}` become a no-op.
   #
   # @return [true]
   #
@@ -41,93 +66,75 @@ class BindingRepl
   end
 
   #
-  # @param [Symbol] console
-  #   the name of a console. available as `binding.repl.<console>`.
+  #  @param [Binding] binding
+  #    a Binding object.
   #
-  # @param [Proc] initializer
-  #   a Proc that is called on the very first call of `binding.repl.<console>`.
+  #  @return [BindingRepl]
+  #    returns an instance of BindingRepl.
   #
-  # @param [Proc] runner
-  #   a Proc that is expected to start a repl.
-  #   the Proc is passed a `Binding` and a Hash of options.
-  #
-  # @return [nil, Symbol]
-  #   returns the return value of a method definition.
-  #   on 2.1+ that could be the method name as a symbol, or nil on <2.1.
-  #
-  def self.add(console, initializer, runner)
-    LOOKUP[console.to_s] = [initializer, runner]
-    define_method(console) do |options = {}|
-      value = run_console(console, options)
-      value.failure? ? die(console) : value
-    end
-  end
-
   def initialize(binding)
     @binding = binding
-    @lookup = LOOKUP
+    @auto = BindingRepl.auto.dup
   end
 
   #
-  # iterates through BindingRepl.auto_order and starts the first available console.
-  #
-  # @raise [LoadError]
-  #   raises a LoadError when BindingRepl.auto_order is empty.
+  # discovers and starts the first available repl.
   #
   # @raise [LoadError]
-  #   raises a LoadError when no consoles in BindingRepl.auto_order can be loaded
-  #   via Kernel#require.
+  #   when no repl can be loaded.
   #
   # @return [BindingRepl::ExitValue]
-  #   returns an instance of {BindingRepl::ExitValue} when the repl has exited.
+  #   returns an instance of {BindingRepl::ExitValue}.
   #
   def auto
-    consoles = BindingRepl.auto_order
-    value = run_any_console(consoles)
-    if consoles.empty?
-      raise LoadError, "no consoles available to load. BindingRepl.auto_order is empty"
-    elsif value.nil?
-      consoles_str = consoles.join(", ")
-      raise LoadError, "attempts to require any of the following consoles failed: #{consoles_str}"
-    else
-      value
+    @auto.each do |repl_name|
+      begin
+        return public_send(repl_name, {})
+      rescue LoadError, NoMethodError
+      end
     end
+    raise LoadError, 'failed to require a repl'
   end
 
-private
-  def die(console)
-    raise LoadError, "failed to require '#{console}'"
-  end
-
-  def run_any_console(consoles)
-    consoles.each do |console|
-      value = run_console(console)
-      return value if value.success?
-    end
-    nil
+  #
+  #  @return [Boolean]
+  #    returns true when BindingRepl is disabled.
+  #
+  def disabled?
+    BindingRepl.disabled?
   end
 
-  def run_console(console, options = {})
-    console = console.to_s
-    if BindingRepl.disabled?
-      value = BindingRepl::ExitValue.disabled_value
-    else
-      initializer, runner = @lookup[console]
-      initializer.call
-      @lookup[console] = [@lookup.default.at(0), runner]
-      value = runner.call @binding, options
+private
+  #
+  # @param [String] name
+  #   the name of a repl.
+  #
+  # @param [Binding] binding
+  #   a Binding object.
+  #
+  # @param [Array<Proc, Proc>] valuep
+  #   a value pair (initializer and a runner)
+  #
+  # @param [Hash] options
+  #   options Hash that are forwarded to the repl.
+  #
+  def start(name, binding, valuep, options)
+    if disabled?
+      return BindingRepl::ExitValue.disabled
     end
-  rescue LoadError
-    value = BindingRepl::ExitValue.load_error_value
-  ensure
-    return BindingRepl::ExitValue.new(value)
+    init, runner = valuep[0..1]
+    init.call(name)
+    BindingRepl::ExitValue.new runner.call(binding, options)
+  rescue LoadError => e
+    raise e, "failed to require '#{name}' repl"
   end
 end
-require_relative "binding.repl/core_ext/binding"
-require_relative "binding.repl/env"
-require_relative "binding.repl/exit_value"
-require_relative "binding.repl/version"
-require_relative "binding.repl/repls/pry"
-require_relative "binding.repl/repls/irb"
-require_relative "binding.repl/repls/ripl"
-require_relative "binding.repl/repls/rib"
+
+require_relative 'binding.repl/version'
+require_relative 'binding.repl/exitvalue'
+require_relative 'binding.repl/mpatch/binding'
+require_relative 'binding.repl/repls/irb'
+require_relative 'binding.repl/repls/ripl'
+require_relative 'binding.repl/repls/rib'
+require_relative 'binding.repl/repls/pry'
+require_relative 'binding.repl/repls/ir'

data/lib/binding.repl/exitvalue.rb

@@ -0,0 +1,40 @@
+class BindingRepl::ExitValue
+  MAP = {
+    :disabled => :'binding.repl.disabled'
+  }
+
+  #
+  #  @return [BindingRepl::ExitValue]
+  #    returns a disabled exit value.
+  #
+  def self.disabled
+    new(MAP[:disabled])
+  end
+
+  #
+  # @param [BasicObject, Object] an object
+  #   an object who has been returned by a repl.
+  #
+  # @return [BindingRepl::ExitValue] 
+  #   returns an instance of {BindingRepl::ExitValue}.
+  #
+  def initialize(object)
+    @object = object
+  end
+
+  #
+  # @return [Object, BasicObject]
+  #   returns the object returned as an exit value by a repl.
+  #
+  def object
+    @object
+  end
+
+  #
+  #  @return [Boolean]
+  #    returns a true value if the exit value is returned while binding.repl is disabled.
+  #
+  def disabled?
+    MAP[:disabled].equal?(@object)
+  end
+end

data/lib/binding.repl/{core_ext → mpatch}/binding.rb

@@ -1,8 +1,4 @@
 class Binding
-  def self.repl
-    BindingRepl
-  end
-
   def repl
     BindingRepl.new(self)
   end

data/lib/binding.repl/repls/ir.rb

@@ -0,0 +1,7 @@
+initializer = lambda do |name|
+  require(name) unless defined?(Ir)
+end
+runner = lambda do |binding, options|
+  Ir::Tty.new options.merge(binding: binding)
+end
+BindingRepl['ir'] = [initializer, runner]

data/lib/binding.repl/repls/irb.rb

@@ -1,11 +1,10 @@
-initializer = lambda do
-  require "irb"
-  IRB.setup(nil)
+initializer = lambda do |name|
+  require(name) unless defined?(IRB)
+  require_relative 'irb/irb'
+  IRB.conf.merge!(BindingRepl::IRB::MAP)
 end
 runner = lambda do |binding, options|
-  irb = IRB::Irb.new IRB::WorkSpace.new(binding)
-  IRB.conf[:MAIN_CONTEXT] = irb.context
-  trap("SIGINT") { irb.signal_handle }
-  catch(:IRB_EXIT) { irb.eval_input }
+  BindingRepl::IRB.new(binding, options).repl
 end
-BindingRepl.add :irb, initializer, runner
+BindingRepl['irb'] = [initializer, runner]
+

data/lib/binding.repl/repls/irb/irb.rb

@@ -0,0 +1,119 @@
+class BindingRepl::IRB
+  MAP = {
+    IRB_NAME:        'irb'            ,
+    MATH_MODE:        nil             ,
+    INSPECT_MODE:     true            ,
+    IRB_RC:           nil             ,
+    BACK_TRACE_LIMIT: 17              ,
+    USE_LOADER:       false           ,
+    USE_TRACER:       false           ,
+    IGNORE_SIGINT:    false           ,
+    IGNORE_EOF:       false           ,
+    DEBUG_LEVEL:      0               ,
+    PROMPT_MODE:      :DEFAULT        ,
+    LC_MESSAGES:      ''              ,
+    PROMPT: { 
+      :NULL => {
+	:PROMPT_I => nil,
+	:PROMPT_N => nil,
+	:PROMPT_S => nil,
+	:PROMPT_C => nil,
+	:RETURN => "%s\n"
+      },
+      :DEFAULT => {
+	:PROMPT_I => "%N(%m):%03n:%i> ",
+	:PROMPT_N => "%N(%m):%03n:%i> ",
+	:PROMPT_S => "%N(%m):%03n:%i%l ",
+	:PROMPT_C => "%N(%m):%03n:%i* ",
+	:RETURN => "=> %s\n"
+      },
+      :CLASSIC => {
+	:PROMPT_I => "%N(%m):%03n:%i> ",
+	:PROMPT_N => "%N(%m):%03n:%i> ",
+	:PROMPT_S => "%N(%m):%03n:%i%l ",
+	:PROMPT_C => "%N(%m):%03n:%i* ",
+	:RETURN => "%s\n"
+      },
+      :SIMPLE => {
+	:PROMPT_I => ">> ",
+	:PROMPT_N => ">> ",
+	:PROMPT_S => nil,
+	:PROMPT_C => "?> ",
+	:RETURN => "=> %s\n"
+      },
+      :INF_RUBY => {
+	:PROMPT_I => "%N(%m):%03n:%i> ",
+	:PROMPT_N => nil,
+	:PROMPT_S => nil,
+	:PROMPT_C => nil,
+	:RETURN => "%s\n",
+	:AUTO_INDENT => true
+      },
+      :XMP => {
+	:PROMPT_I => nil,
+	:PROMPT_N => nil,
+	:PROMPT_S => nil,
+	:PROMPT_C => nil,
+	:RETURN => "    ==>%s\n"
+      },
+      :'binding.repl' => {
+	:PROMPT_I => "% ",
+	:PROMPT_N => "% ",
+	:PROMPT_S => nil,
+	:PROMPT_C => "?> ",
+	:RETURN => "=> %s\n"
+      },
+    }
+  }
+
+  #
+  #  @param 
+  #    (see BindingRepl::IRB#initialize)
+  #
+  #  @return 
+  #    (see BindingRepl::IRB#repl)
+  #
+  def self.start(binding, options = {})
+    new(binding, options).repl
+  end
+
+  #
+  # @param [Binding] binding
+  #   a Binding object.
+  #
+  # @param [Hash] options
+  #   a Hash of options.  
+  #   see {BindingRepl::IRB::MAP} for a list of possibles.
+  #
+  def initialize(binding, options = {})
+    @binding = binding
+    @options = ::IRB.conf.merge!(options)
+    @ws      = ::IRB::WorkSpace.new(@binding)
+    @repl    = ::IRB::Irb.new(@ws)
+  end
+
+  #
+  # read, eval, print, and loop.
+  #
+  # @return [BasicObject, Object]
+  #   returns a repl exit value.
+  #
+  def repl
+    setup
+    signal_handle
+    eval_input
+  end
+
+private
+  def setup
+    ::IRB.conf[:MAIN_CONTEXT] = @repl.context
+  end
+
+  def signal_handle
+    trap(:SIGINT) { @repl.signal_handle }
+  end
+
+  def eval_input
+    catch(:IRB_EXIT) { @repl.eval_input }
+  end
+end

data/lib/binding.repl/repls/pry.rb

@@ -1,7 +1,7 @@
-initializer = lambda do
-  require "pry"
-end
-runner = lambda do |binding, options|
-  binding.pry(options)
-end
-BindingRepl.add :pry, initializer, runner
+initializer = lambda do |name|
+  require(name) unless defined?(Pry)
+end
+runner = lambda do |binding, options|
+  Pry.start(binding, options)
+end
+BindingRepl['pry'] = [initializer, runner]

data/lib/binding.repl/repls/rib.rb

@@ -1,8 +1,11 @@
-initializer = lambda do
-  require "rib"
-  require "rib/more/anchor"
+initializer = lambda do |name|
+  unless defined?(Rib)
+    require 'rib'
+    require 'rib/more/anchor'
+  end
 end
 runner = lambda do |binding, options|
-  Rib.anchor binding, options
+  Rib.anchor(binding, options)
 end
-BindingRepl.add :rib, initializer, runner
+BindingRepl['rib'] = [initializer, runner]
+

data/lib/binding.repl/repls/ripl.rb

@@ -1,7 +1,7 @@
-initializer = lambda do
-  require "ripl"
+initializer = lambda do |name|
+  require(name) unless defined?(Ripl)
 end
 runner = lambda do |binding, options|
   Ripl.start options.merge(binding: binding)
 end
-BindingRepl.add :ripl, initializer, runner
+BindingRepl['ripl'] = [initializer, runner]

data/lib/binding.repl/version.rb

@@ -1,6 +1,3 @@
 class BindingRepl
-  VERSION = "1.0.4.1"
-  def self.version
-    VERSION
-  end
+  VERSION = '3.0.0'
 end

data/test/binding_repl_auto_test.rb

@@ -0,0 +1,41 @@
+require_relative 'setup'
+class BindingReplAutoTest < Minitest::Test
+  include BindingRepl::Mock
+  def setup
+    super
+    BindingRepl.auto = nil
+  end
+
+  def teardown
+    super
+    BindingRepl.auto = nil
+  end
+
+  def test_ripl_as_second_match
+    BindingRepl.auto = ['example', 'ripl']
+    expect(Ripl).to receive(:start).with(binding: instance_of(Binding))
+    binding.repl.auto
+  end
+
+  def test_no_match
+    BindingRepl.auto = ['ry', 'bu']
+    assert_raises(LoadError) { binding.repl.auto }
+  end
+
+  def test_empty
+    BindingRepl.auto = []
+    assert_raises(LoadError) { binding.repl.auto }
+  end
+
+  def test_disable
+    BindingRepl.disable!
+    assert_equal binding.repl.auto.disabled?, true
+  ensure
+    BindingRepl.enable!
+  end
+
+  def test_shortcut_method_repl!
+    expect_any_instance_of(BindingRepl).to receive(:auto)
+    binding.repl!
+  end
+end

data/test/binding_repl_irb_test.rb

@@ -0,0 +1,16 @@
+require_relative 'setup'
+class BindingReplIrbTest < Minitest::Test
+  include BindingRepl::Mock
+  def test_irb
+    expect_any_instance_of(IRB::Irb).to receive(:eval_input)
+    binding.repl.irb
+  end
+
+  def test_irb_set_custom_option
+    irbrc = IRB.conf[:IRB_RC]
+    expect_any_instance_of(IRB::Irb).to receive(:eval_input)
+    binding.repl.irb IRB_RC: '/home/nobody/.irbrc'
+    assert_equal '/home/nobody/.irbrc', IRB.conf[:IRB_RC]
+    IRB.conf[:IRB_RC] = irbrc
+  end
+end

data/test/binding_repl_rib_test.rb

@@ -0,0 +1,13 @@
+require_relative 'setup'
+class BindingReplRibTest < Minitest::Test
+  include BindingRepl::Mock
+  def test_rib
+    expect(Rib).to receive(:anchor).with(instance_of(Binding), {})
+    binding.repl.rib
+  end
+
+  def test_rib_with_options
+    expect(Rib).to receive(:anchor).with(instance_of(Binding), {prompt: ">>"})
+    binding.repl.rib prompt: ">>"
+  end
+end

data/test/binding_repl_ripl_test.rb

@@ -0,0 +1,13 @@
+require_relative "setup"
+class BindingReplRiplTest < Minitest::Test
+  include BindingRepl::Mock
+  def test_ripl
+    expect(Ripl).to receive(:start).with({binding: instance_of(Binding)})
+    binding.repl.ripl
+  end
+
+  def test_ripl_with_options
+    expect(Ripl).to receive(:start).with({binding: instance_of(Binding), riplrc: false})
+    binding.repl.ripl riplrc: false
+  end
+end

data/test/binding_repl_test.rb

@@ -0,0 +1,24 @@
+require_relative "setup"
+class BindingReplTest < Minitest::Test
+  def setup
+    @before = BindingRepl.auto.dup
+  end
+
+  def teardown
+    BindingRepl.auto = @before
+  end
+
+  def test_default_return_value_of_auto
+    assert_equal BindingRepl::DEFAULT_AUTO, BindingRepl.auto
+  end
+
+  def test_set_of_new_auto
+    BindingRepl.auto = ['a', 'b']
+    assert_equal ['a', 'b'], BindingRepl.auto
+  end
+
+  def test_set_of_nil_on_auto
+    BindingRepl.auto = nil
+    assert_equal BindingRepl::DEFAULT_AUTO, BindingRepl.auto
+  end
+end

data/test/binding_test.rb

@@ -0,0 +1,12 @@
+require_relative "setup"
+class BindingTest < Minitest::Test
+  include BindingRepl::Mock
+  def test_return_value_of_repl
+    assert_instance_of BindingRepl, binding.repl
+  end
+
+  def test_delegate_to_auto
+    expect_any_instance_of(BindingRepl).to receive(:auto)
+    binding.repl!
+  end
+end

data/test/setup.rb

@@ -0,0 +1,5 @@
+require 'bundler/setup'
+Bundler.require :default, :test
+require_relative 'support/mock'
+require_relative 'support/repls'
+Minitest.autorun

data/test/support/mock.rb

@@ -0,0 +1,15 @@
+module BindingRepl::Mock
+  include RSpec::Mocks::ExampleMethods
+
+  def setup
+    RSpec::Mocks.setup
+    super
+  end
+
+  def teardown
+    RSpec::Mocks.verify
+  ensure
+    RSpec::Mocks.teardown
+    super
+  end
+end

data/test/support/repls.rb

@@ -0,0 +1,55 @@
+module IRB
+  @CONF = {}
+
+  def self.conf
+    @CONF
+  end
+
+  def self.setup(ap = nil)
+  end
+
+  def self.irb_at_exit
+  end
+
+  class WorkSpace
+    def initialize(b, other=nil)
+    end
+  end
+
+  class Irb
+    def initialize(*)
+    end
+
+    def context
+      binding
+    end
+
+    def eval_input
+    end
+  
+    def signal_handle
+    end
+  end
+end
+
+class Ir
+  class Tty
+    def initialize(options = {})
+    end
+  end
+end
+
+class Ripl
+  def self.start(options = {})
+  end
+end
+
+class Pry
+  def self.start(binding, options = {})
+  end
+end
+
+class Rib
+  def self.anchor(binding, options = {})
+  end
+end

metadata

@@ -1,39 +1,58 @@
 --- !ruby/object:Gem::Specification
 name: binding.repl
 version: !ruby/object:Gem::Version
-  version: 1.0.4.1
+  version: 3.0.0
 platform: ruby
 authors:
-- Public Domain
+- rpag
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-24 00:00:00.000000000 Z
+date: 2014-10-03 00:00:00.000000000 Z
 dependencies: []
-description: binding.repl is `binding.pry` but for every ruby repl.
+description: 
 email:
-- robert@flowof.info
+- rpag@singletonclass.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- LEGAL.txt
-- doc/disableatruntime.md
-- doc/exit_values.md
-- doc/runtimeoptions.md
-- doc/shellvariables.md
+- ".bundle/config"
+- ".gitignore"
+- ".travis.yml"
+- ChangeLog.txt
+- Gemfile
+- MIT-LICENSE.txt
+- README.md
+- Rakefile
+- binding.repl.gemspec
+- examples/ir.rb
+- examples/irb.rb
+- examples/pry.rb
+- examples/rib.rb
+- examples/ripl.rb
 - lib/binding.repl.rb
-- lib/binding.repl/core_ext/binding.rb
-- lib/binding.repl/env.rb
-- lib/binding.repl/exit_value.rb
+- lib/binding.repl/exitvalue.rb
+- lib/binding.repl/mpatch/binding.rb
+- lib/binding.repl/repls/ir.rb
 - lib/binding.repl/repls/irb.rb
+- lib/binding.repl/repls/irb/irb.rb
 - lib/binding.repl/repls/pry.rb
 - lib/binding.repl/repls/rib.rb
 - lib/binding.repl/repls/ripl.rb
 - lib/binding.repl/version.rb
-homepage: https://github.com/robgleeson/binding.repl
+- test/binding_repl_auto_test.rb
+- test/binding_repl_irb_test.rb
+- test/binding_repl_rib_test.rb
+- test/binding_repl_ripl_test.rb
+- test/binding_repl_test.rb
+- test/binding_test.rb
+- test/setup.rb
+- test/support/mock.rb
+- test/support/repls.rb
+homepage: https://github.com/rpag/binding.repl
 licenses:
-- Public Domain
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -43,7 +62,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.2
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -54,5 +73,6 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: binding.repl is `binding.pry` but for every ruby repl.
+summary: '"binding.pry" for every ruby repl'
 test_files: []
+has_rdoc: 

data/LEGAL.txt

@@ -1,20 +0,0 @@
-This is free and unencumbered software released into the public domain.
-
-Anyone is free to copy, modify, publish, use, compile, sell, or
-distribute this software, either in source code form or as a compiled
-binary, for any purpose, commercial or non-commercial, and by any
-means.
-
-In jurisdictions that recognize copyright laws, the author or authors
-of this software dedicate any and all copyright interest in the
-software to the public domain.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
-OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
-
-For more information, please refer to <http://unlicense.org/>

data/doc/disableatruntime.md

@@ -1,23 +0,0 @@
-__ENABLE OR DISABLE AT RUNTIME__
-
-binding.repl can be enabled or disabled at runtime. <br>
-the default state is 'enabled'.
-
-__DISABLE__
-
-```ruby
-class Foo
-  BindingRepl.disable!
-  value = binding.repl.irb
-  p value.disabled? # => true
-end
-```
-
-__ENABLE__
-
-```ruby
-class Foo
-  BindingRepl.enable!
-  value = binding.repl.irb # opens irb on 'Foo'.
-end
-```

data/doc/exit_values.md

@@ -1,53 +0,0 @@
-__EXIT VALUES__
-
-a repl exit value is returned when `binding.repl.{irb,pry,ripl,rib,auto}` has <br>
-been called and the repl has exited through "exit".
-
-__IRB__
-
-for the IRB example I used a nested IRB session who passes an exit value back <br>
-through to a parent session:
-
-```
-irb(main):001:0> exit "hello world!"
-=> #<BindingRepl::ExitValue:0x007fb3124e6cc8 @object="hello world!">
-irb(main):002:0> method(:exit).owner
-=> IRB::ExtendCommandBundle
-```
-
-__pry__
-
-pry exits a session through a pry command called 'exit'. the difference between a <br>
-pry command and a ruby method is that a command is not mapped as a ruby method in <br>
-the active context. like IRB though, the exit command exists partially to allow a <br>
-value to be passed back to the caller:
-
-```
-[1] pry(main)> exit "Hello!"
-=> #<BindingRepl::ExitValue:0x007fd95d1f4670 @object="Hello!">
-[2] pry(main)>
-```
-
-__rib__
-
-'exit' inside rib resolves back to `Kernel#exit`. it wasn't immediately clear to me how <br>
-to send back a custom value with rib but for an example you can see how it works: <br>
-
-```
-main(0)>> binding.repl.rib
-main(1)>> exit
-=> #<BindingRepl::ExitValue:0x007faab19cc328 @object=#<Object:0x007faab1a16d60>>
-main(0)>> method(:exit).owner
-=> Kernel
-main(0)>>
-```
-
-__ripl__
-
-'ripl' is similar to rib. i couldn't figure out how to pass a value back to the caller <br>
-and 'exit' resolves to `Kernel#exit` like on rib: <br>
-
-```
->> exit
-=> #<BindingRepl::ExitValue:0x007faab2d2cee0 @object=nil>
-```

data/doc/runtimeoptions.md

@@ -1,46 +0,0 @@
-__RUNTIME OPTIONS__
-
-_pry_
-
-[pry](https://github.com/pry/pry) supports a large number of options for runtime configuration. <br>
-a full list of options are available at [Pry.start(…) (API Docs)](http://rubydoc.info/github/banister/pry/Pry#start-class_method)
-
-```ruby
-class Person
-  binding.repl.pry quiet: true
-end
-```
-
-_rib_
-
-[rib](https://github.com/godfat/rib) is a little less well known ruby repl that binding.repl supports since v0.8.0. <br>
-a full list of options are available at [Rib.anchor(…) (API Docs)](http://rdoc.info/github/godfat/rib/Rib/Anchor/Imp#anchor-instance_method)
-
-```ruby
-class Alien
-  binding.repl.rib prompt: ">> ", result_prompt: "# => "
-end
-```
-
-_ripl_
-
-[ripl](https://github.com/cldwalker/ripl) supports (some) runtime configuration. <br>
-I couldn't find API docs for `Ripl.start(..)`, so I recommend checking out the github
-page to learn more.
-
-```ruby
-class Sink
-  binding.repl.ripl riplrc: false
-end
-```
-
-_note about irb_
-
-binding.repl doesn't implement runtime options for IRB because it wasn't immediately obvious
-how IRB is configured at runtime (it looks like `IRB.conf` might be used)
-
-```ruby
-class Car
-  binding.repl.irb
-end
-```

data/doc/shellvariables.md

@@ -1,10 +0,0 @@
-__SHELL ENVIRONMENT VARIABLES__
-
-__$auto\_order__
-
-binding.repl can start the first available console through `binding.repl.auto` or the shortcut
-`binding.repl!`. the default lookup order can be changed by setting an environment variable:
-
-example
-
-    $ auto_order=pry,irb ruby myscript.rb

data/lib/binding.repl/env.rb

@@ -1,10 +0,0 @@
-module BindingRepl::ENV
-  @env = ::ENV
-  DELIMITER_REGEXP = /[:,]/
-
-  def auto_order
-    list = @env['auto_order'].to_s.split(DELIMITER_REGEXP)
-    list.empty? ? nil : list
-  end
-  module_function :auto_order
-end

data/lib/binding.repl/exit_value.rb

@@ -1,36 +0,0 @@
-class BindingRepl::ExitValue
-  STATUS_MAP = {
-    :disabled => :'binding.repl.disabled',
-    :unknown_console => :'binding.repl.unknown_console'
-  }
-
-  def self.load_error_value
-    STATUS_MAP[:unknown_console]
-  end
-
-  def self.disabled_value
-    STATUS_MAP[:disabled]
-  end
-
-  attr_reader :object
-
-  def initialize(object)
-    @object = object
-  end
-
-  def success?
-    not failure?
-  end
-
-  def failure?
-    load_error?
-  end
-
-  def disabled?
-    STATUS_MAP[:disabled] == object
-  end
-
-  def load_error?
-    STATUS_MAP[:unknown_console] == object
-  end
-end