hairballs 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4d0f86e9c3d02f22b832c4b3edce907001d0db2f
-  data.tar.gz: 7ddc281fd14c1d9c673b59bd6ca1f218e1722f2a
+  metadata.gz: d253d151df5fdf784c216a8785627d1f0881cb01
+  data.tar.gz: 45bce4a52cd3d2e01f48a3765b9fef39fffb36bc
 SHA512:
-  metadata.gz: 0ed4bf7812d457c37d006c4b6b065a6a05df37aba2991f77fa261aa2939bc51ef1df35a55d861a75b5fc93ffe556d4a102a618f99f84dc4126a174679fa4311b
-  data.tar.gz: 11bf1690a4fd0c528223c4608bbc757a17720f64dfdc137ffe58abae6e505499c790e32c711203f2d768fabfe09900b6c0f6b9872dbb5da9539e50164f211c53
+  metadata.gz: 0ca0f9c162b224b218184fd8afd15731ed52d220ff24032e75896cca7ed3bae272e6da15016f2556cbdcf7ec251e0dddbc01361b5dfd2f6fe1db076dadf1d3ff
+  data.tar.gz: baff3f4a22ebfe513bba046a54486bf67da351bee1b8ea7f4365a7a21d9ef7e7f8c63f74775cb0c109b756fce5d28aae93389e368647dee838bb8e00fe38e8a1

data/History.md

@@ -1,3 +1,14 @@
+### 0.1.0 / 2015-02-18
+
+* Improvements
+    * Added `Hairballs.project_root`, which tries to determine the root
+      directory for the project you're working in.
+    * Refactored configuration to Hairballs::Configuration.
+* Bug Fixes
+    * Fixed nested file completion for the `tab_completion_for_files` plugin.
+    * Fixed `Hairballs::LibraryHelpers#find_latest_gem` to find the latest
+      instead of the earliest.
+
 ### 0.0.1 / 2014-12-19
 
 * Happy Birthday!

data/README.md

