configatron 2.2.2 → 2.3.0

data/doc/rdoc-style.css

@@ -1,208 +0,0 @@
-
-body {
-    font-family: Verdana,Arial,Helvetica,sans-serif;
-    font-size:   90%;
-    margin: 0;
-    margin-left: 40px;
-    padding: 0;
-    background: white;
-}
-
-h1,h2,h3,h4 { margin: 0; color: #efefef; background: transparent; }
-h1 { font-size: 150%; }
-h2,h3,h4 { margin-top: 1em; }
-
-a { background: #eef; color: #039; text-decoration: none; }
-a:hover { background: #039; color: #eef; }
-
-/* Override the base stylesheet's Anchor inside a table cell */
-td > a {
-  background: transparent;
-  color: #039;
-  text-decoration: none;
-}
-
-/* and inside a section title */
-.section-title > a {
-  background: transparent;
-  color: #eee;
-  text-decoration: none;
-}
-
-/* === Structural elements =================================== */
-
-div#index {
-    margin: 0;
-    margin-left: -40px;
-    padding: 0;
-    font-size: 90%;
-}
-
-
-div#index a {
-    margin-left: 0.7em;
-}
-
-div#index .section-bar {
-   margin-left: 0px;
-   padding-left: 0.7em;
-   background: #ccc;
-   font-size: small;
-}
-
-
-div#classHeader, div#fileHeader {
-    width: auto;
-    color: white;
-    padding: 0.5em 1.5em 0.5em 1.5em;
-    margin: 0;
-    margin-left: -40px;
-    border-bottom: 3px solid #006;
-}
-
-div#classHeader a, div#fileHeader a {
-    background: inherit;
-    color: white;
-}
-
-div#classHeader td, div#fileHeader td {
-    background: inherit;
-    color: white;
-}
-
-
-div#fileHeader {
-    background: #057;
-}
-
-div#classHeader {
-    background: #048;
-}
-
-
-.class-name-in-header {
-  font-size:  180%;
-  font-weight: bold;
-}
-
-
-div#bodyContent {
-    padding: 0 1.5em 0 1.5em;
-}
-
-div#description {
-    padding: 0.5em 1.5em;
-    background: #efefef;
-    border: 1px dotted #999;
-}
-
-div#description h1,h2,h3,h4,h5,h6 {
-    color: #125;;
-    background: transparent;
-}
-
-div#validator-badges {
-    text-align: center;
-}
-div#validator-badges img { border: 0; }
-
-div#copyright {
-    color: #333;
-    background: #efefef;
-    font: 0.75em sans-serif;
-    margin-top: 5em;
-    margin-bottom: 0;
-    padding: 0.5em 2em;
-}
-
-
-/* === Classes =================================== */
-
-table.header-table {
-    color: white;
-    font-size: small;
-}
-
-.type-note {
-    font-size: small;
-    color: #DEDEDE;
-}
-
-.xxsection-bar {
-    background: #eee;
-    color: #333;
-    padding: 3px;
-}
-
-.section-bar {
-   color: #333;
-   border-bottom: 1px solid #999;
-    margin-left: -20px;
-}
-
-
-.section-title {
-    background: #79a;
-    color: #eee;
-    padding: 3px;
-    margin-top: 2em;
-    margin-left: -30px;
-    border: 1px solid #999;
-}
-
-.top-aligned-row {  vertical-align: top }
-.bottom-aligned-row { vertical-align: bottom }
-
-/* --- Context section classes ----------------------- */
-
-.context-row { }
-.context-item-name { font-family: monospace; font-weight: bold; color: black; }
-.context-item-value { font-size: small; color: #448; }
-.context-item-desc { color: #333; padding-left: 2em; }
-
-/* --- Method classes -------------------------- */
-.method-detail {
-    background: #efefef;
-    padding: 0;
-    margin-top: 0.5em;
-    margin-bottom: 1em;
-    border: 1px dotted #ccc;
-}
-.method-heading {
-  color: black;
-  background: #ccc;
-  border-bottom: 1px solid #666;
-  padding: 0.2em 0.5em 0 0.5em;
-}
-.method-signature { color: black; background: inherit; }
-.method-name { font-weight: bold; }
-.method-args { font-style: italic; }
-.method-description { padding: 0 0.5em 0 0.5em; }
-
-/* --- Source code sections -------------------- */
-
-a.source-toggle { font-size: 90%; }
-div.method-source-code {
-    background: #262626;
-    color: #ffdead;
-    margin: 1em;
-    padding: 0.5em;
-    border: 1px dashed #999;
-    overflow: hidden;
-}
-
-div.method-source-code pre { color: #ffdead; overflow: hidden; }
-
-/* --- Ruby keyword styles --------------------- */
-
-.standalone-code { background: #221111; color: #ffdead; overflow: hidden; }
-
-.ruby-constant  { color: #7fffd4; background: transparent; }
-.ruby-keyword { color: #00ffff; background: transparent; }
-.ruby-ivar    { color: #eedd82; background: transparent; }
-.ruby-operator  { color: #00ffee; background: transparent; }
-.ruby-identifier { color: #ffdead; background: transparent; }
-.ruby-node    { color: #ffa07a; background: transparent; }
-.ruby-comment { color: #b22222; font-weight: bold; background: transparent; }
-.ruby-regexp  { color: #ffa07a; background: transparent; }
-.ruby-value   { color: #7fffd4; background: transparent; }

data/spec/lib/class_spec.rb

@@ -1,28 +0,0 @@
-require File.join(File.dirname(__FILE__), '..', 'spec_helper')
-
-configatron.foo.bar = :bar
-configatron.a.b.c.d = 'D'
-
-class Foo
-end
-
-module A
-  module B
-    class C
-    end
-  end
-end
-
-describe Class do
-  
-  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
-    
-  end
-  
-end

data/spec/lib/configatron_spec.rb

@@ -1,434 +0,0 @@
-require File.join(File.dirname(__FILE__), '..', 'spec_helper')
-
-describe "configatron" do
-
-  before(:each) do
-    configatron.reset!
-  end
-  
-  describe 'protect' do
-    
-    it 'should protect a parameter and prevent it from being set' do
-      configatron.one = 1
-      configatron.protect(:one)
-      lambda{configatron.one = 'one'}.should raise_error(Configatron::ProtectedParameter)
-      configatron.one.should == 1
-    end
-    
-    it 'should protect basic methods' do
-      lambda{configatron.object_id = 123456}.should raise_error(Configatron::ProtectedParameter)
-      lambda{configatron.foo.object_id = 123456}.should raise_error(Configatron::ProtectedParameter)
-    end
-    
-    it 'should work with nested parameters' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.letters.protect(:a)
-      lambda{configatron.letters.a = 'a'}.should raise_error(Configatron::ProtectedParameter)
-      configatron.letters.a.should == 'A'
-      configatron.protect(:letters)
-      lambda{configatron.letters.a = 'a'}.should raise_error(Configatron::ProtectedParameter)
-      lambda{configatron.letters = 'letter'}.should raise_error(Configatron::ProtectedParameter)
-    end
-    
-    it 'should work with configure_from_hash' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.letters.protect(:a)
-      lambda{configatron.configure_from_hash(:letters => {:a => 'a'})}.should raise_error(Configatron::ProtectedParameter)
-      configatron.letters.a.should == 'A'
-      configatron.protect(:letters)
-      lambda{configatron.letters.configure_from_hash(:a => 'a')}.should raise_error(Configatron::ProtectedParameter)
-      lambda{configatron.configure_from_hash(:letters => 'letters')}.should raise_error(Configatron::ProtectedParameter)
-    end
-    
-    it "should be able to protect all parameters at once" do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.protect_all!
-      [:a,:b].each do |l|
-        lambda{configatron.configure_from_hash(:letters => {l => l.to_s})}.should raise_error(Configatron::ProtectedParameter)
-        configatron.letters.send(l).should == l.to_s.upcase
-      end
-      lambda{configatron.letters.configure_from_hash(:a => 'a')}.should raise_error(Configatron::ProtectedParameter)
-      lambda{configatron.configure_from_hash(:letters => 'letters')}.should raise_error(Configatron::ProtectedParameter)
-    end
-    
-    it "should be able to unprotect a parameter" do
-      configatron.one = 1
-      configatron.protect(:one)
-      configatron.unprotect(:one)
-      lambda{configatron.one = 2}.should_not raise_error
-    end
-    
-    it "should be able to unprotect all parameters at once" do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.protect_all!
-      configatron.unprotect_all!
-      lambda{configatron.one = 2}.should_not raise_error
-      lambda{configatron.letters.configure_from_hash(:a => 'a')}.should_not raise_error
-    end
-    
-  end
-
-  describe 'lock' do
-    before :each do
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.letters.greek.alpha = 'alpha'
-      configatron.lock(:letters)
-    end
-
-    it 'should allow setting of existing parameters in locked parameter' do
-      lambda { configatron.letters.a = 'a' }.should_not raise_error
-    end
-
-    it 'should not allow setting of a parameter that is not already set' do
-      lambda { configatron.letters.c = 'C' }.should raise_error(Configatron::LockedNamespace)
-    end
-
-    it 'should allow setting of existing parameters in child of locked parameter' do
-      lambda { configatron.letters.greek.alpha = 'a' }.should_not raise_error
-    end
-
-    it 'should not allow setting of new parameters in child of locked parameter' do
-      lambda { configatron.letters.greek.beta = 'beta' }.should raise_error(Configatron::LockedNamespace)
-    end
-
-    it 'should not affect parameters below the locked namespace' do
-      lambda { configatron.one = 1 }.should_not raise_error
-    end
-
-    it 'should raise an ArgumentError if unknown namespace is locked' do
-      lambda { configatron.lock(:numbers).should raise_error(ArgumentError) }
-    end
-
-    describe 'then unlock' do
-      before :each do
-        configatron.unlock(:letters)
-      end
-
-      it 'should allow setting of new parameter in unlocked namespace' do
-        lambda { configatron.letters.d = 'd' }.should_not raise_error
-      end
-
-      it 'should allow setting of new parameter in unlocked namespace\'s child' do
-        lambda { configatron.letters.greek.zeta = 'z' }.should_not raise_error
-      end
-
-      it 'should raise an ArgumentError if unknown namespace is unlocked' do
-        lambda { configatron.unlock(:numbers).should raise_error(ArgumentError) }
-      end
-    end
-  end
-  
-  describe 'temp' do
-    
-    it 'should revert back to the original parameters when the block ends' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.temp do
-        configatron.letters.b = 'bb'
-        configatron.letters.c = 'c'
-        configatron.one.should == 1
-        configatron.letters.a.should == 'A'
-        configatron.letters.b.should == 'bb'
-        configatron.letters.c.should == 'c'
-      end
-      configatron.one.should == 1
-      configatron.letters.a.should == 'A'
-      configatron.letters.b.should == 'B'
-      configatron.letters.c.should be_nil
-    end
-    
-    it 'should take an optional hash of parameters' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.temp(:letters => {:b => 'bb', :c => 'c'}) do
-        configatron.one.should == 1
-        configatron.letters.a.should == 'A'
-        configatron.letters.b.should == 'bb'
-        configatron.letters.c.should == 'c'
-      end
-      configatron.one.should == 1
-      configatron.letters.a.should == 'A'
-      configatron.letters.b.should == 'B'
-      configatron.letters.c.should be_nil
-    end
-    
-    it 'should work the same as temp_start/temp_end' do
-      configatron.one = 1
-      configatron.temp_start
-      configatron.one = 'ONE'
-      configatron.one.should == 'ONE'
-      configatron.temp_end
-      configatron.one.should == 1
-    end
-    
-    it 'should be able to nest' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.temp do
-        configatron.letters.b = 'bb'
-        configatron.letters.c = 'c'
-        configatron.one.should == 1
-        configatron.letters.a.should == 'A'
-        configatron.letters.b.should == 'bb'
-        configatron.letters.c.should == 'c'
-        configatron.temp do
-          configatron.letters.b = 'bbb'
-          configatron.one.should == 1
-          configatron.letters.a.should == 'A'
-          configatron.letters.b.should == 'bbb'
-          configatron.letters.c.should == 'c'
-        end
-      end
-      configatron.one.should == 1
-      configatron.letters.a.should == 'A'
-      configatron.letters.b.should == 'B'
-      configatron.letters.c.should be_nil
-    end
-    
-  end
-
-  describe 'configure_from_hash' do
-    
-    it 'should configure itself from a hash' do
-      configatron.foo.should be_nil
-      configatron.configure_from_hash(:foo => :bar)
-      configatron.foo.should == :bar
-    end
-    
-    it 'should handled deeply nested params' do
-      configatron.friends.rachel.should be_nil
-      configatron.configure_from_hash(:friends => {:rachel => 'Rachel Green'})
-      configatron.friends.rachel.should == 'Rachel Green'
-    end
-    
-    it 'should not remove previously defined params' do
-      configatron.friends.rachel = 'Rachel Green'
-      configatron.friends.ross = 'Ross Gellar'
-      configatron.friends.monica = 'Monica Gellar'
-      configatron.configure_from_hash(:friends => {:rachel => 'R. Green', :monica => 'Monica Bing'})
-      configatron.friends.ross.should == 'Ross Gellar'
-      configatron.friends.rachel.should == 'R. Green'
-      configatron.friends.monica.should == 'Monica Bing'
-    end 
-    
-  end
-  
-  describe 'configure_from_yaml' do
-    
-    it 'should configure itself from a yaml file' do
-      configatron.futurama.should be_nil
-      configatron.configure_from_yaml(File.join(File.dirname(__FILE__), 'futurama.yml'))
-      configatron.futurama.robots.bender.should == 'Bender The Robot'
-    end
-    
-    it 'should not remove previously defined params' do
-      configatron.futurama.mutants.leela = 'Leela'
-      configatron.configure_from_yaml(File.join(File.dirname(__FILE__), 'futurama.yml'))
-      configatron.futurama.robots.bender.should == 'Bender The Robot'
-      configatron.futurama.mutants.leela = 'Leela'
-    end
-    
-    it "should fail silently if the file doesn't exist" do
-      lambda{configatron.configure_from_yaml('i_dont_exist.yml')}.should_not raise_error
-    end
-    
-    it "should be able to load a specific hash from the file" do
-      configatron.others.should be_nil
-      configatron.survivors.should be_nil
-      configatron.configure_from_yaml(File.join(File.dirname(__FILE__), 'lost.yml'), :hash => "survivors")
-      configatron.others.should be_nil
-      configatron.survivors.should be_nil
-      configatron.on_island.jack.should == 'Jack Shepherd'
-    end
-    
-  end
-  
-  it 'should return a parameter' do
-    configatron.foo = :bar
-    configatron.foo.should == :bar
-  end
-  
-  it 'should return a nested parameter' do
-    configatron.children.dylan = 'Dylan Bates'
-    configatron.children.dylan.should == 'Dylan Bates'
-  end
-  
-  it 'should set a nested parameter and not remove previously defined params' do
-    configatron.friends.rachel = 'Rachel Green'
-    configatron.friends.rachel.should == 'Rachel Green'
-    configatron.friends.ross = 'Ross Gellar'
-    configatron.friends.ross.should == 'Ross Gellar'
-    configatron.friends.monica = 'Monica Gellar'
-    configatron.friends.monica.should == 'Monica Gellar'
-    configatron.friends.rachel = 'R. Green'
-    configatron.friends.monica = 'Monica Bing'
-    configatron.friends.rachel.should == 'R. Green'
-    configatron.friends.ross.should == 'Ross Gellar'
-    configatron.friends.monica.should == 'Monica Bing'
-  end
-  
-  it 'should return the Configatron instance' do
-    configatron.should be_is_a(Configatron)
-  end
-  
-  describe 'to_hash' do
-    
-    it 'should return a hash of all the params' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.to_hash.should == {:one => 1, :letters => {:a => 'A', :b => 'B'}}
-    end
-    
-  end
-  
-  describe 'inspect' do
-    
-    it 'should call return the inspect method of the to_hash method' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.numbers.small.one = 1
-      configatron.numbers.small.others = [2,3]
-      configatron.numbers.big.one.hundred = '100'
-      
-      configatron.inspect.should == %{
-configatron.letters.a = "A"
-configatron.letters.b = "B"
-configatron.numbers.big.one.hundred = "100"
-configatron.numbers.small.one = 1
-configatron.numbers.small.others = [2, 3]
-configatron.one = 1
-}.strip
-      
-    end
-    
-  end
-  
-  describe 'nil?' do
-    
-    it 'should return true if there are no parameters' do
-      configatron.should be_nil
-      configatron.friends.should be_nil
-    end
-    
-    it 'should return true if there are no parameters on a nested parameter' do
-      configatron.friends.monica.should be_nil
-    end
-    
-  end
-  
-  describe 'retrieve' do
-    
-    it 'should retrieve a parameter' do
-      configatron.office = 'Michael'
-      configatron.retrieve(:office).should == 'Michael'
-    end
-    
-    it 'should return the optional second parameter if the config setting is nil' do
-      configatron.retrieve(:office, 'Stanley').should == 'Stanley'
-    end
-    
-    it 'should work with a symbol or a string' do
-      configatron.office = 'Michael'
-      configatron.retrieve(:office).should == 'Michael'
-      configatron.retrieve('office').should == 'Michael'
-    end
-    
-    it 'should work on nested parameters' do
-      configatron.the.office = 'Michael'
-      configatron.the.retrieve(:office).should == 'Michael'
-      configatron.the.retrieve('office').should == 'Michael'
-    end
-    
-  end
-  
-  describe 'remove' do
-    
-    it 'should remove a parameter' do
-      configatron.movies = 'Pulp Fiction'
-      configatron.movies.should == 'Pulp Fiction'
-      configatron.remove(:movies)
-      configatron.movies.should be_nil
-    end
-    
-    it 'should remove a nested parameter' do
-      configatron.the.movies = 'Pulp Fiction'
-      configatron.the.movies.should == 'Pulp Fiction'
-      configatron.the.remove(:movies)
-      configatron.the.movies.should be_nil
-    end
-    
-    it 'should work with a symbol or a string' do
-      configatron.the.movies = 'Pulp Fiction'
-      configatron.the.office = 'Michael'
-      configatron.the.remove(:movies)
-      configatron.the.movies.should be_nil
-      configatron.the.remove('office')
-      configatron.the.office.should be_nil
-    end
-    
-    it 'should remove all sub-parameters' do
-      configatron.the.movies = 'Pulp Fiction'
-      configatron.the.office = 'Michael'
-      configatron.remove(:the)
-      configatron.the.should be_nil
-      configatron.the.movies.should be_nil
-    end
-    
-  end
-  
-  describe 'set_default' do
-    
-    it 'should set a default parameter value' do
-      configatron.set_default(:movies, 'Pulp Fiction')
-      configatron.movies.should == 'Pulp Fiction'
-    end
-    
-    it 'should set a default parameter value for a nested parameter' do
-      configatron.the.set_default(:movies, 'Pulp Fiction')
-      configatron.the.movies.should == 'Pulp Fiction'
-    end
-    
-    it 'should not set the parameter if it is already set' do
-      configatron.movies = 'Transformers'
-      configatron.set_default(:movies, 'Pulp Fiction')
-      configatron.movies.should == 'Transformers'
-    end
-    
-    it 'should not set the nested parameter if it is already set' do
-      configatron.the.movies = 'Transformers'
-      configatron.the.set_default(:movies, 'Pulp Fiction')
-      configatron.the.movies.should == 'Transformers'
-    end
-    
-  end
-  
-  describe 'reset!' do
-    
-    it 'should clear out all parameter' do
-      configatron.one = 1
-      configatron.letters.a = 'A'
-      configatron.letters.b = 'B'
-      configatron.one.should == 1
-      configatron.letters.a.should == 'A'
-      configatron.reset!
-      configatron.one.should be_nil
-      configatron.letters.a.should be_nil
-    end
-    
-  end
-
-end