configatron 2.13.0 → 3.0.0.rc1

metadata

@@ -1,32 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: configatron
 version: !ruby/object:Gem::Version
-  version: 2.13.0
-  prerelease: 
+  version: 3.0.0.rc1
 platform: ruby
 authors:
 - Mark Bates
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-19 00:00:00.000000000 Z
+date: 2013-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: yamler
+  name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 0.1.0
-  type: :runtime
+        version: '0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: '0'
 description: A powerful Ruby configuration system.
 email:
 - mark@markbates.com
@@ -39,18 +36,16 @@ files:
 - .travis.yml
 - Gemfile
 - Gemfile.lock
-- LICENSE
+- Guardfile
+- LICENSE.txt
 - README.md
 - Rakefile
+- V2-README.md
 - configatron.gemspec
 - lib/configatron.rb
 - lib/configatron/core.rb
-- lib/configatron/core_ext/class.rb
-- lib/configatron/core_ext/kernel.rb
-- lib/configatron/core_ext/object.rb
-- lib/configatron/core_ext/string.rb
+- lib/configatron/deep_clone.rb
 - lib/configatron/errors.rb
-- lib/configatron/proc.rb
 - lib/configatron/rails.rb
 - lib/configatron/store.rb
 - lib/configatron/version.rb
@@ -60,56 +55,34 @@ files:
 - lib/generators/configatron/install/templates/configatron/production.rb
 - lib/generators/configatron/install/templates/configatron/test.rb
 - lib/generators/configatron/install/templates/initializers/configatron.rb
-- spec/configatron/proc_spec.rb
-- spec/configatron/rails_spec.rb
-- spec/lib/class_spec.rb
-- spec/lib/complex.yml
-- spec/lib/configatron_spec.rb
-- spec/lib/futurama.yml
-- spec/lib/lost.yml
-- spec/lib/math.yml
-- spec/lib/merge.yml
-- spec/spec_helper.rb
-- spec/support/rails.rb
-homepage: http://www.metabates.com
-licenses: []
+- test/configatron/store_test.rb
+- test/configatron_test.rb
+- test/test_helper.rb
+homepage: https://github.com/markbates/configatron
+licenses:
+- MIT
+metadata: {}
 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: -1505577042870860442
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>'
     - !ruby/object:Gem::Version
-      version: '0'
-      segments:
-      - 0
-      hash: -1505577042870860442
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: A powerful Ruby configuration system.
 test_files:
-- spec/configatron/proc_spec.rb
-- spec/configatron/rails_spec.rb
-- spec/lib/class_spec.rb
-- spec/lib/complex.yml
-- spec/lib/configatron_spec.rb
-- spec/lib/futurama.yml
-- spec/lib/lost.yml
-- spec/lib/math.yml
-- spec/lib/merge.yml
-- spec/spec_helper.rb
-- spec/support/rails.rb
+- test/configatron/store_test.rb
+- test/configatron_test.rb
+- test/test_helper.rb

data/LICENSE

@@ -1,21 +0,0 @@
-The MIT License
-
-Copyright (c) 2009 Mark Bates
-
-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/configatron/core_ext/class.rb

@@ -1,25 +0,0 @@
-class Class
-  
-  # Returns access to configuration parameters named after the class.
-  # 
-  # Examples:
-  #   configatron.foo.bar = :bar
-  #   configatron.a.b.c.d = 'D'
-  #   
-  #   class Foo
-  #   end
-  #   
-  #   module A
-  #     module B
-  #       class C
-  #       end
-  #     end
-  #   end
-  # 
-  #   Foo.to_configatron.bar # => :bar
-  #   A::B::C.to_configatron.d # => 'D'
-  def to_configatron(*args)
-    self.name.to_configatron(*args)
-  end
-  
-end

data/lib/configatron/core_ext/kernel.rb

@@ -1,8 +0,0 @@
-module Kernel
-  
-  # Provides access to the Configatron storage system.
-  def configatron
-    Configatron.instance
-  end
-  
-end

data/lib/configatron/core_ext/object.rb

@@ -1,13 +0,0 @@
-class Object # :nodoc:
-
-  def send_with_chain(methods, *args) # :nodoc:
-    obj = self
-    [methods].flatten.each {|m| obj = obj.send(m, *args)}
-    obj
-  end
-
-  def blank? # ported ActiveSupport method
-    respond_to?(:empty?) ? empty? : !self
-  end
-
-end

data/lib/configatron/core_ext/string.rb