@@ -105,10 +105,10 @@ end
 ```ruby
 # hairballs/themes/turboladen_rails.rb
 Hairballs.add_theme(:turboladen_rails) do |theme|
-  theme.libraries do
-    libs_to_require = %w(irb/completion looksee wirble awesome_print)
+  theme.libraries do |libs|
+    libs += %w(irb/completion looksee wirble awesome_print)
 
-    libs_to_require +
+    libs +=
       case RUBY_PLATFORM
       when /mswin32|mingw32/
         %w(win32console)

data/hairballs.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Steve Loveless']
   spec.email         = ['steve.loveless@gmail.com']
   spec.summary       = 'Like oh-my-zsh, but for IRB.'
-  spec.description   = 'Some tools for making customizing your IRB sessions a little easier.'
+  spec.description   = spec.summary
   spec.homepage      = 'https://github.com/turboladen/hairballs'
   spec.license       = 'MIT'
 

data/lib/hairballs/configuration.rb

@@ -0,0 +1,170 @@
+require 'open3'
+require 'pathname'
+require 'ostruct'
+require 'hairballs/ext/kernel_vputs'
+require 'hairballs/exceptions'
+require 'hairballs/theme'
+require 'hairballs/plugin'
+require 'hairballs/version'
+
+class Hairballs
+  class Configuration
+    # @return [Array<Hairballs::Theme>]
+    attr_reader :themes
+
+    # @return [Hairballs::Theme]
+    attr_reader :current_theme
+
+    # All Hairballs::Plugins available to be loaded.
+    #
+    # @return [Array<Hairballs::Plugin>]
+    attr_reader :plugins
+
+    # All Hairballs::Plugins that have been loaded.
+    #
+    # @return [Array<Hairballs::Plugin>]
+    attr_reader :loaded_plugins
+
+    # Used for maintaining all possible completion Procs, thus allowing many
+    # different plugins to define a Proc for completion without overriding Procs
+    # defined for other plugins.
+    #
+    # @return [Array<Proc>]
+    attr_reader :completion_procs
+
+    # @return [String]
+    attr_reader :project_name
+
+    # @return [String]
+    attr_reader :project_root
+
+    def initialize
+      @themes = []
+      @current_theme = nil
+      @plugins = []
+      @loaded_plugins = []
+      @completion_procs = []
+      @project_name = nil
+      @project_root = nil
+    end
+
+    # @return [String]
+    def version
+      Hairballs::VERSION
+    end
+
+    # Is IRB getting loaded for a rails console?
+    #
+    # @return [Boolean]
+    def rails?
+      ENV.has_key?('RAILS_ENV') || !!defined?(Rails)
+    end
+
+    # Name of the relative directory.
+    #
+    # @return [String]
+    def project_name
+      @project_name ||= File.basename(project_root)
+    end
+
+    def project_root
+      @project_root ||= find_project_root
+    end
+
+    def project_root?(path)
+      File.expand_path(path) == project_root
+    end
+
+    # Builds a new Hairballs::Theme and adds it to the list of `.themes` that
+    # can be used.
+    #
+    # @param [Symbol] name Name to give the new Theme.
+    # @return [Theme]
+    def add_theme(name)
+      theme = Theme.new(name)
+
+      yield theme
+
+      themes << theme
+      vputs "Added theme: #{name}"
+
+      theme
+    end
+
+    # Tells IRB to use the Hairballs::Theme of +theme_name+.
+    #
+    # @param [Symbol] theme_name The name of the Theme to use/switch to.
+    def use_theme(theme_name)
+      switch_to = themes.find { |theme| theme.name == theme_name }
+      fail ThemeUseFailure.new(theme_name) unless switch_to
+      vputs "Switched to theme: #{theme_name}"
+
+      switch_to.use!
+      @current_theme = switch_to
+
+      true
+    end
+
+    # Builds a new Hairballs::Plugin and adds it to thelist of `.plugins` that
+    # can be used.
+    #
+    # @param [Symbol] name
+    # @param [Hash] options Plugin-dependent options to define.  These get
+    #   passed along the the Hairballs::Plugin object and are used as attributes
+    #   of the plugin.
+    def add_plugin(name, **options)
+      plugin = Plugin.new(name, options)
+      yield plugin
+      plugins << plugin
+      vputs "Added plugin: #{name}"
+
+      plugin
+    end
+
+    # Searches for the Hairballs::Plugin by the +plugin_name+, then loads it.
+    # Raises
+    # @param plugin_name [Symbol]
+    def load_plugin(plugin_name, **options)
+      plugin_to_use = plugins.find { |plugin| plugin.name == plugin_name }
+      fail PluginNotFound.new(plugin_name) unless plugin_to_use
+      vputs "Using plugin: #{plugin_name}"
+
+      plugin_to_use.load!(options)
+      loaded_plugins << plugin_to_use
+
+      true
+    end
+
+    private
+
+    def find_project_root
+      if rails?
+        ::Rails.root
+      else
+        root_by_git || root_by_lib_dir
+      end
+    end
+
+    def root_by_git
+      _stdin, stdout, _stderr = Open3.popen3('git rev-parse --show-toplevel')
+
+      stdout.gets.strip
+    end
+
+    def root_by_lib_dir
+      cwd = Pathname.new(Dir.pwd)
+      root = nil
+
+      cwd.ascend do |dir|
+        lib_dir = File.join(dir.to_s, 'lib')
+
+        if dir.children.find { |c| c.to_s =~ /#{lib_dir}/ && File.exist?(lib_dir) }
+          root = dir.to_s
+          break
+        end
+      end
+
+      root
+    end
+  end
+end

data/lib/hairballs/library_helpers.rb

@@ -1,3 +1,5 @@
+require 'hairballs/ext/kernel_vputs'
+
 class Hairballs
   # Helpers specifying and requiring dependencies for Themes and Plugins.
   module LibraryHelpers
@@ -5,14 +7,11 @@ class Hairballs
     def libraries(libs=nil)
       return @libraries if @libraries && libs.nil?
 
-      @libraries = block_given? ? yield : libs
-
-      unless @libraries.is_a?(Array)
-        fail ArgumentError,
-          "Block must return an Array but returned #{@libraries}."
+      @libraries = if libs
+        libs
+      else
+        yield([])
       end
-
-      @libraries
     end
 
     # Requires #libraries on load.  If they're not installed, install them.  If
@@ -43,10 +42,14 @@ class Hairballs
       end
     end
 
+    # Path to the highest version of the gem with the given gem.
+    #
+    # @param [String] gem_name
+    # @return [String]
     def find_latest_gem(gem_name)
       the_gem = Dir.glob("#{Gem.dir}/gems/#{gem_name}-*")
 
-      the_gem.empty? ? nil : the_gem.first
+      the_gem.empty? ? nil : the_gem.sort.last
     end
 
     # Add all gems in the global gemset to the $LOAD_PATH so they can be used

data/lib/hairballs/plugin.rb

@@ -1,4 +1,5 @@
-require_relative 'library_helpers'
+require 'hairballs/exceptions'
+require 'hairballs/library_helpers'
 
 class Hairballs
   # Plugins provide means for adding functionality to your IRB sessions.  They
@@ -63,12 +64,12 @@ class Hairballs
 
       require_libraries
 
-      if @on_load
-        if @on_load.kind_of?(Proc)
-          @on_load.call
-        else
-          fail PluginLoadFailure, self.name
-        end
+      return unless @on_load
+
+      if @on_load.kind_of?(Proc)
+        @on_load.call
+      else
+        fail PluginLoadFailure, self.name
       end
     end
   end

data/lib/hairballs/plugins/awesome_print.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 Hairballs.add_plugin(:awesome_print) do |plugin|
   plugin.libraries %w(awesome_print)

data/lib/hairballs/plugins/colorize_json.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 # When any value is returned by evaluating some Ruby, this will check if it is
 # JSON (by parsing it).  If it's JSON-like, it will get formatted prettily and

data/lib/hairballs/plugins/interesting_methods.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 # Returns only the methods not present on basic Objects.
 #

data/lib/hairballs/plugins/irb_history.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 Hairballs.add_plugin(:irb_history, save_history: 1000, eval_history: 20, global_history_file: true) do |plugin|
   plugin.libraries %w(irb/ext/save-history)

data/lib/hairballs/plugins/object_ri.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 # Directly lifted from rbates/dotfiles!  Adds +#ri+ to all Objects, letting you
 # get ri docs from within your IRB session.

data/lib/hairballs/plugins/quick_benchmark.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 # Quick and dirty benchmarking of whatever block you pass to the method.
 #

data/lib/hairballs/plugins/require_project_lib.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 # Adds the Object#require_project_lib method as a shortcut for
 #

data/lib/hairballs/plugins/tab_completion_for_files.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 # Adds the ability to tab-complete files that are in the current directory.
 #
@@ -9,10 +9,13 @@ require_relative '../../hairballs'
 #     # Will complete like this...
 #     irb> File.read("README.md"
 #
-Hairballs.add_plugin(:tab_completion_for_files) do |plugin|
+# The +completion_append_character+ is really a Readline option that tells it
+# what to do when you tab-complete a term. It's set to not add anything to the
+# completed term, but you may find it suits you better to append a single space.
+Hairballs.add_plugin(:tab_completion_for_files, completion_append_character: nil) do |plugin|
   plugin.on_load do
     Hairballs.completion_procs << proc do |string|
-      Dir['*'].grep(/^#{Regexp.escape(string)}*/)
+      Dir[string + '*'].grep(/^#{Regexp.escape(string)}/)
     end
 
     if defined? ::IRB::InputCompletor::CompletionProc
@@ -25,11 +28,12 @@ Hairballs.add_plugin(:tab_completion_for_files) do |plugin|
       end.flatten.uniq
     end
 
-    if Readline.respond_to?('basic_word_break_characters=')
-      Readline.basic_word_break_characters= " \"'\t\n`><=;|&{("
+    if Readline.respond_to?(:basic_word_break_characters=)
+      original_breaks = Readline.basic_word_break_characters
+      Readline.basic_word_break_characters = " \"'#{original_breaks}"
     end
 
-    Readline.completion_append_character = nil
+    Readline.completion_append_character = plugin.completion_append_character
     Readline.completion_proc = completion_proc
   end
 end

data/lib/hairballs/plugins/wirble.rb

@@ -1,4 +1,4 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 # Just loads Wirble.
 Hairballs.add_plugin(:wirble) do |plugin|

data/lib/hairballs/theme.rb

@@ -1,5 +1,5 @@
-require_relative 'library_helpers'
-require_relative 'prompt'
+require 'hairballs/library_helpers'
+require 'hairballs/prompt'
 
 class Hairballs
   # Themes primarily provide a means for customizing the look of your IRB
@@ -10,7 +10,7 @@ class Hairballs
   # +Hairballs.add_theme()+ and +Hairballs.use_theme()+ should cover most use
   # cases.
   class Theme
-    include LibraryHelpers
+    include Hairballs::LibraryHelpers
 
     # Just an identifier for the Theme.  Don't name two themes the same
     # name--that will cause problems.
@@ -97,7 +97,6 @@ class Hairballs
     end
 
     def set_up_pry_printer
-      puts "@pompt return format: #{@prompt.return_format}"
       if @prompt.return_format
         Pry.config.print = proc do |output, value|
           output.printf @prompt.return_format, value.inspect

data/lib/hairballs/themes/turboladen.rb

@@ -1,14 +1,14 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 Hairballs.add_theme(:turboladen) do |theme|
-  theme.libraries do
-    libs_to_require = %w(
+  theme.libraries do |libs_to_require|
+    libs_to_require += %w(
       irb/completion
       looksee
       colorize
     )
 
-    libs_to_require +
+    libs_to_require +=
       case RUBY_PLATFORM
       when /mswin32|mingw32/
         %w(win32console)

data/lib/hairballs/themes/turboladen_rails.rb

@@ -1,14 +1,14 @@
-require_relative '../../hairballs'
+require 'hairballs'
 
 Hairballs.add_theme(:turboladen_rails) do |theme|
-  theme.libraries do
-    libs_to_require = %w(
+  theme.libraries do |libs_to_require|
+    libs_to_require += %w(
       irb/completion
       looksee
       colorize
     )
 
-    libs_to_require +
+    libs_to_require +=
       case RUBY_PLATFORM
       when /mswin32|mingw32/
         %w(win32console)

data/lib/hairballs/version.rb

@@ -1,3 +1,3 @@
 class Hairballs
-  VERSION = '0.0.1'
+  VERSION = '0.1.0'
 end

data/lib/hairballs.rb

@@ -1,113 +1,33 @@
-require_relative 'hairballs/ext/kernel_vputs'
-require_relative 'hairballs/exceptions'
-require_relative 'hairballs/theme'
-require_relative 'hairballs/plugin'
-require_relative 'hairballs/version'
+require 'forwardable'
+require 'hairballs/version'
+require 'hairballs/configuration'
 
 # Home of the Hairballs DSL for defining and using Themes and Plugins.
 class Hairballs
-  class << self
-    # @return [Hairballs::Theme]
-    attr_reader :current_theme
-
-    # @return [Array<Hairballs::Theme>]
-    def themes
-      @themes ||= []
-    end
-
-    # Builds a new Hairballs::Theme and adds it to the list of `.themes` that
-    # can be used.
-    #
-    # @param name [Symbol] Name to give the new Theme.
-    # @return [Theme]
-    def add_theme(name)
-      theme = Theme.new(name)
-      yield theme
-      themes << theme
-      vputs "Added theme: #{name}"
-
-      theme
-    end
-
-    # Tells IRB to use the Hairballs::Theme of +theme_name+.
-    #
-    # @param theme_name [Symbol] The name of the Theme to use/switch to.
-    def use_theme(theme_name)
-      switch_to = themes.find { |theme| theme.name == theme_name }
-      fail ThemeUseFailure.new(theme_name) unless switch_to
-      vputs "Switched to theme: #{theme_name}"
-
-      switch_to.use!
-      @current_theme = switch_to
-
-      true
-    end
-
-    # All Hairballs::Plugins available to be loaded.
-    #
-    # @return [Array<Hairballs::Plugin>]
-    def plugins
-      @plugins ||= []
-    end
-
-    # All Hairballs::Plugins that have been loaded.
-    #
-    # @return [Array<Hairballs::Plugin>]
-    def loaded_plugins
-      @loaded_plugins ||= []
-    end
-
-    # Builds a new Hairballs::Plugin and adds it to thelist of `.plugins` that
-    # can be used.
-    #
-    # @param name [Symbol]
-    # @param options [Hash] Plugin-dependent options to define.  These get
-    #   passed along the the Hairballs::Plugin object and are used as attributes
-    #   of the plugin.
-    def add_plugin(name, **options)
-      plugin = Plugin.new(name, options)
-      yield plugin
-      plugins << plugin
-      vputs "Added plugin: #{name}"
-
-      plugin
-    end
-
-    # Searches for the Hairballs::Plugin by the +plugin_name+, then loads it.
-    # Raises
-    # @param plugin_name [Symbol]
-    def load_plugin(plugin_name, **options)
-      plugin_to_use = plugins.find { |plugin| plugin.name == plugin_name }
-      fail PluginNotFound.new(plugin_name) unless plugin_to_use
-      vputs "Using plugin: #{plugin_name}"
+  # @return [Hairballs::Configuration]
+  def self.config
+    @@config ||= Hairballs::Configuration.new
+  end
 
-      plugin_to_use.load!(options)
-      loaded_plugins << plugin_to_use
+  class << self
+    extend Forwardable
 
-      true
-    end
+    def_delegators :config,
+      :themes,
+      :add_theme,
+      :current_theme,
+      :use_theme,
 
-    # Name of the relative directory.
-    #
-    # @return [String]
-    def project_name
-      @project_name ||= File.basename(Dir.pwd)
-    end
+      :plugins,
+      :load_plugin,
+      :loaded_plugins,
+      :add_plugin,
 
-    # Is IRB getting loaded for a rails console?
-    #
-    # @return [Boolean]
-    def rails?
-      ENV.has_key?('RAILS_ENV') || !!defined?(Rails)
-    end
+      :completion_procs,
 
-    # Used for maintaining all possible completion Procs, thus allowing many
-    # different plugins to define a Proc for completion without overriding Procs
-    # defined for other plugins.
-    #
-    # @return [Array<Proc>]
-    def completion_procs
-      @completion_procs ||= []
-    end
+      :project_name,
+      :project_root,
+      :version,
+      :rails?
   end
 end

data/spec/hairballs/configuration_spec.rb

@@ -0,0 +1,195 @@
+require 'spec_helper'
+require 'hairballs/configuration'
+
+RSpec.describe Hairballs::Configuration do
+  subject(:config) { described_class.new }
+
+  describe '#themes' do
+    subject { config.themes }
+    it { is_expected.to be_an Array }
+    it { is_expected.to be_empty }
+  end
+
+  describe '#add_theme' do
+    let(:theme) { double 'Hairballs::Theme' }
+
+    context 'block given and name param is a Symbol' do
+      before do
+        expect(Hairballs::Theme).to receive(:new).with(:test).and_return theme
+      end
+
+      it 'yields the Theme' do
+        expect { |b| subject.add_theme(:test, &b) }.to yield_with_args(theme)
+      end
+
+      it 'adds the Theme to @themes' do
+        expect(subject.themes).to receive(:<<).with(theme)
+        subject.add_theme(:test) { |_| }
+      end
+
+      it 'returns the Theme' do
+        expect(subject.add_theme(:test) { |_| }).to eq theme
+      end
+    end
+
+    context 'no block given' do
+      before do
+        allow(Hairballs::Theme).to receive(:new).and_return theme
+      end
+
+      it 'raises a LocalJumpError' do
+        expect { subject.add_theme(:test) }.to raise_exception(LocalJumpError)
+      end
+    end
+  end
+
+  describe '#use_theme' do
+    let(:theme) { double 'Hairballs::Theme', name: :test }
+
+    context 'theme_name represents an added theme' do
+      before do
+        expect(subject.themes).to receive(:find).and_return theme
+      end
+
+      it 'does not raise a ThemeUseFailure' do
+        allow(theme).to receive(:use!)
+        expect { subject.use_theme(:test) }.to_not raise_exception
+      end
+
+      it 'tells the theme to #use!' do
+        expect(theme).to receive(:use!)
+
+        subject.use_theme(:test)
+      end
+
+      it 'sets @current_theme to the new theme' do
+        allow(theme).to receive(:use!)
+
+        expect { subject.use_theme(:test) }.
+          to change { subject.instance_variable_get(:@current_theme) }.
+          to(theme)
+      end
+    end
+
+    context 'theme_name does not represent an added theme' do
+      it 'raises a ThemeUseFailure' do
+        expect(subject.themes).to receive(:find).and_return nil
+
+        expect do
+          subject.use_theme(:meow)
+        end.to raise_exception(Hairballs::ThemeUseFailure)
+      end
+    end
+  end
+
+  describe '#plugins' do
+    subject { config.plugins }
+    it { is_expected.to be_an Array }
+  end
+
+  describe '#loaded_plugins' do
+    subject { config.loaded_plugins }
+    it { is_expected.to be_an Array }
+  end
+
+  describe '#add_plugin' do
+    let(:plugin) { double 'Hairballs::Plugin' }
+
+    context 'block given and name param is a Symbol' do
+      before do
+        expect(Hairballs::Plugin).to receive(:new).with(:test, {}).and_return plugin
+      end
+
+      it 'yields the Plugin' do
+        expect { |b| subject.add_plugin(:test, &b) }.to yield_with_args(plugin)
+      end
+
+      it 'adds the Plugin to @plugins' do
+        expect(subject.plugins).to receive(:<<).with(plugin)
+        subject.add_plugin(:test) { |_| }
+      end
+
+      it 'returns the Plugin' do
+        expect(subject.add_plugin(:test) { |_| }).to eq plugin
+      end
+    end
+
+    context 'no block given' do
+      before do
+        allow(Hairballs::Plugin).to receive(:new).and_return plugin
+      end
+
+      it 'raises a LocalJumpError' do
+        expect { subject.add_plugin(:test) }.to raise_exception(LocalJumpError)
+      end
+    end
+  end
+
+  describe '#load_plugin' do
+    let(:plugin) { double 'Hairballs::Plugin', name: :test }
+
+    context 'theme_name represents an added plugin' do
+      before do
+        expect(subject.plugins).to receive(:find).and_return plugin
+      end
+
+      it 'does not raise an exception' do
+        allow(plugin).to receive(:load!)
+
+        expect do
+          subject.load_plugin(:test)
+        end.to_not raise_exception
+      end
+
+      it 'tells the plugin to #load!' do
+        expect(plugin).to receive(:load!)
+        subject.load_plugin(:test)
+      end
+
+      it 'updates @loaded_plugins with the new theme' do
+        allow(plugin).to receive(:load!)
+
+        expect { subject.load_plugin(:test) }.
+          to change { subject.loaded_plugins.size }.
+          by(1)
+      end
+    end
+
+    context 'plugin_name does not represent an added plugin' do
+      it 'raises a PluginNotFound' do
+        expect do
+          subject.load_plugin(:meow)
+        end.to raise_exception(Hairballs::PluginNotFound)
+      end
+    end
+  end
+
+  describe '.project_name' do
+    subject { config.project_name }
+    it { is_expected.to eq 'hairballs' }
+  end
+
+  describe '.project_root' do
+    before do
+      allow(Dir).to receive(:pwd).and_return '/meow/hairballs'
+    end
+
+    subject { config.project_name }
+  end
+
+  describe '.rails?' do
+    subject { config.rails? }
+
+    context 'not using Rails' do
+      it { is_expected.to eq false }
+    end
+
+    context 'using Rails' do
+      context 'RAILS_ENV is defined' do
+        before { ENV['RAILS_ENV'] = 'blargh' }
+        after { ENV.delete('RAILS_ENV') }
+        it { is_expected.to eq true }
+      end
+    end
+  end
+end

data/spec/hairballs/library_helpers_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+require 'hairballs/library_helpers'
+
+RSpec.describe Hairballs::LibraryHelpers do
+  subject { Object.new.extend described_class }
+
+  describe '#libraries' do
+    context 'block given' do
+      it 'yields an empty array' do
+        expect { |b| subject.libraries(&b) }.to yield_with_args([])
+      end
+
+      it 'allows adding to the yielded array' do
+        expect {
+          subject.libraries do |libs|
+            libs << 'meow'
+          end
+        }.to change { subject.instance_variable_get(:@libraries) }.
+        from(nil).to(['meow'])
+      end
+    end
+
+    context 'block not given' do
+      it 'sets @libraries to the given param' do
+        expect {
+          subject.libraries(['meow'])
+        }.to change { subject.instance_variable_get(:@libraries) }.
+        from(nil).to(['meow'])
+      end
+    end
+
+    context 'block AND param given' do
+      it 'sets @libraries to the param value' do
+        expect {
+          subject.libraries(['meow'])
+        }.to change { subject.instance_variable_get(:@libraries) }.
+        from(nil).to(['meow'])
+      end
+    end
+  end
+
+  describe '#require_libraries' do
+    context '@libraries is nil' do
+      it 'returns nil' do
+        expect(subject.require_libraries).to be_nil
+      end
+    end
+
+    context '@libraries is not nil' do
+      before do
+        subject.instance_variable_set(:@libraries, %w(one))
+        allow(subject).to receive(:vputs)
+        Hairballs.define_singleton_method(:rails?) { nil }
+      end
+
+      context 'libraries are not installed' do
+        it 'tries two times to require then Gem.install' do
+          expect(subject).to receive(:require).with('one').exactly(2).times.and_raise LoadError
+          expect(Gem).to receive(:install).with('one').exactly(1).times
+
+          expect { subject.require_libraries }.to raise_exception LoadError
+        end
+      end
+    end
+  end
+
+  describe '#find_latest_gem' do
+    it 'returns the path to the latest version of the gem' do
+      expect(subject.find_latest_gem('rake')).to match %r{gems/rake}
+    end
+  end
+end

data/spec/hairballs/plugin_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+require 'hairballs/plugin'
+
+RSpec.describe Hairballs::Plugin do
+  subject { described_class.new('test', one: 1, two: 2) }
+
+  describe '#initialize' do
+    context 'with attributes' do
+      it 'defines getters and setters for each attribute' do
+        expect(subject.one).to eq 1
+        subject.one = 1.1
+        expect(subject.one).to eq 1.1
+
+        expect(subject.two).to eq 2
+        subject.two = 2.2
+        expect(subject.two).to eq 2.2
+      end
+    end
+  end
+
+  describe '#on_load' do
+    let(:the_block) { proc { puts 'hi' } }
+
+    it 'stores the given block' do
+      expect {
+        subject.on_load(&the_block)
+      }.to change { subject.instance_variable_get(:@on_load) }.
+      from(nil).to(the_block)
+    end
+  end
+
+  describe '#load!' do
+    context 'with attributes' do
+      it 'sets the attributes' do
+        expect(subject).to receive(:one=).with('thing one')
+        expect(subject).to receive(:two=).with('thing two')
+        allow(subject).to receive(:require_libraries)
+
+        subject.load! one: 'thing one', two: 'thing two'
+      end
+    end
+
+    context 'without attributes' do
+      it 'does not set the attributes' do
+        expect(subject).to_not receive(:one=)
+        expect(subject).to_not receive(:two=)
+        allow(subject).to receive(:require_libraries)
+
+        subject.load!
+      end
+    end
+
+    context 'with @on_load set to a Proc' do
+      let(:on_load) { double 'Proc', :kind_of? => true }
+      before { subject.instance_variable_set(:@on_load, on_load) }
+
+      it 'calls the on_load Proc' do
+        expect(on_load).to receive(:call)
+        subject.load!
+      end
+    end
+
+    context 'with @on_load set to not a Proc' do
+      let(:on_load) { double 'Proc', :kind_of? => false }
+      before { subject.instance_variable_set(:@on_load, on_load) }
+
+      it 'raises a PluginLoadFailure' do
+        expect { subject.load! }.to raise_exception Hairballs::PluginLoadFailure
+      end
+    end
+  end
+end

data/spec/hairballs/theme_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+require 'hairballs/theme'
+
+RSpec.describe Hairballs::Theme do
+  subject(:theme) { described_class.new(:test) }
+
+  describe '#irb_name' do
+    subject { theme.irb_name }
+    it { is_expected.to eq :TEST }
+  end
+end

data/spec/hairballs_spec.rb

@@ -2,184 +2,28 @@ require 'spec_helper'
 require 'hairballs'
 
 describe Hairballs do
-  subject { described_class }
+  subject(:hairballs) { described_class }
 
-  describe '.themes' do
-    subject { described_class.themes }
-    it { is_expected.to be_an Array }
+  describe '.config' do
+    subject { hairballs.config }
+    it { is_expected.to be_a Hairballs::Configuration }
   end
 
-  describe '.add_theme' do
-    let(:theme) { double 'Hairballs::Theme' }
-    context 'block given and name param is a Symbol' do
-      before do
-        expect(Hairballs::Theme).to receive(:new).with(:test).and_return theme
-      end
+  it { is_expected.to respond_to(:themes) }
+  it { is_expected.to respond_to(:current_theme) }
+  it { is_expected.to respond_to(:add_theme) }
+  it { is_expected.to respond_to(:use_theme) }
 
-      it 'yields the Theme' do
-        expect { |b| subject.add_theme(:test, &b) }.to yield_with_args(theme)
-      end
+  it { is_expected.to respond_to(:plugins) }
+  it { is_expected.to respond_to(:loaded_plugins) }
+  it { is_expected.to respond_to(:add_plugin) }
+  it { is_expected.to respond_to(:load_plugin) }
 
-      it 'adds the Theme to @themes' do
-        expect(subject.themes).to receive(:<<).with(theme)
-        subject.add_theme(:test) { |_| }
-      end
+  it { is_expected.to respond_to(:completion_procs) }
 
-      it 'returns the Theme' do
-        expect(subject.add_theme(:test) { |_| }).to eq theme
-      end
-    end
+  it { is_expected.to respond_to(:project_name) }
+  it { is_expected.to respond_to(:project_root) }
+  it { is_expected.to respond_to(:rails?) }
 
-    context 'no block given' do
-      before do
-        allow(Hairballs::Theme).to receive(:new).and_return theme
-      end
-
-      it 'raises a LocalJumpError' do
-        expect { subject.add_theme(:test) }.to raise_exception(LocalJumpError)
-      end
-    end
-  end
-
-  describe '.use_theme' do
-    let(:theme) { double 'Hairballs::Theme', name: :test }
-
-    context 'theme_name represents an added theme' do
-      before(:example) do
-        expect(subject.themes).to receive(:find).and_return theme
-      end
-
-      it 'does not raise a ThemeUseFailure' do
-        allow(theme).to receive(:use!)
-
-        expect do
-          subject.use_theme(:test)
-        end.to_not raise_exception
-      end
-
-      it 'tells the theme to #use!' do
-        expect(theme).to receive(:use!)
-        subject.use_theme(:test)
-      end
-
-      it 'sets @current_theme to the new theme' do
-        allow(theme).to receive(:use!)
-
-        expect { subject.use_theme(:test) }.
-          to change { subject.instance_variable_get(:@current_theme) }.
-          to(theme)
-      end
-    end
-
-    context 'theme_name does not represent an added theme' do
-      it 'raises a ThemeUseFailure' do
-        expect do
-          described_class.use_theme(:meow)
-        end.to raise_exception(Hairballs::ThemeUseFailure)
-      end
-    end
-  end
-
-  describe '.plugins' do
-    subject { described_class.plugins }
-    it { is_expected.to be_an Array }
-  end
-
-  describe '.loaded_plugins' do
-    subject { described_class.loaded_plugins }
-    it { is_expected.to be_an Array }
-  end
-
-  describe '.add_plugin' do
-    let(:plugin) { double 'Hairballs::Plugin' }
-
-    context 'block given and name param is a Symbol' do
-      before do
-        expect(Hairballs::Plugin).to receive(:new).with(:test, {}).and_return plugin
-      end
-
-      it 'yields the Plugin' do
-        expect { |b| subject.add_plugin(:test, &b) }.to yield_with_args(plugin)
-      end
-
-      it 'adds the Plugin to @plugins' do
-        expect(subject.plugins).to receive(:<<).with(plugin)
-        subject.add_plugin(:test) { |_| }
-      end
-
-      it 'returns the Plugin' do
-        expect(subject.add_plugin(:test) { |_| }).to eq plugin
-      end
-    end
-
-    context 'no block given' do
-      before do
-        allow(Hairballs::Plugin).to receive(:new).and_return plugin
-      end
-
-      it 'raises a LocalJumpError' do
-        expect { subject.add_plugin(:test) }.to raise_exception(LocalJumpError)
-      end
-    end
-  end
-
-  describe '.load_plugin' do
-    let(:plugin) { double 'Hairballs::Plugin', name: :test }
-
-    context 'theme_name represents an added plugin' do
-      before(:example) do
-        expect(subject.plugins).to receive(:find).and_return plugin
-      end
-
-      it 'does not raise an exception' do
-        allow(plugin).to receive(:load!)
-
-        expect do
-          subject.load_plugin(:test)
-        end.to_not raise_exception
-      end
-
-      it 'tells the plugin to #load!' do
-        expect(plugin).to receive(:load!)
-        subject.load_plugin(:test)
-      end
-
-      it 'updates @loaded_plugins with the new theme' do
-        allow(plugin).to receive(:load!)
-
-        expect { subject.load_plugin(:test) }.
-          to change { subject.loaded_plugins.size }.
-          by(1)
-      end
-    end
-
-    context 'plugin_name does not represent an added plugin' do
-      it 'raises a PluginNotFound' do
-        expect do
-          described_class.load_plugin(:meow)
-        end.to raise_exception(Hairballs::PluginNotFound)
-      end
-    end
-  end
-
-  describe '.project_name' do
-    subject { described_class.project_name }
-    it { is_expected.to eq 'hairballs' }
-  end
-
-  describe '.rails?' do
-    subject { described_class.rails? }
-
-    context 'not using Rails' do
-      it { is_expected.to eq false }
-    end
-
-    context 'using Rails' do
-      context 'RAILS_ENV is defined' do
-        before { ENV['RAILS_ENV'] = 'blargh' }
-        after { ENV.delete('RAILS_ENV') }
-        it { is_expected.to eq true }
-      end
-    end
-  end
+  it { is_expected.to respond_to(:version) }
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hairballs
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Steve Loveless
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-19 00:00:00.000000000 Z
+date: 2015-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,7 +52,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.1'
-description: Some tools for making customizing your IRB sessions a little easier.
+description: Like oh-my-zsh, but for IRB.
 email:
 - steve.loveless@gmail.com
 executables: []
@@ -68,6 +68,7 @@ files:
 - Rakefile
 - hairballs.gemspec
 - lib/hairballs.rb
+- lib/hairballs/configuration.rb
 - lib/hairballs/exceptions.rb
 - lib/hairballs/ext/kernel_vputs.rb
 - lib/hairballs/library_helpers.rb
@@ -86,6 +87,10 @@ files:
 - lib/hairballs/themes/turboladen.rb
 - lib/hairballs/themes/turboladen_rails.rb
 - lib/hairballs/version.rb
+- spec/hairballs/configuration_spec.rb
+- spec/hairballs/library_helpers_spec.rb
+- spec/hairballs/plugin_spec.rb
+- spec/hairballs/theme_spec.rb
 - spec/hairballs_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/turboladen/hairballs
@@ -108,11 +113,15 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.0
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Like oh-my-zsh, but for IRB.
 test_files:
+- spec/hairballs/configuration_spec.rb
+- spec/hairballs/library_helpers_spec.rb
+- spec/hairballs/plugin_spec.rb
+- spec/hairballs/theme_spec.rb
 - spec/hairballs_spec.rb
 - spec/spec_helper.rb
 has_rdoc: