configatron_plus 0.2.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+gem 'configatron'
+
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "yard", "~> 0.6.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.2"
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    configatron (2.8.2)
+      yamler (>= 0.1.0)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.6.2)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.8.7)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    yamler (0.1.0)
+    yard (0.6.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  configatron
+  jeweler (~> 1.6.2)
+  rspec (~> 2.3.0)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Scott M Parrish
+
+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.textile

@@ -0,0 +1,84 @@
+h1. ConfigatronPlus
+
+An addition to Configatron to make it easy to read configuration from default settings and  multiple locations including environmental variables.
+
+h2. Configatron
+
+Find out more at "Configatron":https://github.com/markbates/configatron
+
+h2. Installation
+
+Installation of ConfigatronPlus is easy, as it is just a RubyGem:
+
+TODO: finish wrapping things up as gem
+
+<pre><code>
+  $ sudo gem install configatron-plus
+</code></pre>
+
+Once installed you just need to require it:
+
+<pre><code>
+  require 'configatron-plus'
+</code></pre>
+
+h2. Usage
+
+ConfigatronPlus stores all of its own configuration inside configatron.  Use the following to see the current setup:
+
+<pre><code>
+  puts configatron.to_hash #dump it as a straight ruby code.
+  puts configatron.inspect #show the code you'd need to recreate the current config
+</code></pre>
+
+h2. Config
+
+There are 5 parameters that can be configured, all of which have defaults.  All 5 are located at
+<pre><code>
+  configatron.configatron_plus
+ </code></pre>
+
+|_. Parameter |_. Use |_. Default |
+| env_prefix | change this to change the prefix used in to look for values in the ENV | configatron_ |
+| fail_when_missing | change this to true to raise an error when a file in #sources is not found on the filesystem | false |
+| rc_name | the default name of the file to look for | config.rb |
+| source_files | the actual file name used for a given symbol | <pre>:current => #{configatron.configatron_plus.rc_name}</pre> |
+| sources | The list of files and symbols to load | <pre>[:current, :env]</pre> |
+
+h3. default
+
+The default config looks like this when #inspect
+
+<pre><code>
+  configatron.configatron_plus.env_prefix = "configatron_"
+  configatron.configatron_plus.fail_when_missing = false
+  configatron.configatron_plus.rc_name = "config.rb"
+  configatron.configatron_plus.source_files = {:current=>"config.rb"}
+  configatron.configatron_plus.sources = [:current, :env]
+</code></pre>
+
+h2. Examples
+
+h3. Default
+
+By default, ConfigurationPlus looks for a config.rb file in the current directory, and reads any Environmental Variables with a name that starts with configatron_
+
+<pre><code>
+  ConfigatronPlus.fetch_sources #Checks the current dir for config.rb and reads from environmental variables
+</code></pre>
+
+h3. Different default filename and prefix
+
+To look for an alternate filename, set the rc_name parameter
+
+<pre><code>
+  configatron.configatron_plus.rc_name = "my_app.rb"
+  configatron.configatron_plus.env_prefix = "my_app_
+  ConfigatronPlus.fetch_sources #Checks the current dir for my_app.rb and reads from environmental variables starting with my_app_
+</code></pre>
+
+
+
+h2. Contact
+
+

data/Rakefile

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "configatron_plus"
+  gem.homepage = "http://github.com/anithri/configatron-plus"
+  gem.license = "MIT"
+  gem.summary = %Q{A helper for the configatron library}
+  gem.description = %Q{Aids in using the configatron library by making it easy to read in multiple configuration files and environmental variables.}
+  gem.email = "anithri@gmail.com"
+  gem.authors = ["Scott M Parrish"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/configatron_plus.gemspec

@@ -0,0 +1,72 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "configatron_plus"
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Scott M Parrish"]
+  s.date = "2011-09-08"
+  s.description = "Aids in using the configatron library by making it easy to read in multiple configuration files and environmental variables."
+  s.email = "anithri@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.textile"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.textile",
+    "Rakefile",
+    "VERSION",
+    "config/config.rb",
+    "configatron_plus.gemspec",
+    "examples/config.rb",
+    "examples/first.rb",
+    "examples/second.rb",
+    "examples/use_two_files",
+    "examples/with_defaults",
+    "examples/with_env",
+    "lib/configatron_plus.rb",
+    "lib/configatron_plus/errors.rb",
+    "spec/config_files/testing_config.rb",
+    "spec/configatron_plus_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/anithri/configatron-plus"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "A helper for the configatron library"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<configatron>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.2"])
+    else
+      s.add_dependency(%q<configatron>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+    end
+  else
+    s.add_dependency(%q<configatron>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<yard>, ["~> 0.6.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+  end
+end
+

data/examples/config.rb

@@ -0,0 +1,5 @@
+configatron.example do |c|
+  c.this = "is a test"
+  c.file = "config.rb"
+end
+

data/examples/first.rb

@@ -0,0 +1,6 @@
+configatron.example do |c|
+  c.this = "is a test"
+  c.replaced = "from first file"
+  c.file.first = "first.rb"
+end
+

data/examples/second.rb

@@ -0,0 +1,6 @@
+configatron.example do |c|
+  c.that = "is a test"
+  c.replaced = "from second file"
+  c.file.second = "second.rb"
+end
+

data/examples/use_two_files

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+$LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+require 'configatron_plus'
+
+ConfigatronPlus.sources =['first.rb','second.rb']
+ConfigatronPlus.fetch_sources
+
+puts "first.rb called first, second.rb called second"
+puts configatron.inspect

data/examples/with_defaults

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+$LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+require 'configatron_plus'
+
+puts "Default Configuration before #fetch_sources"
+puts configatron.inspect
+ConfigatronPlus.fetch_sources
+puts "\nDefault Configuration after #fetch_sources"
+puts configatron.inspect

data/examples/with_env

@@ -0,0 +1,4 @@
+#!/bin/bash
+export configatron_from_env_first="abc"
+export configatron_from_env_again="xyz"
+./$1

data/lib/configatron_plus.rb

@@ -0,0 +1,143 @@
+require 'configatron'
+require 'configatron_plus/errors'
+require 'pathname'
+module ConfigatronPlus
+
+  DEFAULT_SOURCES = [:current, :env]
+
+  def self.config
+    configatron.configatron_plus
+  end
+
+  configatron.configatron_plus do |c|
+    c.set_default(:sources,           DEFAULT_SOURCES.dup)
+    c.set_default(:rc_name,           "config.rb")
+    c.set_default(:env_prefix,        "configatron_")
+    c.set_default(:source_files,      {:current => configatron.configatron_plus.rc_name})
+    c.set_default(:fail_when_missing, false)
+  end
+
+  def self.fail_when_missing
+    configatron.configatron_plus.fail_when_missing
+  end
+
+  def self.fail_when_missing=(val)
+    configatron.configatron_plus.fail_when_missing = val
+  end
+
+  # Set the sources to use for configatron
+  # @param new_val [Array<String,Symbol>] new array of sources.
+  def self.sources=(new_val)
+    @@errors = nil
+    raise ArgumentError.new "value must be an Array." unless new_val.is_a?(Array)
+    unless self.valid_list?(new_val)
+      raise ArgumentError.new "Array members must be a symbol, string, or Pathname: #{self.errors}"
+    end
+     self.config.sources = new_val
+  end
+
+  # Get the current list of sources
+  # @return [Array<String,Symbol>] of sources to look for configurations in
+  def self.sources
+    self.config.sources
+  end
+
+  # @return [Array] of symbols.
+
+  def self.errors
+    @@errors ||= []
+  end
+
+  #set @@sources = DEFAULT_SOURCES
+  def self.reset_sources
+    self.sources = DEFAULT_SOURCES.dup
+  end
+
+  #check each element of the list to see if it's a correct symbol or can be used a a filename.
+  # @return [Boolean]
+  def self.valid_list?(val)
+    val.each do |i|
+      errors << "Invalid entry: #{i}" unless self.can_use_as_filename?(i)
+      if i.is_a?(Symbol) && ! self.is_symbol_defined?(i)
+        errors << "Invalid symbol: #{i.to_s}"
+      end
+    end
+    errors.empty?
+  end
+
+  def self.is_symbol_defined?(sym)
+    return true if sym == :env
+    self.config.source_files.keys.include?(sym)
+  end
+
+  # @param opts [Hash] the options for getting configuration
+  # @option opts [Boolean] :fail_on_missing (false) Raise an exception if a file in the @sources list is not present
+  def self.fetch_sources
+    self.sources.each do |s|
+      if s.is_a?(Symbol)
+        get_from_special(s)
+      else
+        get_from_file(s.is_a?(Pathname) ? s : Pathname(s))
+      end
+    end
+  end
+
+  # Checks to see if we can use this as a filename
+  # @param val [Object] Object to check
+  # @return [Boolean]]
+  def self.can_use_as_filename?(val)
+    return true if val.is_a?(String)
+    return true if val.is_a?(Pathname)
+    return true if val.is_a?(Symbol)
+
+    #if no other
+    false
+  end
+
+  # looks upo the file for a given symbol and calls get_from_file with it
+  # @param s [Symbol] use to look up and load a file
+  def self.get_from_special(s)
+    raise ArgumentError unless s.is_a?(Symbol)
+    return get_from_env if s == :env
+    file = config.source_files.fetch(s,nil)
+    raise ConfigatronPlus::ConfigError.new("Setting does not exist for: #{s}") if file.nil?
+    file = Pathname(file)
+    self.get_from_file(file)
+  end
+
+  # checks to see if file exists and loads it
+  # @param file [Pathname] file to attempt to load
+  def self.get_from_file(file)
+    raise ArgumentError.new("Not Pathname: #{file}") unless file.is_a?(Pathname)
+    if file.expand_path.file?
+      c = File.read(file.expand_path)
+      eval(c)
+    elsif self.fail_when_missing
+      raise ConfigatronPlus::ConfigError.new("Config file does not exist: #{file.to_s}")
+    end
+  end
+
+  #scan ENV for any keys that start with alfred_
+  #check to see that they are valid names
+  #add them to configatron
+  def self.get_from_env
+    ENV.keys.find_all {|e| self.use_this_env?(e)}.each do |key|
+      setting = key[config.env_prefix.length .. -1]
+      setting.split('_').each do |e|
+        raise ConfigatronPlus::ConfigError.new("Env variable '#{key}' contains invalid characters") unless self.is_valid_key_name?(e)
+      end
+      eval("configatron." + setting.gsub('_','.') + " = \"#{ENV[key]}\"")
+    end
+  end
+
+  def self.use_this_env?(env)
+    env.length > config.env_prefix.length && env.start_with?(config.env_prefix)
+  end
+
+  # Checks a string to make sure it is a valid identifier so we can eval it
+  # @param e [String] string to check for validity
+  # @return [Boolean] is valid?
+  def self.is_valid_key_name?(e)
+    /^[a-z][a-z0-9]*$/.match(e.downcase)
+  end
+end

data/lib/configatron_plus/errors.rb

@@ -0,0 +1,4 @@
+module ConfigatronPlus
+  class ConfigError < StandardError
+  end
+end

data/spec/config_files/testing_config.rb

@@ -0,0 +1,6 @@
+configatron.file do |c|
+  c.test.one = 123
+  c.test.two = 'abc'
+  c.another = 'xyz'
+  c.foo.bar.baz = 'woot'
+end

data/spec/configatron_plus_spec.rb

@@ -0,0 +1,212 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+require "rspec"
+
+describe "ConfigatronPlus" do
+  after :each do
+    ConfigatronPlus.reset_sources
+  end
+
+  describe "#can_use_as_filename?(val)" do
+    it "should be true for symbols, strings and Pathnames" do
+      ConfigatronPlus.can_use_as_filename?(:testme).should be_true
+      ConfigatronPlus.can_use_as_filename?("Hi").should be_true
+      ConfigatronPlus.can_use_as_filename?(Pathname("Hi")).should be_true
+    end
+
+    it "should be false for anything else" do
+      ConfigatronPlus.can_use_as_filename?(123).should be_false
+      ConfigatronPlus.can_use_as_filename?({:error => 'yes'}).should be_false
+      ConfigatronPlus.can_use_as_filename?([1,2,3]).should be_false
+    end
+  end
+
+  describe "#valid_list?" do
+    it "should be true and errors should be empty for valid @sources" do
+      ConfigatronPlus.valid_list?(ConfigatronPlus::DEFAULT_SOURCES).should be_true
+      ConfigatronPlus.errors.should == []
+    end
+
+    it "should be false and have errors for invalid symbols" do
+      ConfigatronPlus.valid_list?([:error]).should be_false
+    end
+  end
+
+  describe "#sources and #sources=" do
+    it "should initialize with defaults" do
+      ConfigatronPlus.sources.should == ConfigatronPlus::DEFAULT_SOURCES
+    end
+
+    it "should accept a valid sources array" do
+      expect {
+        ConfigatronPlus.sources = [:current]
+        }.should_not raise_error
+    end
+
+    it "should not accept an invalid array" do
+      expect {ConfigatronPlus.sources = "error"}.should raise_error(ArgumentError)
+      expect {ConfigatronPlus.sources = 123 }.should raise_error(ArgumentError)
+      expect {ConfigatronPlus.sources = Pathname("/")}.should raise_error(ArgumentError)
+      expect {ConfigatronPlus.sources = {:error => "yes indeed"}}.should raise_error(ArgumentError)
+      expect {ConfigatronPlus.sources = []}.should_not raise_error(ArgumentError)
+      expect {ConfigatronPlus.sources = ["error"]}.should_not raise_error(ArgumentError)
+      expect {ConfigatronPlus.sources = [:error]}.should raise_error(ArgumentError)
+    end
+  end
+
+  describe "#fetch_sources" do
+    before :all do
+      ConfigatronPlus.stub(:get_from_special)
+      ConfigatronPlus.stub(:get_from_file)
+    end
+
+    context "default values and all symbols" do
+      it "should correctly call #get_from_special and #get_from_file" do
+        ConfigatronPlus.should_receive(:get_from_special).exactly(2).times
+        ConfigatronPlus.fetch_sources
+      end
+    end
+    context "all strings" do
+      it "should correctly call #get_from_special and #get_from_file" do
+        ConfigatronPlus.sources = %w(a b c d e)
+        ConfigatronPlus.should_receive(:get_from_file).exactly(5).times
+        ConfigatronPlus.fetch_sources
+      end
+    end
+    context "mixed strings and symbols" do
+      it "should correctly call #get_from_special and #get_from_file" do
+        ConfigatronPlus.sources = ['a', :current, 'b', 'c', 'd', 'e', :env]
+        ConfigatronPlus.should_receive(:get_from_special).exactly(2).times
+        ConfigatronPlus.should_receive(:get_from_file).exactly(5).times
+        ConfigatronPlus.fetch_sources
+      end
+    end
+  end
+
+  describe "#is_valid_key_name?(e)" do
+    it "should be true for good values" do
+      ConfigatronPlus.is_valid_key_name?("a").should be_true
+      ConfigatronPlus.is_valid_key_name?("abc").should be_true
+      ConfigatronPlus.is_valid_key_name?("ABC").should be_true
+      ConfigatronPlus.is_valid_key_name?("abC").should be_true
+      ConfigatronPlus.is_valid_key_name?("Cacd").should be_true
+      ConfigatronPlus.is_valid_key_name?("a124").should be_true
+    end
+    it "should be false for bad values" do
+      ConfigatronPlus.is_valid_key_name?("1").should be_false
+      ConfigatronPlus.is_valid_key_name?("a.1").should be_false
+      ConfigatronPlus.is_valid_key_name?("-e").should be_false
+      ConfigatronPlus.is_valid_key_name?("po^").should be_false
+      ConfigatronPlus.is_valid_key_name?("this is").should be_false
+      ConfigatronPlus.is_valid_key_name?("this_is").should be_false
+    end
+  end
+
+  describe "#use_this_env?(env)" do
+    it "should be true when passed a valid name" do
+      ConfigatronPlus.use_this_env?('configatron_test').should be_true
+      ConfigatronPlus.use_this_env?('configatron_foo_bar').should be_true
+      ConfigatronPlus.use_this_env?('configatron_foo_bar_baz').should be_true
+    end
+
+    it "should be false when passed an invalid name" do
+      ConfigatronPlus.use_this_env?('testing_me').should be_false
+      ConfigatronPlus.use_this_env?('t').should be_false
+      ConfigatronPlus.use_this_env?('configatron').should be_false
+      ConfigatronPlus.use_this_env?('configatron_').should be_false
+      ConfigatronPlus.use_this_env?('configatro_foo').should be_false
+      ConfigatronPlus.use_this_env?('configatron-bar-baz').should be_false
+    end
+  end
+  describe "#is_symbol_defined?(sym)" do
+    it "should be true when passed an existing symbol" do
+      ConfigatronPlus.is_symbol_defined?(:env).should be_true
+      ConfigatronPlus.is_symbol_defined?(:current).should be_true
+      ConfigatronPlus.config.source_files[:testing] = "test"
+      ConfigatronPlus.is_symbol_defined?(:testing).should be_true
+    end
+
+    it "should be false when passed any other symbol or object" do
+      ConfigatronPlus.is_symbol_defined?(:foo).should be_false
+      ConfigatronPlus.is_symbol_defined?('foo').should be_false
+      ConfigatronPlus.is_symbol_defined?(123).should be_false
+      ConfigatronPlus.is_symbol_defined?([1,2,3]).should be_false
+    end
+  end
+  describe "#get_from_env" do
+    it "should set configatron settings from environment" do
+      ENV['configatron_test_one'] = "123"
+      ENV['configatron_test_two'] = "abc"
+      ENV['configatron_another'] = "foo,bar,baz"
+
+      ConfigatronPlus.get_from_env
+      configatron.test.one.should == "123"
+      configatron.test.two.should == "abc"
+      configatron.another.should == "foo,bar,baz"
+    end
+  end
+
+  describe "#get_from_special(s)" do
+    before :each do
+      ConfigatronPlus.stub(:get_from_file)
+    end
+    it "should not raise an error for the default settings (less env)" do
+      [:current, :env].each do |sym|
+        expect {
+          ConfigatronPlus.get_from_special(sym)
+        }.should_not raise_error ConfigatronPlus::ConfigError
+      end
+    end
+
+    it "should raise an error if setting does not exist for symbol" do
+      expect {
+        ConfigatronPlus.get_from_special(:bad)
+      }.should raise_error ConfigatronPlus::ConfigError
+    end
+
+    it "should call get_from_file when called correctly" do
+      ConfigatronPlus.should_receive(:get_from_file).once
+      ConfigatronPlus.get_from_special(:current)
+    end
+  end
+
+  describe "#get_from_file(file)" do
+    after :each do
+      ConfigatronPlus.reset_sources
+      ConfigatronPlus.fail_when_missing = false
+    end
+
+    it "should raise an error if not called with a pathname" do
+      expect {
+        ConfigatronPlus.get_from_file("failure")
+      }.should raise_error ArgumentError
+    end
+
+    context "fail_when_missing is true" do
+      it "should raise an error when the file doesn't exist" do
+        ConfigatronPlus.fail_when_missing = true
+        expect {
+          ConfigatronPlus.get_from_file(Pathname.new("/some/long/foo/bar/baz/path"))
+        }.should raise_error ConfigatronPlus::ConfigError
+      end
+    end
+    context "fail_when_missing is false" do
+      it "should not raise an error when the file doesn't exist" do
+        ConfigatronPlus.fail_when_missing = false
+        expect {
+          ConfigatronPlus.get_from_file(Pathname.new("/some/long/foo/bar/baz/path"))
+        }.should_not raise_error ConfigatronPlus::ConfigError
+
+      end
+    end
+
+    it "should read a file into configatron when file is present" do
+      tmp = Pathname('spec/config_files/testing_config.rb')
+      ConfigatronPlus.get_from_file(tmp)
+      configatron.file.test.one.should == 123
+      configatron.file.test.two.should == "abc"
+      configatron.file.another.should == 'xyz'
+      configatron.file.foo.bar.baz.should == 'woot'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'configatron_plus'
+require 'tmpdir'
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: configatron_plus
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
+platform: ruby
+authors:
+- Scott M Parrish
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-08 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: configatron
+  requirement: &19998860 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *19998860
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &19998340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *19998340
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &19997820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *19997820
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &19997320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *19997320
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &19996800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.2
+  type: :development
+  prerelease: false
+  version_requirements: *19996800
+description: Aids in using the configatron library by making it easy to read in multiple
+  configuration files and environmental variables.
+email: anithri@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.textile
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.textile
+- Rakefile
+- VERSION
+- config/config.rb
+- configatron_plus.gemspec
+- examples/config.rb
+- examples/first.rb
+- examples/second.rb
+- examples/use_two_files
+- examples/with_defaults
+- examples/with_env
+- lib/configatron_plus.rb
+- lib/configatron_plus/errors.rb
+- spec/config_files/testing_config.rb
+- spec/configatron_plus_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/anithri/configatron-plus
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1691687962721209573
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A helper for the configatron library
+test_files: []