@@ -1,90 +0,0 @@
-class String # :nodoc:
-  
-  def to_configatron(*args)
-    name_spaces = (args + self.split("::")).flatten
-    name_spaces.collect!{|s| s.to_s.methodize}
-    configatron.send_with_chain(name_spaces)
-  end
-  
-  def underscore # :nodoc:
-    self.to_s.gsub(/::/, '/').
-      gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
-      gsub(/([a-z\d])([A-Z])/,'\1_\2').
-      tr("-", "_").
-      downcase
-  end
-  
-  def methodize # :nodoc:
-    x = self
-    
-    # if we get down to a nil or an empty string raise an exception! 
-    raise NameError.new("#{self} cannot be converted to a valid method name!") if x.nil? || x == ''
-    
-    # get rid of the big stuff in the front/back
-    x.strip!
-    
-    # if we get down to a nil or an empty string raise an exception! 
-    raise NameError.new("#{self} cannot be converted to a valid method name!") if x.nil? || x == ''
-    
-    x = x.underscore
-    
-    # get rid of spaces and make the _
-    x.gsub!(' ', '_')
-    # get rid of everything that isn't 'safe' a-z, 0-9, ?, !, =, _
-    x.gsub!(/([^ a-zA-Z0-9\_\?\!\=]+)/n, '_')
-    
-    # if we get down to a nil or an empty string raise an exception! 
-    raise NameError.new("#{self} cannot be converted to a valid method name!") if x.nil? || x == ''
-    
-    # condense multiple 'safe' non a-z chars to just one.
-    # ie. ___ becomes _ !!!! becomes ! etc...
-    [' ', '_', '?', '!', "="].each do |c|
-      x.squeeze!(c)
-    end
-    
-    # if we get down to a nil or an empty string raise an exception! 
-    raise NameError.new("#{self} cannot be converted to a valid method name!") if x.nil? || x == ''
-    
-    #down case the whole thing
-    x.downcase!
-    
-    # get rid of any characters at the beginning that aren't a-z
-    while !x.match(/^[a-z]/)
-      x.slice!(0)
-      
-      # if we get down to a nil or an empty string raise an exception! 
-      raise NameError.new("#{self} cannot be converted to a valid method name!") if x.nil? || x == ''
-    end
-    
-    # let's trim this bad boy down a bit now that we've cleaned it up, somewhat.
-    # we should do this before cleaning up the end character, because it's possible to end up with a 
-    # bad char at the end if you trim too late.
-    x = x[0..100] if x.length > 100
-    
-    # get rid of any characters at the end that aren't safe
-    while !x.match(/[a-z0-9\?\!\=]$/)
-      x.slice!(x.length - 1)
-      # if we get down to a nil or an empty string raise an exception! 
-      raise NameError.new("#{self} cannot be converted to a valid method name!") if x.nil? || x == ''
-    end
-    
-    # if we get down to a nil or an empty string raise an exception! 
-    raise NameError.new("#{self} cannot be converted to a valid method name!") if x.nil? || x == ''
-    
-    # let's get rid of characters that don't belong in the 'middle' of the method.
-    orig_middle = x[1..(x.length - 2)]
-    n_middle = orig_middle.dup
-    
-    ['?', '!', "="].each do |c|
-      n_middle.gsub!(c, "_")
-    end
-    
-    # the previous gsub can leave us with multiple underscores that need cleaning up.
-    n_middle.squeeze!("_")
-    
-    x.gsub!(orig_middle, n_middle)
-    x.gsub!("_=", "=")
-    x
-  end
-  
-end

data/lib/configatron/proc.rb

@@ -1,104 +0,0 @@
-class Configatron
-  # This class can be used to give special powers to a Configatron setting.
-  # See Configatron::Delayed and Configatron::Dynamic as examples of how this
-  # works.
-  # 
-  # This class can be subclassed easily. The key is to override the <tt>finalize?</tt>
-  # method.
-  # 
-  # Example:
-  #   class RunThreeTimes < Configatron::Proc
-  #     def finalize?
-  #       self.execution_count == 3
-  #     end
-  #   end
-  # 
-  #   configatron.some.rand.generator = RunThreeTimes.new do
-  #     rand
-  #   end
-  #   
-  #   configatron.some.rand.generator # => 0.169280668547299
-  #   configatron.some.rand.generator # => 0.298880544243205
-  #   configatron.some.rand.generator # => 0.421091617110779
-  #   configatron.some.rand.generator # => 0.421091617110779
-  #   configatron.some.rand.generator # => 0.421091617110779
-  class Proc
-
-    # The number of times this Proc has been executed
-    attr_accessor :execution_count
-    # The block that you want executed when you call the <tt>execute</tt> method.
-    attr_accessor :block
-    
-    # Requires a block to be passed into it.
-    def initialize(&block)
-      self.execution_count = 0
-      self.block = block
-    end
-    
-    # Executes the <tt>block</tt> attribute, ticks up the 
-    # <tt>execution_count</tt> attribute by one and then
-    # returns the value of the executed <tt>block</tt>
-    def execute
-      val = self.block.call
-      self.execution_count += 1
-      return val
-    end
-    
-    # Returns <tt>true</tt> if Configatron should cache the
-    # results of the <tt>execute</tt> method, thereby never calling
-    # it again.
-    def finalize?
-      self.execution_count == 1
-    end
-    
-  end
-  
-  # Tells Configatron to always execute the block at runtime.
-  # The results will never be cached.
-  # 
-  # Example:
-  #   configatron.letters = 'a-b-c-d'
-  #   configatron.my.letters = Configatron::Delayed.new do
-  #     "My letters are: #{configatron.letters}"
-  #   end
-  #   configatron.my.other.letters = Configatron::Dynamic.new do
-  #     "My letters are: #{configatron.a.b.c.d}"
-  #   end
-  #   
-  #   configatron.my.letters # => 'My letters are: a-b-c-d'
-  #   configatron.my.other.letters # => 'My letters are: a-b-c-d'
-  #   
-  #   configatron.letters = 'a-b-c-d-e'
-  #   
-  #   configatron.my.letters # => 'My letters are: a-b-c-d'
-  #   configatron.my.other.letters # => 'My letters are: a-b-c-d-e'
-  class Dynamic < Configatron::Proc
-    def finalize?
-      false
-    end
-  end
-  
-  # Tells Configatron to delay execution of the block until
-  # runtime. Once run the results of the block will be cached,
-  # never to be run again.
-  # 
-  # Example:
-  #   configatron.letters = 'a-b-c-d'
-  #   configatron.my.letters = Configatron::Delayed.new do
-  #     "My letters are: #{configatron.letters}"
-  #   end
-  #   configatron.my.other.letters = Configatron::Dynamic.new do
-  #     "My letters are: #{configatron.a.b.c.d}"
-  #   end
-  #   
-  #   configatron.my.letters # => 'My letters are: a-b-c-d'
-  #   configatron.my.other.letters # => 'My letters are: a-b-c-d'
-  #   
-  #   configatron.letters = 'a-b-c-d-e'
-  #   
-  #   configatron.my.letters # => 'My letters are: a-b-c-d'
-  #   configatron.my.other.letters # => 'My letters are: a-b-c-d-e'
-  class Delayed < Configatron::Proc
-  end
-  
-end

data/spec/configatron/proc_spec.rb

@@ -1,67 +0,0 @@
-require File.dirname(__FILE__) + '/../spec_helper'
-
-describe Configatron::Proc do
-
-  before(:each) do
-    configatron.temp_start
-  end
-
-  after(:each) do
-    configatron.temp_end
-  end
-  
-  describe Configatron::Dynamic do
-
-    it 'should execute the code at a later date' do
-      configatron.tv.shows = ['seinfeld', 'simpsons']
-      configatron.my.tv.shows = Configatron::Dynamic.new do
-        "My shows are: #{configatron.tv.shows.join(', ')}"
-      end
-      configatron.my.tv.shows.should == 'My shows are: seinfeld, simpsons'
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage']
-      configatron.my.tv.shows.should == 'My shows are: seinfeld, simpsons, entourage'
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage', 'office']
-      configatron.my.tv.shows.should == 'My shows are: seinfeld, simpsons, entourage, office'
-    end
-    
-    it 'should work with retrieve' do
-      configatron.tv.shows = ['seinfeld', 'simpsons']
-      configatron.my.tv.shows = Configatron::Dynamic.new do
-        "My shows are: #{configatron.tv.shows.join(', ')}"
-      end
-      configatron.my.tv.retrieve(:shows).should == 'My shows are: seinfeld, simpsons'
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage']
-      configatron.my.tv.retrieve(:shows).should == 'My shows are: seinfeld, simpsons, entourage'
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage', 'office']
-      configatron.my.tv.retrieve(:shows).should == 'My shows are: seinfeld, simpsons, entourage, office'
-    end
-
-  end
-  
-  describe Configatron::Delayed do
-
-    it 'should execute the code once at a later date' do
-      configatron.tv.shows = ['seinfeld', 'simpsons']
-      configatron.my.tv.shows = Configatron::Delayed.new do
-        "My shows are: #{configatron.tv.shows.join(', ')}"
-      end
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage']
-      configatron.my.tv.shows.should == 'My shows are: seinfeld, simpsons, entourage'
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage', 'office']
-      configatron.my.tv.shows.should == 'My shows are: seinfeld, simpsons, entourage'
-    end
-    
-    it 'should work with retrieve' do
-      configatron.tv.shows = ['seinfeld', 'simpsons']
-      configatron.my.tv.shows = Configatron::Delayed.new do
-        "My shows are: #{configatron.tv.shows.join(', ')}"
-      end
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage']
-      configatron.my.tv.retrieve(:shows).should == 'My shows are: seinfeld, simpsons, entourage'
-      configatron.tv.shows = ['seinfeld', 'simpsons', 'entourage', 'office']
-      configatron.my.tv.retrieve(:shows).should == 'My shows are: seinfeld, simpsons, entourage'
-    end
-
-  end
-  
-end

data/spec/configatron/rails_spec.rb

@@ -1,66 +0,0 @@
-require File.dirname(__FILE__) + '/../spec_helper'
-
-describe Configatron::Rails do
-  
-  %w{development test production cucumber}.each do |env|
-    
-    describe env do
-      
-      before(:each) do
-        Object.send(:remove_const, 'Rails') rescue nil
-        load File.expand_path(File.join(File.dirname(__FILE__), '..', 'support', 'rails.rb'))
-        ::Rails.env = env
-        ::Rails.root = File.join(File.dirname(__FILE__), '..', "tmp_rails_root_#{env}")
-        @configatron_path = File.join(Rails.root, 'config', 'configatron')
-        @defaults_file_loc = File.join(@configatron_path, 'defaults.rb')
-        @env_file_loc = File.join(@configatron_path, "#{env}.rb")
-        @env_folder_loc = File.join(@configatron_path, env)
-        @env_bar_loc = File.join(@env_folder_loc, 'bar.rb')
-        @env_foo_loc = File.join(@env_folder_loc, 'foo.rb')
-
-        FileUtils.mkdir_p(@env_folder_loc)
-
-        File.open(@defaults_file_loc, 'w') do |f|
-          f.puts 'configatron.fooa = :foo'
-          f.puts 'configatron.bara = :bar'
-          f.puts 'configatron.env = :default'
-          f.puts 'configatron.something.else = 1'
-          f.puts 'configatron.and.another.thing = 42'
-        end
-
-        File.open(@env_file_loc, 'w') do |f|
-          f.puts "configatron.env = :#{env}"
-          f.puts 'configatron.something.else = 2'
-        end
-
-        File.open(@env_bar_loc, 'w') do |f|
-          f.puts "configatron.bara = 'BAR!!'"
-          f.puts 'configatron.something.else = 3'
-        end
-
-        File.open(@env_foo_loc, 'w') do |f|
-          f.puts "configatron.fooa = :fubar"
-          f.puts 'configatron.something.else = 4'
-        end
-      end
-
-      after(:each) do
-        FileUtils.rm_rf(::Rails.root)
-        Object.send(:remove_const, 'Rails')
-        # configatron.reset!
-      end
-
-      it 'should read the defaults first and then the env file' do
-        Configatron::Rails.init
-        configatron.fooa.should == :fubar
-        configatron.bara.should == 'BAR!!'
-        configatron.env.should == env.to_sym
-        configatron.something.else.should == 4
-        configatron.and.another.thing.should == 42
-      end
-      
-    end
-    
-  end
-  
-end

data/spec/lib/class_spec.rb

@@ -1,46 +0,0 @@
-require File.join(File.dirname(__FILE__), '..', 'spec_helper')
-
-configatron.foo.bar = :bar
-configatron.a.b.c.d = 'D'
-
-configatron.cachetastic.foo.bar = 'cachetastic-fubar'
-configatron.l.m.n.o.p = 'P'
-
-class Foo
-end
-
-module A
-  module B
-    class C
-    end
-  end
-end
-
-module N
-  class O
-  end
-end
-
-describe Class do
-
-  if Class.respond_to?(:to_configatron)
-    describe 'to_configatron' do
-
-      it 'should return a Configatron::Store object based on the name of the class' do
-        Foo.to_configatron.should be_kind_of(Configatron::Store)
-        Foo.to_configatron.bar.should == :bar
-        A::B::C.to_configatron.d.should == 'D'
-      end
-
-      it 'should take an array to prepend to the object' do
-        Foo.to_configatron(:cachetastic).bar.should == 'cachetastic-fubar'
-        N::O.to_configatron(:l, 'm').p.should == 'P'
-      end
-
-      it 'should convert a string to a Store object' do
-        'A::B::C'.to_configatron.d.should == configatron.a.b.c.d
-      end
-    end
-  end
-
-end

data/spec/lib/complex.yml

@@ -1,13 +0,0 @@
-complex_default: &default
-  access_key_id: access_key
-  secret_access_key: secret_access_key
-
-complex_development:
-  bucket: develop
-  <<: *default
-
-complex_production:
-  bucket: production
-  <<: *default
-
-complex_test: &test