binding.repl 0.8.0 → 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8c8ee86e2adcf420c60b05111ce45b43a00343b9
+  data.tar.gz: 117c6da32749481c1cd5436b5f5c43100904c2c7
+SHA512:
+  metadata.gz: 42a9a9d209908ea84a870c9a655d3227ab98725302f3fa799a37bd193cf980cfdac8f2391220b0f66df47be772a80aebe4802915b35ca7560154b4b3f06023fc
+  data.tar.gz: 993a7b4835312e617d3c9554e3217384fded40b6c048bf63a331d0f55fa20a52ad4cb283000c3081dcdd7badcde57961019a08caa4f3135eb01cac1a95416a20

data/.binding.repl.rc

@@ -1,3 +1,6 @@
-{
-  "auto_load_order": ["pry", "ripl", "irb"]
-}
+#
+# a sample of what $HOME/.binding.repl.rc might look like.
+# the default lookup order for `binding.repl.auto` can be defined in this file.
+#
+[auto]
+  order = ["irb", "rib", "pry", "ripl"]

data/.gitignore

@@ -7,7 +7,6 @@ Gemfile.lock
 InstalledFiles
 _yardoc
 coverage
-doc/
 lib/bundler/man
 pkg
 rdoc

data/.pryrc

@@ -1,2 +1,3 @@
 ENV["BINDING_REPL_RC"] = "0"
-require "./lib/binding.repl"
+require "bundler/setup"
+require "binding.repl"

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+  - rbx
+  - jruby-19mode
+
+notifications:
+  email: true

data/ChangeLog.txt

@@ -1,20 +1,73 @@
+== v0.9.0
+  - read $HOME/.binding.repl.rc as TOML instead of JSON
+  TOML is easy to read and write when compared with JSON. I don't think
+  humans like writing JSON too much :) you can get up to speed with TOML
+  at https://github.com/mojombo/toml.
+  closes GH #12.
+
+  - rename Binding.repl.auto_load_order as Binding.repl.auto_order.
+  closes GH #14.
+
+  - rename shell environment variable BINDING_REPL_ORDER as auto_order
+  less keys to press, no SHIFT key needed!
+  a little background on why I decided to try lowercase.
+  http://pubs.opengroup.org/onlinepubs/7908799/xbd/envvar.html
+  closes GH #15.
+
+  - rename shell environment variable BINDING_REPL_RC as disable_rc.
+  ditto.
+  closes GH #15.
+
+  - 1.9.2 support
+  use of `private_constant` broke binding.repl support on 1.9.2
+  decided to not try and workaround it.
+  BindingRepl::LOOKUP is no longer a private constant.
+
+  - define the default lookup order for `binding.repl.auto`.
+  defined by default as ["pry", "ripl", "rib", "irb"].
+
+  - relicense binding.repl under the public domain
+  interesting idea. see http://unlicense.org
+
+  - rewrite all the documentation in doc/
+  the documentation that covers shell environment variables, the rc file, runtime options
+  and how to enable or disable binding.repl at runtime has been rewritten and polished for
+  what I think is much better docs!
+
+  - add BindingRepl::ENV
+  a module on top of shell environment variables binding.repl understands.
+
+  - rename BindingRepl::RC as BindingRepl::RCFile.
+  most of the module was rewritten and cleaned up.
+
+  - raise a LoadError from `binding.repl.auto` when no consoles are available.
+  when BindingRepl.auto_order has been assigned an empty array and then `binding.repl.auto` is
+  called a LoadError will be raised. the old behavior was to return nil.
+
+  - raise a LoadError with a backtrace
+  if a console cannot be loaded a LoadError is raised with a backtrace.
+  before, there was no backtrace (not helpful).
+
+  - with 100% more tests.
+  binding.repl has never had a test suite. at every release I would do a manual test
+  process that is prone to error. I can't repeat my actions as well as a computer. in this release
+  binding.repl has a testcase for every class or module available.
+
+  the test suite is builton FakeFS(when testing the rcfile) and a mocking library(rspec-mocks) when
+  testing the execution of ruby consoles.
+
 == v0.8.0
   - add "rib" as a supported console.
   "rib" is inspired by ripl, the ripl-rc project, and by some of
   the ideas from the pry project.
 
-  be sure to check it out if you're curious:
+  if you're curious:
   * https://github.com/godfat/rib
 
-  'binding.repl.rib' to try it out!
-
-  - internals shakeup
-   when a console is added to binding.repl it also defines an
-   initializer that should be run for the very first time.
-
-   binding.repl takes care of the initializer not being run again,
-   but the initializer is expected to do whatever it needs to make
-   the console available for use.
+  - add auto management of initializers
+   when a console is added to binding.repl it also must define an
+   initializer that is run the very first time a console is invoked.
+   binding.repl takes care of the initializer not being run again.
 
    see lib/binding.repl/console/*.rb for examples.
 

data/Gemfile

@@ -1,8 +1,22 @@
 source 'https://rubygems.org'
 gemspec
 
-group :repls do
+group :development do
+  gem "rake"
+end
+
+group :test do
+  gem "rspec-mocks"
+end
+
+group :test, :repls do
   gem 'ripl'
   gem 'pry'
   gem 'rib'
+  gem "fakefs", require: "fakefs/safe"
 end
+
+platform :rbx do
+  gem "rubysl"
+  gem "rubysl-test-unit"
+end

data/README.md

@@ -1,31 +1,27 @@
 | Project         | binding.repl
 |:----------------|:--------------------------------------------------
-| Homepage        | https://github.com/robgleeson/binding.repl
-| Documentation   | http://rubydoc.info/github/robgleeson/binding.repl
-| Code Metrics    | [![Code Climate](https://codeclimate.com/github/robgleeson/binding.repl.png)](https://codeclimate.com/github/robgleeson/binding.repl)
-| CI              | [![Build Status](https://travis-ci.org/robgleeson/ichannel.binding.repl.png)](https://travis-ci.org/robgleeson/binding.repl)
-| Author          | Robert Gleeson
+| homepage        | https://github.com/robgleeson/binding.repl
+| build           | [![Build Status](https://travis-ci.org/robgleeson/binding.repl.png)](https://travis-ci.org/robgleeson/binding.repl)
 
 __DESCRIPTION__
 
 __binding.repl__ can start a number of different ruby consoles at runtime.
 IRB, ripl, rib, and pry(of course!) can be invoked at runtime in any context
-that an instance of `Binding` closes over.
+that an instance of `Binding` closes over. I owe credit to John Mair([banisterfiend](https://github.com/banister)),
+the creator of pry, for seeing the potential in a console that can be started at
+runtime and bound to the context of a `Binding` easily.
 
-I owe all credit to John Mair([banisterfiend](https://github.com/banister)),
-the creator of Pry, for seeing the potential in a console that can be
-started at runtime and bound to the context of a `Binding`. I don't
-think a single ruby console has put as much emphasize on a console
-that be invoked at runtime as Pry has.
+the interface to invoke pry at runtime has become known in a lot of circles and
+I thought it'd be cool to offer the same feature to other REPLs.
 
-the interface to invoke Pry at runtime is very accessible and easy to
-use but if you look at other ruby console implementations you might find
-the eval() of code is the same. It happens through `Binding#eval` which
-closes over a context(maybe the context is "Foo", a class, or an
-instance of "Foo").
+__FEATURES__
 
-__binding.repl__ provides the same `binding.pry` interface to all ruby
-consoles (if I missed one, open an issue or send an e-note :)).
+- `binding.pry` for all ruby consoles
+- start the consoles IRB, Pry, Ripl, or Rib at runtime
+- option to auto discover and start the first available console
+- enable or disable at runtime(a la Pry)
+- configurable via shell environment variables and an optional RC file in `$HOME`.
+- easily extended to support new consoles.
 
 __EXAMPLES__
 
@@ -35,136 +31,64 @@ _Rails_
 class BlogsController < ApplicationController
   def show
     @blog = Blog.find(params[:id])
-    binding.repl.{pry,irb,ripl,rib,auto}
+    binding.repl.{pry,irb,ripl,rib}
   end
 end
 ```
 
 _Auto discovery_
 
-```ruby
-class Bar
-  # auto discover and start the first available console.
-  # default order is: ripl, pry, rib, or irb.
-  binding.repl.auto
-
-  # change default load order
-  Binding.repl.auto_load_order = %w(pry ripl irb rib)
-
-  # remove "irb" & "rib" from auto discovery
-  Binding.repl.auto_load_order -= ["irb", "rib"]
-end
-```
-
-_Enable/disable at runtime_
-
-```ruby
-class Baz
-  # invoke irb
-  binding.repl.irb
-  Binding.repl.disable!
-
-  # no-op, returns :'binding.repl.disabled' and continues execution.
-  binding.repl.irb
-  binding.repl.ripl
-
-  # invoke pry
-  Binding.repl.enable!
-  binding.repl.pry
-end
-```
-
-__NOTES__
-
-_CONFIGURATION_
-
-ripl, rib, and pry can be customized by passing a set of key-value pairs but
-IRB isn't as straight forward to configure and I haven't implemented
-any customization options for it yet.
-
-ripl can be invoked with options that are forwarded to `Ripl.start(…)`:
-
-```ruby
-class Foo
-  binding.repl.ripl riplrc: false
-end
-```
-
-pry can be configured in the same way. options are forwarded to `Pry.start(…)`:
+the first available console can be loaded with `binding.repl.auto`. the default order
+is defined `["pry", "ripl", "rib", "irb"]` but it can be changed at runtime, through
+an RC file, and with shell environment variables.
 
 ```ruby
 class Foo
-  binding.repl.pry quiet: true
-end
-```
-
-rib is a little less well known ruby console that binding.repl
-supports since v0.8.0. I don't know much about the options it accepts,
-but it does accept some. please check out [its github page](https://github.com/godfat/rib)
-if you're curious.
+  # auto discover and start the first available console.
+  binding.repl.auto
 
-```ruby
-class Foo
-  binding.repl.rib({})
+  # change default load order of auto (pry first, etc..)
+  Binding.repl.auto_order = ["pry", "ripl", "irb"]
 end
 ```
 
-_WORKING WITH TEAMS_
+__DOCS__
 
-people working in teams might have different choices for what ruby
-console they like to use and __binding.repl__ tries to accomondate by
-reading a `.binding.repl.rc` file from $HOME or by setting a shell
-environment variable. `binding.repl.rc` is a simple JSON file.
+ - RCFILE <br>
+ configure the default order of `binding.repl.auto` with an RC file.
 
-let's say rob & amy are working on some code together. amy prefers
-ripl, so her `$HOME/.binding.repl.rc` would look like this:
-```javascript
-{
-  "auto_load_order": ["ripl", "irb"]
-}
-```
+ see [doc/rcfile.md](https://github.com/robgleeson/binding.repl/blob/master/doc/rcfile.md)
 
-rob prefers pry, so his `$HOME/.binding.repl.rc` would look like this:
-```ruby
-{
-  "auto_load_order": ["pry", "irb"]
-}
-```
+ - SHELL ENVIRONMENT VARIABLES <br>
+ temporarily disable the RC file or configure the default of order of `binding.repl.auto` with shell
+ envionment variables.
 
-when either rob or amy wants to start their favorite ruby console
-they can use `binding.repl.auto`:
+ see [doc/shellvariables.md](https://github.com/robgleeson/binding.repl/blob/master/doc/shellvariables.md)
 
-```ruby
-class Foo
-  # starts "irb" in the context of Foo for amy. fall back console is "irb".
-  # starts "pry" in the context of Foo for rob. fall back console is "irb".
-  binding.repl.auto
-end
-```
-
-_SHELL ENVIRONMENT VARIABLES_
+ - RUNTIME OPTIONS <br>
+ ripl, rib, and pry can be configured at runtime by passing a set of
+ key-value pairs but IRB isn't as straight forward to configure and I
+ haven't implemented any customization options for it yet.
 
-binding.repl can be configured with a couple of shell environment variables.
+ see [doc/runtimeoptions.md](https://github.com/robgleeson/binding.repl/blob/master/doc/runtimeoptions.md)
 
-```bash
-# disable trying to read $HOME/.binding.repl.rc
-export BINDING_REPL_RC=0
+ - ENABLE/DISABLE AT RUNTIME <br>
+ binding.repl can be enabled or disabled at runtime.
 
-# set the 'auto' load order
-# takes precendence over $HOME/.binding.repl.rc when set
-export BINDING_REPL_ORDER=pry,irb
-```
+ see [doc/disableatruntime.md](https://github.com/robgleeson/binding.repl/blob/master/doc/disableatruntime.md)
 
-_DEPENDENCIES_
+__DEPENDENCIES__
 
 binding.repl doesn't depend on anything. it's up to you to meet the
 dependencies(pry, irb, rib, and/or ripl). `binding.repl.{ripl,pry,rib,irb}`
 will try to load the appropiate console for you if it looks like it
 hasn't been loaded yet.
 
-__INSTALL__
+__PLATFORM SUPPORT__
 
-ruby 1.9+ only.
+should work on all 1.9+ ruby implementations. please open an issue if you find a bug!
+
+__INSTALL__
 
 ```
 gem install binding.repl
@@ -186,7 +110,8 @@ Rest of the Pry team(!!):
 
 __LICENSE__
 
-MIT.
+Public Domain. see UNLICENSE.txt.
+
 
 __CONTRIBUTING__
 

data/Rakefile

@@ -1 +1,16 @@
 require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList["test/*_test.rb"]
+  t.verbose = true
+end
+task :default => :test
+
+desc "run the examples in examples/*.rb"
+task :examples do
+  Dir["examples/*.rb"].each do |example|
+    sh "ruby %s" % [example]
+    puts
+  end
+end

data/UNLICENSE.txt

@@ -0,0 +1,24 @@
+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. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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/binding.repl.gemspec

@@ -1,14 +1,14 @@
 # coding: utf-8
-require "./lib/binding.repl"
+require "./lib/binding.repl/version"
 Gem::Specification.new do |spec|
   spec.name          = "binding.repl"
-  spec.version       = Binding.repl.version
+  spec.version       = BindingRepl.version
   spec.authors       = ["Robert Gleeson"]
   spec.email         = ["rob@flowof.info"]
   spec.description   = "binding.repl: binding.pry for all ruby consoles"
   spec.summary       = spec.description
   spec.homepage      = "https://github.com/robgleeson/binding.repl"
-  spec.license       = "MIT"
+  spec.license       = "Public Domain"
 
   spec.files         = `git ls-files`.split($/)
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
@@ -16,20 +16,18 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.required_ruby_version = ">= 1.9.2"
 
+  spec.add_runtime_dependency "toml", "~> 0.0.3"
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"
 
   spec.post_install_message = <<-INSTALL_MESSAGE
 
   ** binding.repl **
-  Thanks for installing v#{Binding.repl.version}!
-  Check out the README and ChangeLog to see what's new in this release.
-
-  README.md
-  https://github.com/robgleeson/binding.repl/blob/v#{Binding.repl.version}/README.md
+  Thanks for installing v#{BindingRepl.version}!
+  Check out ChangeLog.txt to read about what's changed.
 
   ChangeLog.txt
-  https://github.com/robgleeson/binding.repl/blob/v#{Binding.repl.version}/ChangeLog.txt
+  https://github.com/robgleeson/binding.repl/blob/v#{BindingRepl.version}/ChangeLog.txt
 
   INSTALL_MESSAGE
 end

data/doc/disableatruntime.md

@@ -0,0 +1,20 @@
+__ENABLE/DISABLE AT RUNTIME__
+
+binding.repl can be enabled or disabled at runtime. by default, it is enabled.
+to disable, you'd write something like:
+
+```ruby
+class Foo
+  Binding.repl.disable!
+  binding.repl.irb # does nothing. execution continues.
+end
+```
+
+it can be re-enabled just as easily:
+
+```ruby
+class Foo
+  Binding.repl.enable!
+  binding.repl.irb # opens an IRB session inside class 'Foo'
+end
+```

data/doc/rcfile.md

@@ -0,0 +1,20 @@
+__RCFILE__
+
+binding.repl reads a configuration file from `$HOME/.binding.repl.rc`.
+the configuration file is written in a human readable and writable
+language called [toml](https://github.com/mojombo/toml).
+
+at the moment the only configuration option is to define the order that
+`binding.repl.auto` will use to look for ruby consoles. the example sets
+up pry to be the first preference, then ripl, then rib, and finally irb.
+
+```toml
+[auto]
+  order = ["pry", "ripl", "rib", "irb"]
+```
+
+__DISABLE OR OVERRIDE__
+
+the RC file is optional. if it doesn't exist that's cool.
+it can be temporarily disabled and overriden by setting [shell environment variables](https://github.com/robgleeson/binding.repl/blob/master/doc/shellvariables.md)
+when it does exist.

data/doc/runtimeoptions.md

@@ -0,0 +1,42 @@
+__RUNTIME OPTIONS__
+
+__pry__
+
+pry can be started with options that are forwarded to [Pry.start(…)](http://rubydoc.info/github/banister/pry/Pry#start-class_method) (API docs).
+
+```ruby
+class Foo
+  binding.repl.pry quiet: true
+end
+```
+
+__ripl__
+
+ripl can be started with options that are forwarded to `Ripl.start(…)`.
+unfortunately, `Ripl.start(…)` has no API documentation.
+check out [its github page](https://github.com/cldwalker/ripl) for more information.
+
+```ruby
+class Foo
+  binding.repl.ripl riplrc: false
+end
+```
+
+__rib__
+
+[rib](https://github.com/godfat/rib) is a little less well known ruby console that binding.repl
+supports since v0.8.0. it can be configured to change the prompt and the prefix inserted before
+a return value.
+
+rib can be started with options that are forwarded to
+[Rib.anchor(…)](http://rdoc.info/github/godfat/rib/Rib/Anchor/Imp#anchor-instance_method) (API docs).
+
+```ruby
+class Foo
+  binding.repl.rib prompt: ">> ", result_prompt: "# => "
+end
+```
+
+__irb__
+
+binding.repl doesn't implement any runtime options for IRB.

data/doc/shellvariables.md

@@ -0,0 +1,21 @@
+__SHELL ENVIRONMENT VARIABLES__
+
+__$auto\_order__
+
+binding.repl can start the first available console through `binding.repl.auto`. the lookup order
+can be defined in an RC file or with an environment variable. the environment variable is simply
+named `auto_order` and takes precendece over an RC file when defined. values can be separated by
+a comma(`,`) or a colon(`:`).
+
+example
+
+    $ auto_order=pry,irb ruby myscript.rb
+
+__$disable\_rc__
+
+the `disable_rc` environment variable can be set to '1' or 'true' to disable or abort the load
+of `$HOME/.binding.repl.rc`.
+
+example
+
+    $ disable_rc=1 ruby myscript.rb

data/lib/binding.repl.rb

@@ -1,39 +1,58 @@
 class BindingRepl
-  module BindingMixin
-    def repl
-      Binding.repl.new(self)
-    end
-  end
-
   LOOKUP = {}
   LOOKUP.default = [proc { true }, proc { :'binding.repl.unknown_console' }]
-  private_constant :LOOKUP
+  singleton_class.class_eval { attr_accessor :auto_order }
 
   def self.name
     "binding.repl"
   end
 
-  def self.inspect
+  def self.to_s
     name
   end
 
-  def self.version
-    "0.8.0"
-  end
-
+  #
+  # returns when binding.repl is disabled.
+  #
+  # @return [Boolean]
+  #
   def self.disabled?
     @disabled
   end
 
+  #
+  # enable binding.repl (enabled by default)
+  #
+  # @return [true]
+  #
   def self.enable!
     @disabled = false
     !@disabled
   end
 
+  #
+  # disable binding.repl
+  # future calls to `binding.repl.{auto,pry,rib,ripl}` become a no-op.
+  #
+  # @return [true]
+  #
   def self.disable!
     @disabled = true
   end
 
+  #
+  # @param [Symbol] console
+  #   the name of a console. available as `binding.repl.<console>`.
+  #
+  # @param [Proc] initializer
+  #   a Proc that is called on the very first call of `binding.repl.<console>`.
+  #
+  # @param [Proc] runner
+  #   a Proc that is expected to start a repl.
+  #   the Proc is passed a `Binding` and a Hash of options.
+  #
+  # @return [void]
+  #
   def self.add(console, initializer, runner)
     LOOKUP[console] = [initializer, runner]
     define_method(console) do |options = {}|
@@ -42,33 +61,27 @@ class BindingRepl
     end
   end
 
-  def self.auto_load_order=(order)
-    @auto_load_order = order
-  end
-
-  def self.auto_load_order
-    @auto_load_order
-  end
-
   def initialize(binding)
     @binding = binding
     @lookup = LOOKUP
   end
 
   def auto
-    load_order, exit_value = Binding.repl.auto_load_order, nil
+    load_order, exit_value = Binding.repl.auto_order, nil
     load_order.each do |console|
       exit_value = invoke_console(console.to_sym, {})
       return exit_value unless invoke_failed?(exit_value)
     end
-    if invoke_failed?(exit_value)
-      raise LoadError, "failed to load consoles: #{load_order.join(", ")}", []
+    if load_order.empty?
+      raise LoadError, "no consoles found in Binding.repl.auto_order (empty)"
+    elsif invoke_failed?(exit_value)
+      raise LoadError, "no loadable consoles found (searched for #{load_order.join(', ')})"
     end
   end
 
 private
   def fail!(console)
-    raise LoadError, "the console '#{console}' could not be loaded. is #{console} installed?", []
+    raise LoadError, "the console '#{console}' could not be loaded :("
   end
 
   def invoke_failed?(exit_value)
@@ -88,16 +101,14 @@ private
     :'binding.repl.load_error'
   end
 end
-
-klass = BindingRepl
-Object.send :remove_const, :BindingRepl
-Binding.class_eval do
-  define_singleton_method(:repl) { klass }
-  include klass::BindingMixin
-  repl.auto_load_order = %w(ripl pry irb)
-end
+require_relative "binding.repl/core_ext/binding"
+require_relative "binding.repl/env"
+require_relative "binding.repl/rcfile"
+require_relative "binding.repl/version"
 require_relative "binding.repl/console/pry"
 require_relative "binding.repl/console/irb"
 require_relative "binding.repl/console/ripl"
 require_relative "binding.repl/console/rib"
-require_relative "binding.repl/rc"
+
+BindingRepl::RCFile.load
+BindingRepl.auto_order = BindingRepl::ENV.auto_order

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

@@ -2,7 +2,6 @@ initializer = lambda do
   require "irb"
   IRB.setup(nil)
 end
-
 runner = lambda do |binding, options|
   irb = IRB::Irb.new IRB::WorkSpace.new(binding)
   IRB.conf[:MAIN_CONTEXT] = irb.context

data/lib/binding.repl/core_ext/binding.rb

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

data/lib/binding.repl/env.rb

@@ -0,0 +1,18 @@
+module BindingRepl::ENV
+  @env = ::ENV
+  DEFAULT_AUTO_ORDER = ["pry", "ripl", "rib", "irb"]
+
+  module_function
+  def enable_rc_file?
+    @env['disable_rc'] != 'true' and @env['disable_rc'] != '1'
+  end
+
+  def disable_rc_file?
+    !enable_rc_file?
+  end
+
+  def auto_order
+    env_order = @env['auto_order'].to_s.split /[:,]/
+    env_order.empty? ? DEFAULT_AUTO_ORDER : env_order
+  end
+end

data/lib/binding.repl/rcfile.rb

@@ -0,0 +1,20 @@
+require "toml"
+module BindingRepl::RCFile
+  module_function
+  def path
+    File.join ENV["HOME"], ".binding.repl.rc"
+  end
+
+  def enabled?
+    BindingRepl::ENV.enable_rc_file?
+  end
+
+  def load
+    return nil unless enabled? and File.readable?(path)
+    content = File.read(path)
+    parsed = TOML::Parser.new(content).parsed
+    Binding.repl.auto_order = parsed["auto"]["order"]
+  rescue StandardError => e
+    warn "binding.repl: '#{path}' read failed."
+  end
+end

data/lib/binding.repl/version.rb

@@ -0,0 +1,7 @@
+class BindingRepl
+  VERSION = "0.9.0".freeze
+
+  def self.version
+    VERSION
+  end
+end

data/test/binding_repl_auto_test.rb

@@ -0,0 +1,37 @@
+require_relative "setup"
+class BindingReplAutoTest < Test::Unit::TestCase
+  include BindingRepl::Mock
+  def setup
+    @before = BindingRepl.auto_order
+    super
+  end
+
+  def teardown
+    BindingRepl.auto_order = @before
+    super
+  end
+
+  def test_pry_as_first_match_on_auto
+    BindingRepl.auto_order = ["pry", "irb"]
+    expect(Pry).to receive(:start).with(instance_of(Binding), {})
+    binding.repl.auto
+  end
+
+  def test_ripl_as_second_match_on_auto
+    BindingRepl.auto_order = ["blah", "ripl"]
+    expect(Ripl).to receive(:start).with(binding: instance_of(Binding))
+    binding.repl.auto
+  end
+
+  def test_no_matches_on_auto
+    BindingRepl.auto_order = []
+    e = assert_raise(LoadError) {binding.repl.auto}
+    assert_equal "no consoles found in Binding.repl.auto_order (empty)", e.message
+  end
+
+  def test_no_requireable_console_on_auto
+    BindingRepl.auto_order = ["ry", "burp", "orc"]
+    e = assert_raise(LoadError) {binding.repl.auto}
+    assert_equal "no loadable consoles found (searched for ry, burp, orc)", e.message
+  end
+end

data/test/binding_repl_env_test.rb

@@ -0,0 +1,30 @@
+require_relative "setup"
+class BindingReplEnvTest < Test::Unit::TestCase
+  def teardown
+    ENV.delete "disable_rc"
+    ENV.delete "auto_order"
+  end
+
+  def test_default_of_enable_rc_file?
+    assert_equal true, BindingRepl::ENV.enable_rc_file?
+  end
+
+  def test_disable_of_rc_file_with_true
+    ENV["disable_rc"] = 'true'
+    assert_equal false, BindingRepl::ENV.enable_rc_file?
+  end
+
+  def test_disable_of_rc_file_with_one
+    ENV["disable_rc"] = '1'
+    assert_equal false, BindingRepl::ENV.enable_rc_file?
+  end
+
+  def test_default_of_auto_order
+    assert_equal BindingRepl::ENV::DEFAULT_AUTO_ORDER, BindingRepl.auto_order
+  end
+
+  def test_auto_order_defined_by_shell
+    ENV["auto_order"] = 'irb,ripl'
+    assert_equal ["irb", "ripl"], BindingRepl::ENV.auto_order
+  end
+end

data/test/binding_repl_irb_test.rb

@@ -0,0 +1,9 @@
+require_relative "setup"
+require "irb"
+class BindingReplIrbTest < Test::Unit::TestCase
+  include BindingRepl::Mock
+  def test_irb
+    expect_any_instance_of(::IRB::Irb).to receive(:eval_input)
+    binding.repl.irb
+  end
+end

data/test/binding_repl_pry_test.rb

@@ -0,0 +1,13 @@
+require_relative "setup"
+class BindingReplPryTest < Test::Unit::TestCase
+  include BindingRepl::Mock
+  def test_pry
+    expect(Pry).to receive(:start).with(instance_of(Binding), {})
+    binding.repl.pry
+  end
+
+  def test_pry_with_options
+    expect(Pry).to receive(:start).with(instance_of(Binding), {quiet: true})
+    binding.repl.pry quiet: true
+  end
+end

data/test/binding_repl_rcfile_test.rb

@@ -0,0 +1,32 @@
+require_relative "setup"
+testcase = if defined?(Rubinius)
+  # skip Rubinius (breaks with FakeFS).
+  Object
+else
+  Test::Unit::TestCase
+end
+
+class BindingReplRCFileTest < testcase
+  DIR = File.dirname BindingRepl::RCFile.path
+  FILENAME = File.basename BindingRepl::RCFile.path
+
+  def setup
+    FakeFS.activate!
+    dir = FakeFS::FileSystem.add DIR
+    file = FakeFS::FakeFile.new FILENAME, dir
+    file.content = <<-RCFILE
+      [auto]
+        order = ["fakerepl", "irb"]
+    RCFILE
+    dir[file.name] = file
+  end
+
+  def teardown
+    FakeFS.deactivate!
+  end
+
+  def test_auto_order_defined_by_rc_file
+    BindingRepl::RCFile.load
+    assert_equal ["fakerepl", "irb"], BindingRepl.auto_order
+  end
+end

data/test/binding_repl_rib_test.rb

@@ -0,0 +1,13 @@
+require_relative "setup"
+class BindingReplRibTest < Test::Unit::TestCase
+  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 < Test::Unit::TestCase
+  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/setup.rb

@@ -0,0 +1,4 @@
+require "bundler"
+require "test/unit"
+Bundler.require :default, :test
+require_relative "support/binding.repl/mock"

data/test/support/binding.repl/mock.rb

@@ -0,0 +1,14 @@
+module BindingRepl::Mock
+  include RSpec::Mocks::ExampleMethods
+
+  def setup
+    RSpec::Mocks.setup(Object)
+    RSpec::Mocks.setup(self)
+  end
+
+  def teardown
+    RSpec::Mocks.verify
+  ensure
+    RSpec::Mocks.teardown
+  end
+end

metadata

@@ -1,99 +1,136 @@
 --- !ruby/object:Gem::Specification
 name: binding.repl
 version: !ruby/object:Gem::Version
-  version: 0.8.0
-  prerelease: 
+  version: 0.9.0
 platform: ruby
 authors:
 - Robert Gleeson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-13 00:00:00.000000000 Z
+date: 2014-01-05 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: toml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.3
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: ! 'binding.repl: binding.pry for all ruby consoles'
+description: 'binding.repl: binding.pry for all ruby consoles'
 email:
 - rob@flowof.info
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .binding.repl.rc
-- .gitignore
-- .pryrc
+- ".binding.repl.rc"
+- ".gitignore"
+- ".pryrc"
+- ".travis.yml"
 - ChangeLog.txt
 - Gemfile
-- LICENSE.txt
 - README.md
 - Rakefile
+- UNLICENSE.txt
 - binding.repl.gemspec
+- doc/disableatruntime.md
+- doc/rcfile.md
+- doc/runtimeoptions.md
+- doc/shellvariables.md
 - lib/binding.repl.rb
 - lib/binding.repl/console/irb.rb
 - lib/binding.repl/console/pry.rb
 - lib/binding.repl/console/rib.rb
 - lib/binding.repl/console/ripl.rb
-- lib/binding.repl/rc.rb
+- lib/binding.repl/core_ext/binding.rb
+- lib/binding.repl/env.rb
+- lib/binding.repl/rcfile.rb
+- lib/binding.repl/version.rb
+- test/binding_repl_auto_test.rb
+- test/binding_repl_env_test.rb
+- test/binding_repl_irb_test.rb
+- test/binding_repl_pry_test.rb
+- test/binding_repl_rcfile_test.rb
+- test/binding_repl_rib_test.rb
+- test/binding_repl_ripl_test.rb
+- test/setup.rb
+- test/support/binding.repl/mock.rb
 homepage: https://github.com/robgleeson/binding.repl
 licenses:
-- MIT
-post_install_message: ! "\n  ** binding.repl **\n  Thanks for installing v0.8.0!\n
-  \ Check out the README and ChangeLog to see what's new in this release.\n\n  README.md\n
-  \ https://github.com/robgleeson/binding.repl/blob/v0.8.0/README.md\n\n  ChangeLog.txt\n
-  \ https://github.com/robgleeson/binding.repl/blob/v0.8.0/ChangeLog.txt\n\n"
+- Public Domain
+metadata: {}
+post_install_message: |2+
+
+    ** binding.repl **
+    Thanks for installing v0.9.0!
+    Check out ChangeLog.txt to read about what's changed.
+
+    ChangeLog.txt
+    https://github.com/robgleeson/binding.repl/blob/v0.9.0/ChangeLog.txt
+
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 1.9.2
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 4383143691404002571
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.2.0
 signing_key: 
-specification_version: 3
-summary: ! 'binding.repl: binding.pry for all ruby consoles'
-test_files: []
+specification_version: 4
+summary: 'binding.repl: binding.pry for all ruby consoles'
+test_files:
+- test/binding_repl_auto_test.rb
+- test/binding_repl_env_test.rb
+- test/binding_repl_irb_test.rb
+- test/binding_repl_pry_test.rb
+- test/binding_repl_rcfile_test.rb
+- test/binding_repl_rib_test.rb
+- test/binding_repl_ripl_test.rb
+- test/setup.rb
+- test/support/binding.repl/mock.rb
+has_rdoc: 

data/LICENSE.txt

@@ -1,22 +0,0 @@
-Copyright (c) 2013 Robert Gleeson
-
-MIT License
-
-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/lib/binding.repl/rc.rb

@@ -1,24 +0,0 @@
-module Binding.repl::RC
-  module_function
-  def home_rc
-    File.join ENV["HOME"], ".binding.repl.rc"
-  end
-
-  def safe_load
-    if File.readable?(home_rc)
-      blob = File.read(home_rc)
-      rc = JSON.parse File.read(home_rc)
-      Binding.repl.auto_load_order = rc["auto_load_order"]
-    end
-  rescue StandardError => e
-    warn "binding.repl: '#{home_rc}' read failed (#{e.class}): #{e.message}"
-  end
-end
-
-if ENV["BINDING_REPL_ORDER"].nil? && ENV["BINDING_REPL_RC"] != "0"
-  require "json"
-  Binding.repl::RC.safe_load
-end
-if ENV.has_key?("BINDING_REPL_ORDER")
-  Binding.repl.auto_load_order = ENV["BINDING_REPL_ORDER"].split /[:,]/
-end