iqeo-conf 1.0.0 → 1.0.1

data/.yardoc/checksums

@@ -1,2 +1,2 @@
-lib/iqeo/configuration.rb df8997f10c38ea8ba74a6ccef3341c9126de3521
-lib/iqeo/configuration/version.rb ad9da77d4fb2220b3374e15340f7e014e0d7ee80
+lib/iqeo/configuration.rb fb776784916e7a38f6424d31f66a5da06b446532
+lib/iqeo/configuration/version.rb c2a9c241b633aea27196848bec6b5e9069315361

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    iqeo-conf (0.0.14)
+    iqeo-conf (1.1.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -119,7 +119,7 @@ conf.collect { |key,value| value }  # => [ 1, 2.0, :three, 'four' ]
 * read from string, at creation, or after - merged & nested
 * load from filename, at creation, or after - merged & nested
 * defaults
-* merge configurations
+* merge configurations recursively
 * blank slate for DSL
 
 ## Fancy usage

data/doc/Iqeo.html

@@ -115,7 +115,7 @@
         <dt id="CONFIGURATION_VERSION-constant" class="">CONFIGURATION_VERSION =
           
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.0.13</span><span class='tstring_end'>&quot;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>1.0.1</span><span class='tstring_end'>&quot;</span></span></pre></dd>
       
     </dl>
   
@@ -131,7 +131,7 @@
 </div>
 
     <div id="footer">
-  Generated on Tue May 15 23:15:18 2012 by
+  Generated on Mon May 21 15:18:24 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>

data/doc/Iqeo/BlankSlate.html

@@ -115,7 +115,7 @@
 </div>
 
     <div id="footer">
-  Generated on Tue May 15 23:15:18 2012 by
+  Generated on Mon May 21 15:18:24 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>

data/doc/Iqeo/Configuration.html

@@ -454,27 +454,19 @@
 98
 99
 100
-101
-102
-103
-104
-105</pre>
+101</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 87</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span> <span class='id identifier rubyid_default'>default</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
-  <span class='comment'># todo: default immediate child Configurations should have _parent updated
-</span>  <span class='ivar'>@_items</span> <span class='op'>=</span> <span class='kw'>case</span>
-              <span class='kw'>when</span> <span class='id identifier rubyid_default'>default</span><span class='period'>.</span><span class='id identifier rubyid_kind_of?'>kind_of?</span><span class='lparen'>(</span> <span class='const'>HashWithIndifferentAccess</span> <span class='rparen'>)</span> <span class='kw'>then</span> <span class='id identifier rubyid_default'>default</span>
-              <span class='kw'>when</span> <span class='id identifier rubyid_default'>default</span><span class='period'>.</span><span class='id identifier rubyid_kind_of?'>kind_of?</span><span class='lparen'>(</span> <span class='const'>Configuration</span> <span class='rparen'>)</span> <span class='kw'>then</span> <span class='id identifier rubyid_default'>default</span><span class='period'>.</span><span class='id identifier rubyid__items'>_items</span>
-              <span class='kw'>else</span> <span class='const'>HashWithIndifferentAccess</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
-            <span class='kw'>end</span>
+  <span class='ivar'>@_items</span> <span class='op'>=</span> <span class='const'>HashWithIndifferentAccess</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
   <span class='ivar'>@_parent</span> <span class='op'>=</span> <span class='kw'>nil</span>
+  <span class='id identifier rubyid__merge!'>_merge!</span> <span class='id identifier rubyid_default'>default</span> <span class='kw'>if</span> <span class='id identifier rubyid_default'>default</span><span class='period'>.</span><span class='id identifier rubyid_kind_of?'>kind_of?</span><span class='lparen'>(</span> <span class='const'>Configuration</span> <span class='rparen'>)</span>
   <span class='kw'>if</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
-    <span class='kw'>if</span> <span class='id identifier rubyid_block'>block</span><span class='period'>.</span><span class='id identifier rubyid_arity'>arity</span> <span class='op'>&gt;</span> <span class='int'>0</span>                                           <span class='comment'># cannot set parent for yield blocks here as self is wrong !?
-</span>      <span class='kw'>yield</span> <span class='kw'>self</span>
-    <span class='kw'>else</span>
+    <span class='kw'>if</span> <span class='id identifier rubyid_block'>block</span><span class='period'>.</span><span class='id identifier rubyid_arity'>arity</span> <span class='op'>&gt;</span> <span class='int'>0</span>                                            <span class='comment'># cannot set parent for yield block here as context is unknowable
+</span>      <span class='kw'>yield</span> <span class='kw'>self</span>                                                  <span class='comment'># parent is being set in new_defer_block_for_parent
+</span>    <span class='kw'>else</span>
       <span class='kw'>if</span> <span class='id identifier rubyid_block'>block</span><span class='period'>.</span><span class='id identifier rubyid_binding'>binding</span><span class='period'>.</span><span class='id identifier rubyid_eval'>eval</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>self</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_kind_of?'>kind_of?</span><span class='lparen'>(</span> <span class='const'>Configuration</span> <span class='rparen'>)</span>     <span class='comment'># for eval block if nested configuration
 </span>        <span class='ivar'>@_parent</span> <span class='op'>=</span> <span class='id identifier rubyid_block'>block</span><span class='period'>.</span><span class='id identifier rubyid_binding'>binding</span><span class='period'>.</span><span class='id identifier rubyid_eval'>eval</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>self</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>                     <span class='comment'># set parent to make inherited values available
 </span>      <span class='kw'>end</span>                                                         <span class='comment'># during block execution
@@ -510,6 +502,10 @@
       <pre class="lines">
 
 
+103
+104
+105
+106
 107
 108
 109
@@ -522,14 +518,10 @@
 116
 117
 118
-119
-120
-121
-122
-123</pre>
+119</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 107</span>
+      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 103</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_method_missing'>method_missing</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_values'>values</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
   <span class='kw'>return</span> <span class='ivar'>@_items</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_values'>values</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span> <span class='rparen'>)</span> <span class='kw'>if</span> <span class='ivar'>@_items</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span> <span class='id identifier rubyid_name'>name</span>     <span class='comment'># @_items methods are highest priority
@@ -821,12 +813,12 @@
       <pre class="lines">
 
 
-152
-153
-154</pre>
+144
+145
+146</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 152</span>
+      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 144</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid__load'>_load</span> <span class='id identifier rubyid_file'>file</span>
   <span class='id identifier rubyid__read'>_read</span> <span class='id identifier rubyid_file'>file</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='symbol'>:read</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='id identifier rubyid_file'>file</span><span class='period'>.</span><span class='id identifier rubyid_read'>read</span> <span class='op'>:</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_read'>read</span><span class='lparen'>(</span><span class='id identifier rubyid_file'>file</span><span class='rparen'>)</span>
@@ -851,17 +843,15 @@
       <pre class="lines">
 
 
-162
-163
-164
-165</pre>
+160
+161
+162</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 162</span>
+      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 160</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid__merge'>_merge</span> <span class='id identifier rubyid_other'>other</span>
-  <span class='comment'># todo: merges should update _parent of any immediate child Configurations
-</span>  <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span><span class='period'>.</span><span class='id identifier rubyid__merge!'>_merge!</span> <span class='id identifier rubyid_other'>other</span>
+  <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span><span class='period'>.</span><span class='id identifier rubyid__merge!'>_merge!</span> <span class='id identifier rubyid_other'>other</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -883,18 +873,30 @@
       <pre class="lines">
 
 
+148
+149
+150
+151
+152
+153
+154
+155
 156
 157
-158
-159
-160</pre>
+158</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 156</span>
+      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 148</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid__merge!'>_merge!</span> <span class='id identifier rubyid_other'>other</span>
-  <span class='comment'># todo: merges should update _parent of any immediate child Configurations
-</span>  <span class='ivar'>@_items</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span> <span class='id identifier rubyid_other'>other</span><span class='period'>.</span><span class='id identifier rubyid__items'>_items</span>
+  <span class='ivar'>@_items</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span><span class='lparen'>(</span><span class='id identifier rubyid_other'>other</span><span class='period'>.</span><span class='id identifier rubyid__items'>_items</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span><span class='id identifier rubyid_this'>this</span><span class='comma'>,</span><span class='id identifier rubyid_other'>other</span><span class='op'>|</span>
+    <span class='kw'>if</span> <span class='id identifier rubyid_this'>this</span><span class='period'>.</span><span class='id identifier rubyid_kind_of?'>kind_of?</span><span class='lparen'>(</span> <span class='const'>Configuration</span> <span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_other'>other</span><span class='period'>.</span><span class='id identifier rubyid_kind_of?'>kind_of?</span><span class='lparen'>(</span> <span class='const'>Configuration</span> <span class='rparen'>)</span>
+      <span class='id identifier rubyid_this'>this</span><span class='period'>.</span><span class='id identifier rubyid__merge!'>_merge!</span> <span class='id identifier rubyid_other'>other</span>
+    <span class='kw'>else</span>
+      <span class='id identifier rubyid_other'>other</span>
+    <span class='kw'>end</span>
+  <span class='kw'>end</span>
+  <span class='ivar'>@_items</span><span class='period'>.</span><span class='id identifier rubyid_values'>values</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_value'>value</span><span class='op'>|</span> <span class='id identifier rubyid_value'>value</span><span class='period'>.</span><span class='id identifier rubyid__parent'>_parent</span> <span class='op'>=</span> <span class='kw'>self</span> <span class='kw'>if</span> <span class='id identifier rubyid_value'>value</span><span class='period'>.</span><span class='id identifier rubyid_kind_of?'>kind_of?</span><span class='lparen'>(</span> <span class='const'>Configuration</span> <span class='rparen'>)</span> <span class='rbrace'>}</span>
   <span class='kw'>self</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -917,12 +919,12 @@
       <pre class="lines">
 
 
-148
-149
-150</pre>
+140
+141
+142</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 148</span>
+      <pre class="code"><span class="info file"># File 'lib/iqeo/configuration.rb', line 140</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid__read'>_read</span> <span class='id identifier rubyid_string'>string</span>
   <span class='id identifier rubyid_instance_eval'>instance_eval</span> <span class='id identifier rubyid_string'>string</span>
@@ -937,7 +939,7 @@
 </div>
 
     <div id="footer">
-  Generated on Tue May 15 23:15:18 2012 by
+  Generated on Mon May 21 15:18:24 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>

data/doc/_index.html

@@ -131,7 +131,7 @@
 </div>
 
     <div id="footer">
-  Generated on Tue May 15 23:15:17 2012 by
+  Generated on Mon May 21 15:18:24 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>

data/doc/file.README.html

@@ -176,7 +176,7 @@ Configuration settings can be retrieved directly or indirectly.</p>
 <li>read from string, at creation, or after - merged &amp; nested</li>
 <li>load from filename, at creation, or after - merged &amp; nested</li>
 <li>defaults</li>
-<li>merge configurations</li>
+<li>merge configurations recursively</li>
 <li>blank slate for DSL</li>
 </ul>
 
@@ -197,7 +197,7 @@ See LICENSE file.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Tue May 15 23:15:17 2012 by
+  Generated on Mon May 21 15:18:24 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>

data/doc/index.html

@@ -176,7 +176,7 @@ Configuration settings can be retrieved directly or indirectly.</p>
 <li>read from string, at creation, or after - merged &amp; nested</li>
 <li>load from filename, at creation, or after - merged &amp; nested</li>
 <li>defaults</li>
-<li>merge configurations</li>
+<li>merge configurations recursively</li>
 <li>blank slate for DSL</li>
 </ul>
 
@@ -197,7 +197,7 @@ See LICENSE file.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Tue May 15 23:15:17 2012 by
+  Generated on Mon May 21 15:18:24 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Tue May 15 23:15:18 2012 by
+  Generated on Mon May 21 15:18:24 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>

data/lib/iqeo/configuration.rb

@@ -146,10 +146,14 @@ module Iqeo
     end
 
     def _merge! other
-      @_items.merge! other._items
-      @_items.values.each do |value|
-        value._parent = self if value.kind_of?( Configuration )
+      @_items.merge!(other._items) do |key,this,other|
+        if this.kind_of?( Configuration ) && other.kind_of?( Configuration )
+          this._merge! other
+        else
+          other
+        end
       end
+      @_items.values.each { |value| value._parent = self if value.kind_of?( Configuration ) }
       self
     end
 

data/lib/iqeo/configuration/version.rb

@@ -1,3 +1,3 @@
 module Iqeo
-  CONFIGURATION_VERSION = "1.0.0"
+  CONFIGURATION_VERSION = "1.0.1"
 end

data/spec/configuration_spec.rb

@@ -39,449 +39,329 @@ describe Configuration do
     conf.echo.foxtrot.should be_true
   end
 
-  it 'reports the correct version' do
-    Configuration.version.should == CONFIGURATION_VERSION
-  end
-
-  context 'at creation' do
-
-    it 'does not require a block' do
-      Configuration.new.should be_a Configuration
-    end
-
-    it 'accept a block with arity 0' do
-      Configuration.new {  }.should be_a Configuration
-    end
-
-    it 'instance_eval a block with arity 0' do
-      conf_eval = nil
-      conf_new = Configuration.new { conf_eval = self }
-      conf_new.should be conf_eval
-    end
-
-    it 'accept a block with arity 1' do
-      Configuration.new { |arg| }.should be_a Configuration
-    end
+  context 'v1.0' do
 
-    it 'yield self to block with arity 1' do
-      conf_yielded = nil
-      conf_new = Configuration.new { |conf| conf_yielded = conf }
-      conf_new.should be conf_yielded
+    it 'reports the correct version' do
+      Configuration.version.should == CONFIGURATION_VERSION
     end
 
-    it 'accept a block with arity > 1' do
-      Configuration.new { |arg1,arg2,arg3| }.should be_a Configuration
-    end
-
-    it 'yield self to block with arity > 1' do
-      conf_yielded = nil
-      conf_new = Configuration.new { |conf,arg1,arg2| conf_yielded = conf }
-      conf_new.should be conf_yielded
-    end
-
-
-    it 'accepts defaults from another configuration' do
-      conf = Configuration.new simple_explicit_configuration
-      simple_configuration_example conf
-    end
-
-    it 'overrides defaults from another configuration' do
-      conf_default = Configuration.new( simple_explicit_configuration ) { echo true }
-      conf_default.echo.should be_true
-      conf = Configuration.new( conf_default ) { echo false }
-      simple_configuration_example conf
-      conf.echo.should be_false
-    end
+    context 'at creation' do
 
-    context 'can load' do
-
-      it 'simple eval DSL from string' do
-        simple_configuration_example Configuration.read simple_eval_string
+      it 'does not require a block' do
+        Configuration.new.should be_a Configuration
       end
 
-      it 'simple eval DSL from file (StringIO)' do
-        simple_configuration_example Configuration.load StringIO.new simple_eval_string
+      it 'accept a block with arity 0' do
+        Configuration.new {  }.should be_a Configuration
       end
 
-      it 'simple eval DSL from file (mock & expected methods)' do
-        file = mock
-        file.should_receive( :respond_to? ).with( :read ).and_return true
-        file.should_receive( :read ).and_return simple_eval_string
-        simple_configuration_example Configuration.load file
+      it 'instance_eval a block with arity 0' do
+        conf_eval = nil
+        conf_new = Configuration.new { conf_eval = self }
+        conf_new.should be conf_eval
       end
 
-      it 'simple eval DSL from filename (expected methods)' do
-        File.should_receive( :read ).with( "filename" ).and_return simple_eval_string
-        simple_configuration_example Configuration.load "filename"
+      it 'accept a block with arity 1' do
+        Configuration.new { |arg| }.should be_a Configuration
       end
 
-      it 'complex eval DSL from string' do
-        string = "alpha true
-                  bravo do
-                    charlie true
-                    delta do
-                      echo true
-                    end
-                  end"
-        conf = Configuration.read string
-        conf.should_not be_nil
-        conf.alpha.should be_true
-        conf.bravo.should be_a Configuration
-        conf.bravo.alpha should be_true
-        conf.bravo.charlie should be_true
-        conf.bravo.delta.should be_a Configuration
-        conf.bravo.delta.alpha.should be_true
-        conf.bravo.delta.charlie.should be_true
-        conf.bravo.delta.echo.should be_true
+      it 'yield self to block with arity 1' do
+        conf_yielded = nil
+        conf_new = Configuration.new { |conf| conf_yielded = conf }
+        conf_new.should be conf_yielded
       end
 
-    end # loads
+      it 'accept a block with arity > 1' do
+        Configuration.new { |arg1,arg2,arg3| }.should be_a Configuration
+      end
 
-  end # creation
+      it 'yield self to block with arity > 1' do
+        conf_yielded = nil
+        conf_new = Configuration.new { |conf,arg1,arg2| conf_yielded = conf }
+        conf_new.should be conf_yielded
+      end
 
-  context 'settings retrieval' do
 
-    it 'returns nil for non-existent settings' do
-      simple_explicit_configuration.not_a_setting.should be_nil
-    end
-
-    it 'delegates hash methods to internal hash' do
-        conf = Configuration.new
-        conf.alpha 1
-        conf.bravo 2
-        conf.charlie 3
-        conf.delta 4
-      conf.should_not be_nil
-      sum = 0
-      expect do
-        conf.each { |k,v| sum += v }
-      end.to_not raise_error
-      sum.should == 10
-      conf.size.should == 4
-    end
+      it 'accepts defaults from another configuration' do
+        conf = Configuration.new simple_explicit_configuration
+        simple_configuration_example conf
+      end
 
-  end # settings retrieval
+      it 'overrides defaults from another configuration' do
+        conf_default = Configuration.new( simple_explicit_configuration ) { echo true }
+        conf_default.echo.should be_true
+        conf = Configuration.new( conf_default ) { echo false }
+        simple_configuration_example conf
+        conf.echo.should be_false
+      end
 
-  context 'single value setting' do
+      context 'can load' do
 
-    it 'accepts simple values' do
-      simple_configuration_example simple_explicit_configuration
-    end
+        it 'simple eval DSL from string' do
+          simple_configuration_example Configuration.read simple_eval_string
+        end
 
-    it 'accepts complex values' do
-      conf = Configuration.new
-      conf.alpha = [ :a, :b, :c ]
-      conf.bravo = { :a => 1, :b => 2, :c => 3 }
-      conf.alpha.should == [ :a, :b, :c] and conf.alpha.should be_an Array
-      conf.alpha.size.should == 3
-      conf.alpha[0].should == :a
-      conf.alpha[1].should == :b
-      conf.alpha[2].should == :c
-      conf.bravo.should == { 'a' => 1, 'b' => 2, 'c' => 3} and conf.bravo.should be_a Hash
-      conf.bravo.size.should == 3
-      conf.bravo[:a].should == 1
-      conf.bravo[:b].should == 2
-      conf.bravo[:c].should == 3
-    end
+        it 'simple eval DSL from file (StringIO)' do
+          simple_configuration_example Configuration.load StringIO.new simple_eval_string
+        end
 
-  end # single value setting
+        it 'simple eval DSL from file (mock & expected methods)' do
+          file = mock
+          file.should_receive( :respond_to? ).with( :read ).and_return true
+          file.should_receive( :read ).and_return simple_eval_string
+          simple_configuration_example Configuration.load file
+        end
 
-  context 'multiple value setting' do
+        it 'simple eval DSL from filename (expected methods)' do
+          File.should_receive( :read ).with( "filename" ).and_return simple_eval_string
+          simple_configuration_example Configuration.load "filename"
+        end
 
-    it 'accepts hash without brackets' do
-      conf = Configuration.new
-      conf.alpha :a => 1, :b => 2, :c => 3
-      conf.alpha.should == { 'a' => 1, 'b' => 2, 'c' => 3} and conf.alpha.should be_a Hash
-    end
+        it 'complex eval DSL from string' do
+          string = "alpha true
+                    bravo do
+                      charlie true
+                      delta do
+                        echo true
+                      end
+                    end"
+          conf = Configuration.read string
+          conf.should_not be_nil
+          conf.alpha.should be_true
+          conf.bravo.should be_a Configuration
+          conf.bravo.alpha should be_true
+          conf.bravo.charlie should be_true
+          conf.bravo.delta.should be_a Configuration
+          conf.bravo.delta.alpha.should be_true
+          conf.bravo.delta.charlie.should be_true
+          conf.bravo.delta.echo.should be_true
+        end
 
-    it 'treats multiple values as an array' do
-      conf = nil
-      expect do
-        conf = Configuration.new
-        conf.alpha :a, :b, :c
-      end.to_not raise_error
-      conf.should_not be_nil
-      conf.alpha.should == [ :a, :b, :c ] and conf.alpha.should be_an Array
-    end
+      end # loads
 
-    it 'treats hash without brackets after multiple values as last element of array' do
-      conf = Configuration.new
-      conf.alpha 1, 2, 3, :a => 4, :b => 5, :c => 6
-      conf.alpha.should == [ 1, 2, 3, { 'a' => 4, 'b' => 5, 'c' => 6} ] and conf.alpha.should be_a Array
-    end
+    end # creation
 
-  end # multiple value setting
+    context 'settings retrieval' do
 
-  context 'hash operators [] & []= access' do
+      it 'returns nil for non-existent settings' do
+        simple_explicit_configuration.not_a_setting.should be_nil
+      end
 
-    it 'accepts symbol keys' do
-      conf = nil
-      expect do
-        conf = Configuration.new
-        conf[:alpha] = 1
-      end.to_not raise_error
-      conf[:alpha].should == 1
-    end
+      it 'delegates hash methods to internal hash' do
+          conf = Configuration.new
+          conf.alpha 1
+          conf.bravo 2
+          conf.charlie 3
+          conf.delta 4
+        conf.should_not be_nil
+        sum = 0
+        expect do
+          conf.each { |k,v| sum += v }
+        end.to_not raise_error
+        sum.should == 10
+        conf.size.should == 4
+      end
 
-    it 'accepts non-symbol (string) keys' do
-      conf = nil
-      expect do
-        conf = Configuration.new
-        conf['alpha'] = 1
-      end.to_not raise_error
-      conf.should_not be_nil
-      conf['alpha'].should == 1
-    end
+    end # settings retrieval
 
-  end # hash operators [] & []= access
+    context 'single value setting' do
 
-  context 'nested configuration' do
+      it 'accepts simple values' do
+        simple_configuration_example simple_explicit_configuration
+      end
 
-    it 'is supported' do
-      conf = nil
-      expect do
+      it 'accepts complex values' do
         conf = Configuration.new
-        conf.alpha Configuration.new
-        conf.alpha.bravo Configuration.new
-        conf.alpha.bravo.charlie true
-      end.to_not raise_error
-      conf.should_not be_nil
-      conf.alpha.should be_a Configuration
-      conf.alpha.bravo.should be_a Configuration
-      conf.alpha.bravo.charlie.should be_true
-    end
+        conf.alpha = [ :a, :b, :c ]
+        conf.bravo = { :a => 1, :b => 2, :c => 3 }
+        conf.alpha.should == [ :a, :b, :c] and conf.alpha.should be_an Array
+        conf.alpha.size.should == 3
+        conf.alpha[0].should == :a
+        conf.alpha[1].should == :b
+        conf.alpha[2].should == :c
+        conf.bravo.should == { 'a' => 1, 'b' => 2, 'c' => 3} and conf.bravo.should be_a Hash
+        conf.bravo.size.should == 3
+        conf.bravo[:a].should == 1
+        conf.bravo[:b].should == 2
+        conf.bravo[:c].should == 3
+      end
 
-    it 'knows its parent when referenced directly' do
-      conf = nil
-      expect do
-        conf = Configuration.new
-        conf.alpha Configuration.new
-        conf.alpha.bravo Configuration.new
-        conf.alpha.bravo.charlie true
-      end.to_not raise_error
-      conf.should_not be_nil
-      conf.alpha.bravo.__send__(:_parent).should be conf.alpha
-      conf.alpha.__send__(:_parent).should be conf
-      conf.__send__(:_parent).should be_nil
-    end
+    end # single value setting
 
-    it 'inherits settings' do
-      conf = nil
-      expect do
-        conf = Configuration.new
-        conf.alpha Configuration.new
-        conf.alpha.bravo Configuration.new
-        conf.top = true
-        conf.alpha.middle = true
-        conf.alpha.bravo.bottom = true
-      end.to_not raise_error
-      conf.should_not be_nil
-      conf.top.should be_true
-      conf.alpha.top.should be_true
-      conf.alpha.middle.should be_true
-      conf.alpha.bravo.top.should be_true
-      conf.alpha.bravo.middle.should be_true
-      conf.alpha.bravo.bottom.should be_true
-    end
+    context 'multiple value setting' do
 
-    it 'can override inherited settings' do
-      conf = nil
-      expect do
+      it 'accepts hash without brackets' do
         conf = Configuration.new
-        conf.alpha Configuration.new
-        conf.alpha.bravo Configuration.new
-        conf.level = 1
-        conf.alpha.level = 2
-        conf.alpha.bravo.level = 3
-      end.to_not raise_error
-      conf.should_not be_nil
-      conf.level.should == 1
-      conf.alpha.level.should == 2
-      conf.alpha.bravo.level.should == 3
-    end
-
-  end # nested configuration
-
-  context 'mode of usage' do
-
-    context 'explicit' do
-
-      it 'accepts settings without =' do
-        conf = nil
-        expect do
-          conf = Configuration.new
-          conf.alpha :value
-        end.to_not raise_error
-        conf.should_not be_nil
-        conf.alpha.should == :value
+        conf.alpha :a => 1, :b => 2, :c => 3
+        conf.alpha.should == { 'a' => 1, 'b' => 2, 'c' => 3} and conf.alpha.should be_a Hash
       end
 
-      it 'accepts settings with =' do
+      it 'treats multiple values as an array' do
         conf = nil
         expect do
           conf = Configuration.new
-          conf.alpha = :value
+          conf.alpha :a, :b, :c
         end.to_not raise_error
         conf.should_not be_nil
-        conf.alpha.should == :value
+        conf.alpha.should == [ :a, :b, :c ] and conf.alpha.should be_an Array
       end
 
-      it 'can refer to an existing setting' do
-        conf = nil
-        expect do
-          conf = Configuration.new
-          conf.alpha = :value
-          conf.bravo = conf.alpha
-          conf.charlie conf.bravo
-        end.to_not raise_error
-        conf.should_not be_nil
-        conf.alpha.should == :value
-        conf.bravo.should == :value
-        conf.charlie.should == :value
+      it 'treats hash without brackets after multiple values as last element of array' do
+        conf = Configuration.new
+        conf.alpha 1, 2, 3, :a => 4, :b => 5, :c => 6
+        conf.alpha.should == [ 1, 2, 3, { 'a' => 4, 'b' => 5, 'c' => 6} ] and conf.alpha.should be_a Array
       end
 
-      it 'returns value when creating/changing a setting' do
+    end # multiple value setting
+
+    context 'hash operators [] & []= access' do
+
+      it 'accepts symbol keys' do
         conf = nil
         expect do
           conf = Configuration.new
-          conf.bravo = conf.alpha = :value
+          conf[:alpha] = 1
         end.to_not raise_error
-        conf.should_not be_nil
-        conf.alpha.should == :value
-        conf.bravo.should == :value
+        conf[:alpha].should == 1
       end
 
-      it 'supports nested configuration via Configuration.new' do
+      it 'accepts non-symbol (string) keys' do
         conf = nil
         expect do
           conf = Configuration.new
-          conf.alpha true
-          conf.bravo Configuration.new
-          conf.bravo.charlie true
-          conf.bravo.delta Configuration.new
-          conf.bravo.delta.echo true
+          conf['alpha'] = 1
         end.to_not raise_error
         conf.should_not be_nil
-        conf.alpha.should be_true
-        conf.bravo.should be_a Configuration
-        conf.bravo.alpha should be_true
-        conf.bravo.charlie should be_true
-        conf.bravo.delta.should be_a Configuration
-        conf.bravo.delta.alpha.should be_true
-        conf.bravo.delta.charlie.should be_true
-        conf.bravo.delta.echo.should be_true
+        conf['alpha'].should == 1
       end
 
-    end # explicit
+    end # hash operators [] & []= access
 
-    context 'yield DSL' do
+    context 'nested configuration' do
 
-      it 'accepts settings without =' do
+      it 'is supported' do
         conf = nil
         expect do
-          conf = Configuration.new do |c|
-            c.alpha :value
-          end
+          conf = Configuration.new
+          conf.alpha Configuration.new
+          conf.alpha.bravo Configuration.new
+          conf.alpha.bravo.charlie true
         end.to_not raise_error
         conf.should_not be_nil
-        conf.alpha.should == :value
+        conf.alpha.should be_a Configuration
+        conf.alpha.bravo.should be_a Configuration
+        conf.alpha.bravo.charlie.should be_true
       end
 
-      it 'accepts settings with =' do
+      it 'knows its parent when referenced directly' do
         conf = nil
         expect do
-          conf = Configuration.new do |c|
-            c.alpha = :value
-          end
+          conf = Configuration.new
+          conf.alpha Configuration.new
+          conf.alpha.bravo Configuration.new
+          conf.alpha.bravo.charlie true
         end.to_not raise_error
         conf.should_not be_nil
-        conf.alpha.should == :value
+        conf.alpha.bravo.__send__(:_parent).should be conf.alpha
+        conf.alpha.__send__(:_parent).should be conf
+        conf.__send__(:_parent).should be_nil
       end
 
-      it 'can refer to an existing setting' do
+      it 'inherits settings' do
         conf = nil
         expect do
-          conf = Configuration.new do |c|
-            c.alpha = :value
-            c.bravo = c.alpha
-            c.charlie c.bravo
-          end
+          conf = Configuration.new
+          conf.alpha Configuration.new
+          conf.alpha.bravo Configuration.new
+          conf.top = true
+          conf.alpha.middle = true
+          conf.alpha.bravo.bottom = true
         end.to_not raise_error
         conf.should_not be_nil
-        conf.alpha.should == :value
-        conf.bravo.should == :value
-        conf.charlie.should == :value
+        conf.top.should be_true
+        conf.alpha.top.should be_true
+        conf.alpha.middle.should be_true
+        conf.alpha.bravo.top.should be_true
+        conf.alpha.bravo.middle.should be_true
+        conf.alpha.bravo.bottom.should be_true
       end
 
-      it 'returns value when creating/changing a setting' do
+      it 'can override inherited settings' do
         conf = nil
         expect do
-          conf = Configuration.new do |c|
-            c.bravo = c.alpha = :value
-          end
+          conf = Configuration.new
+          conf.alpha Configuration.new
+          conf.alpha.bravo Configuration.new
+          conf.level = 1
+          conf.alpha.level = 2
+          conf.alpha.bravo.level = 3
         end.to_not raise_error
         conf.should_not be_nil
-        conf.alpha.should == :value
-        conf.bravo.should == :value
+        conf.level.should == 1
+        conf.alpha.level.should == 2
+        conf.alpha.bravo.level.should == 3
       end
 
-      context 'nested configuration' do
+    end # nested configuration
+
+    context 'mode of usage' do
 
-        it 'supported via do..end' do
+      context 'explicit' do
+
+        it 'accepts settings without =' do
           conf = nil
           expect do
-            conf = Configuration.new do |c1|
-              c1.alpha true
-              c1.bravo do |c2|
-                c2.charlie true
-                c2.delta do |c3|
-                  c3.echo true
-                end
-              end
-            end
+            conf = Configuration.new
+            conf.alpha :value
           end.to_not raise_error
           conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_a Configuration
-          conf.bravo.alpha should be_true
-          conf.bravo.charlie should be_true
-          conf.bravo.delta.should be_a Configuration
-          conf.bravo.delta.alpha.should be_true
-          conf.bravo.delta.charlie.should be_true
-          conf.bravo.delta.echo.should be_true
+          conf.alpha.should == :value
         end
 
-        it 'supported via {..}' do
+        it 'accepts settings with =' do
           conf = nil
           expect do
-            conf = Configuration.new { |c1| c1.alpha true ; c1.bravo { |c2| c2.charlie true ; c2.delta { |c3| c3.echo true } } }
+            conf = Configuration.new
+            conf.alpha = :value
           end.to_not raise_error
           conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_a Configuration
-          conf.bravo.alpha should be_true
-          conf.bravo.charlie should be_true
-          conf.bravo.delta.should be_a Configuration
-          conf.bravo.delta.alpha.should be_true
-          conf.bravo.delta.charlie.should be_true
-          conf.bravo.delta.echo.should be_true
+          conf.alpha.should == :value
         end
 
-        it 'can refer to an inherited setting' do
+        it 'can refer to an existing setting' do
           conf = nil
           expect do
-            conf = Configuration.new do |c1|
-              c1.alpha true
-              c1.hotel c1.alpha
-              c1.bravo do |c2|
-                c2.charlie true
-                c2.foxtrot c2.alpha
-                c2.delta do |c3|
-                  c3.echo true
-                  c3.golf c3.alpha
-                end
-              end
-            end
+            conf = Configuration.new
+            conf.alpha = :value
+            conf.bravo = conf.alpha
+            conf.charlie conf.bravo
+          end.to_not raise_error
+          conf.should_not be_nil
+          conf.alpha.should == :value
+          conf.bravo.should == :value
+          conf.charlie.should == :value
+        end
+
+        it 'returns value when creating/changing a setting' do
+          conf = nil
+          expect do
+            conf = Configuration.new
+            conf.bravo = conf.alpha = :value
+          end.to_not raise_error
+          conf.should_not be_nil
+          conf.alpha.should == :value
+          conf.bravo.should == :value
+        end
+
+        it 'supports nested configuration via Configuration.new' do
+          conf = nil
+          expect do
+            conf = Configuration.new
+            conf.alpha true
+            conf.bravo Configuration.new
+            conf.bravo.charlie true
+            conf.bravo.delta Configuration.new
+            conf.bravo.delta.echo true
           end.to_not raise_error
           conf.should_not be_nil
           conf.alpha.should be_true
@@ -492,394 +372,592 @@ describe Configuration do
           conf.bravo.delta.alpha.should be_true
           conf.bravo.delta.charlie.should be_true
           conf.bravo.delta.echo.should be_true
-          conf.bravo.delta.golf.should be_true
-          conf.bravo.foxtrot.should be_true
-          conf.hotel.should be_true
         end
 
-      end # nested configuration
+      end # explicit
 
-      context 'can load' do
+      context 'yield DSL' do
 
-        it 'settings into the current configuration from a string' do
-          conf = Configuration.new do |c|
-            c.alpha false
-            c._read simple_eval_string
-            c.echo true
-          end
-          simple_configuration_example conf
-          conf.echo.should be_true
+        it 'accepts settings without =' do
+          conf = nil
+          expect do
+            conf = Configuration.new do |c|
+              c.alpha :value
+            end
+          end.to_not raise_error
+          conf.should_not be_nil
+          conf.alpha.should == :value
         end
 
-        it 'settings into the current configuration from a file (StringIO)' do
-          conf = Configuration.new do |c|
-            c.alpha false
-            c._load StringIO.new simple_eval_string
-            c.echo true
-          end
-          simple_configuration_example conf
-          conf.echo.should be_true
+        it 'accepts settings with =' do
+          conf = nil
+          expect do
+            conf = Configuration.new do |c|
+              c.alpha = :value
+            end
+          end.to_not raise_error
+          conf.should_not be_nil
+          conf.alpha.should == :value
         end
 
-        it 'settings into a nested configuration from a string' do
-          conf = Configuration.new do |c|
-            c.alpha true
-            c.bravo do |x|
-              x._read simple_eval_string
+        it 'can refer to an existing setting' do
+          conf = nil
+          expect do
+            conf = Configuration.new do |c|
+              c.alpha = :value
+              c.bravo = c.alpha
+              c.charlie c.bravo
             end
-            c.echo { |x| x._read simple_eval_string }
-            c.foxtrot true
-          end
-          nested_configuration_example conf
+          end.to_not raise_error
+          conf.should_not be_nil
+          conf.alpha.should == :value
+          conf.bravo.should == :value
+          conf.charlie.should == :value
         end
 
-        it 'settings into a nested configuration from a file (StringIO)' do
-          conf = Configuration.new do |c|
-            c.alpha true
-            c.bravo do |x|
-              x._load StringIO.new simple_eval_string
+        it 'returns value when creating/changing a setting' do
+          conf = nil
+          expect do
+            conf = Configuration.new do |c|
+              c.bravo = c.alpha = :value
             end
-            c.echo { |x| x._load StringIO.new simple_eval_string }
-            c.foxtrot true
-          end
-          nested_configuration_example conf
+          end.to_not raise_error
+          conf.should_not be_nil
+          conf.alpha.should == :value
+          conf.bravo.should == :value
         end
 
-      end # can load
-
-    end # yield DSL
-
-    context 'instance_eval DSL' do
+        context 'nested configuration' do
+
+          it 'supported via do..end' do
+            conf = nil
+            expect do
+              conf = Configuration.new do |c1|
+                c1.alpha true
+                c1.bravo do |c2|
+                  c2.charlie true
+                  c2.delta do |c3|
+                    c3.echo true
+                  end
+                end
+              end
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_a Configuration
+            conf.bravo.alpha should be_true
+            conf.bravo.charlie should be_true
+            conf.bravo.delta.should be_a Configuration
+            conf.bravo.delta.alpha.should be_true
+            conf.bravo.delta.charlie.should be_true
+            conf.bravo.delta.echo.should be_true
+          end
 
-      it 'accepts settings without =' do
-        conf = nil
-        expect do
-          conf = Configuration.new do
-            alpha :value
+          it 'supported via {..}' do
+            conf = nil
+            expect do
+              conf = Configuration.new { |c1| c1.alpha true ; c1.bravo { |c2| c2.charlie true ; c2.delta { |c3| c3.echo true } } }
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_a Configuration
+            conf.bravo.alpha should be_true
+            conf.bravo.charlie should be_true
+            conf.bravo.delta.should be_a Configuration
+            conf.bravo.delta.alpha.should be_true
+            conf.bravo.delta.charlie.should be_true
+            conf.bravo.delta.echo.should be_true
           end
-        end.to_not raise_error
-        conf.should_not be_nil
-        conf.alpha.should == :value
-      end
 
-      it 'sets local variables with =' do
-        conf = alpha = nil
-        expect do
-          alpha = nil
-          conf = Configuration.new do
-            alpha = :value
-            bravo alpha
+          it 'can refer to an inherited setting' do
+            conf = nil
+            expect do
+              conf = Configuration.new do |c1|
+                c1.alpha true
+                c1.hotel c1.alpha
+                c1.bravo do |c2|
+                  c2.charlie true
+                  c2.foxtrot c2.alpha
+                  c2.delta do |c3|
+                    c3.echo true
+                    c3.golf c3.alpha
+                  end
+                end
+              end
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_a Configuration
+            conf.bravo.alpha should be_true
+            conf.bravo.charlie should be_true
+            conf.bravo.delta.should be_a Configuration
+            conf.bravo.delta.alpha.should be_true
+            conf.bravo.delta.charlie.should be_true
+            conf.bravo.delta.echo.should be_true
+            conf.bravo.delta.golf.should be_true
+            conf.bravo.foxtrot.should be_true
+            conf.hotel.should be_true
           end
-        end.to_not raise_error
-        conf.should_not be_nil
-        conf.alpha.should be_nil
-        conf.bravo.should == :value
-        alpha.should == :value        # local alpha set by matching variables
-      end
 
-      it 'can refer to an existing setting' do
-        conf = nil
-        expect do
-          conf = Configuration.new do
-            alpha :value
-            bravo alpha
-            charlie bravo
+        end # nested configuration
+
+        context 'can load' do
+
+          it 'settings into the current configuration from a string' do
+            conf = Configuration.new do |c|
+              c.alpha false
+              c._read simple_eval_string
+              c.echo true
+            end
+            simple_configuration_example conf
+            conf.echo.should be_true
           end
-        end.to_not raise_error
-        conf.should_not be_nil
-        conf.alpha.should == :value
-        conf.bravo.should == :value
-        conf.charlie.should == :value
-      end
 
-      it 'returns value when creating/changing a setting' do
-        conf = nil
-        expect do
-          conf = Configuration.new do
-            bravo alpha :value
+          it 'settings into the current configuration from a file (StringIO)' do
+            conf = Configuration.new do |c|
+              c.alpha false
+              c._load StringIO.new simple_eval_string
+              c.echo true
+            end
+            simple_configuration_example conf
+            conf.echo.should be_true
           end
-        end.to_not raise_error
-        conf.should_not be_nil
-        conf.alpha.should == :value
-        conf.bravo.should == :value
-      end
 
-      context 'nested configuration' do
+          it 'settings into a nested configuration from a string' do
+            conf = Configuration.new do |c|
+              c.alpha true
+              c.bravo do |x|
+                x._read simple_eval_string
+              end
+              c.echo { |x| x._read simple_eval_string }
+              c.foxtrot true
+            end
+            nested_configuration_example conf
+          end
 
-        it 'supported via do..end' do
-          conf = nil
-          expect do
-            conf = Configuration.new do
-              alpha true
-              bravo do
-                charlie true
-                delta do
-                  echo true
-                end
+          it 'settings into a nested configuration from a file (StringIO)' do
+            conf = Configuration.new do |c|
+              c.alpha true
+              c.bravo do |x|
+                x._load StringIO.new simple_eval_string
               end
+              c.echo { |x| x._load StringIO.new simple_eval_string }
+              c.foxtrot true
             end
-          end.to_not raise_error
-          conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_a Configuration
-          conf.bravo.alpha should be_true
-          conf.bravo.charlie should be_true
-          conf.bravo.delta.should be_a Configuration
-          conf.bravo.delta.alpha.should be_true
-          conf.bravo.delta.charlie.should be_true
-          conf.bravo.delta.echo.should be_true
-        end
+            nested_configuration_example conf
+          end
 
-        it 'supported via {..}' do
-          conf = nil
-          expect do
-            conf = Configuration.new { |c1| c1.alpha true ; c1.bravo { |c2| c2.charlie true ; c2.delta { |c3| c3.echo true } } }
-          end.to_not raise_error
-          conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_a Configuration
-          conf.bravo.alpha should be_true
-          conf.bravo.charlie should be_true
-          conf.bravo.delta.should be_a Configuration
-          conf.bravo.delta.alpha.should be_true
-          conf.bravo.delta.charlie.should be_true
-          conf.bravo.delta.echo.should be_true
-        end
+        end # can load
+
+      end # yield DSL
 
-        it 'can refer to an inherited setting' do
+      context 'instance_eval DSL' do
+
+        it 'accepts settings without =' do
           conf = nil
           expect do
             conf = Configuration.new do
-              alpha true
-              hotel alpha
-              bravo do
-                charlie true
-                foxtrot alpha
-                delta do
-                  echo true
-                  golf alpha
-                end
-              end
+              alpha :value
             end
           end.to_not raise_error
           conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_a Configuration
-          conf.bravo.alpha should be_true
-          conf.bravo.charlie should be_true
-          conf.bravo.delta.should be_a Configuration
-          conf.bravo.delta.alpha.should be_true
-          conf.bravo.delta.charlie.should be_true
-          conf.bravo.delta.echo.should be_true
-          conf.bravo.delta.golf.should be_true
-          conf.bravo.foxtrot.should be_true
-          conf.hotel.should be_true
+          conf.alpha.should == :value
         end
 
-      end # nested configuration
-
-      context 'dynamic setting' do
-
-        it 'name can be a local' do
-          conf = nil
+        it 'sets local variables with =' do
+          conf = alpha = nil
           expect do
+            alpha = nil
             conf = Configuration.new do
-              alpha true
-              local1 = 'bravo'
-              self[local1] = true
-              local2 = 'charlie'
-              self[local2] = true
+              alpha = :value
+              bravo alpha
             end
           end.to_not raise_error
           conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_true
-          conf.charlie.should be_true
+          conf.alpha.should be_nil
+          conf.bravo.should == :value
+          alpha.should == :value        # local alpha set by matching variables
         end
 
-        it 'name can be a setting' do
+        it 'can refer to an existing setting' do
           conf = nil
           expect do
             conf = Configuration.new do
-              alpha true
-              setting1 'bravo'
-              self[setting1] = true
-              setting2 'charlie'
-              self[setting2] = true
+              alpha :value
+              bravo alpha
+              charlie bravo
             end
           end.to_not raise_error
           conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_true
-          conf.charlie.should be_true
-          conf.setting1.should == 'bravo'
-          conf.setting2.should == 'charlie'
+          conf.alpha.should == :value
+          conf.bravo.should == :value
+          conf.charlie.should == :value
         end
 
-        it 'can reference a nested configuration' do
+        it 'returns value when creating/changing a setting' do
           conf = nil
           expect do
             conf = Configuration.new do
-              alpha true
-              local = :bravo
-              self[local] = Configuration.new do
-                charlie true
-              end
+              bravo alpha :value
             end
           end.to_not raise_error
           conf.should_not be_nil
-          conf.alpha.should be_true
-          conf.bravo.should be_a Configuration
-          conf.bravo.alpha should be_true
-          conf.bravo.charlie should be_true
+          conf.alpha.should == :value
+          conf.bravo.should == :value
         end
 
-      end # dynamic setting
+        context 'nested configuration' do
+
+          it 'supported via do..end' do
+            conf = nil
+            expect do
+              conf = Configuration.new do
+                alpha true
+                bravo do
+                  charlie true
+                  delta do
+                    echo true
+                  end
+                end
+              end
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_a Configuration
+            conf.bravo.alpha should be_true
+            conf.bravo.charlie should be_true
+            conf.bravo.delta.should be_a Configuration
+            conf.bravo.delta.alpha.should be_true
+            conf.bravo.delta.charlie.should be_true
+            conf.bravo.delta.echo.should be_true
+          end
 
-      context 'can load' do
+          it 'supported via {..}' do
+            conf = nil
+            expect do
+              conf = Configuration.new { |c1| c1.alpha true ; c1.bravo { |c2| c2.charlie true ; c2.delta { |c3| c3.echo true } } }
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_a Configuration
+            conf.bravo.alpha should be_true
+            conf.bravo.charlie should be_true
+            conf.bravo.delta.should be_a Configuration
+            conf.bravo.delta.alpha.should be_true
+            conf.bravo.delta.charlie.should be_true
+            conf.bravo.delta.echo.should be_true
+          end
 
-        it 'settings into the current configuration from a string' do
-          $simple_eval_string = simple_eval_string
-          conf = Configuration.new do
-            alpha true
-            _read $simple_eval_string
+          it 'can refer to an inherited setting' do
+            conf = nil
+            expect do
+              conf = Configuration.new do
+                alpha true
+                hotel alpha
+                bravo do
+                  charlie true
+                  foxtrot alpha
+                  delta do
+                    echo true
+                    golf alpha
+                  end
+                end
+              end
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_a Configuration
+            conf.bravo.alpha should be_true
+            conf.bravo.charlie should be_true
+            conf.bravo.delta.should be_a Configuration
+            conf.bravo.delta.alpha.should be_true
+            conf.bravo.delta.charlie.should be_true
+            conf.bravo.delta.echo.should be_true
+            conf.bravo.delta.golf.should be_true
+            conf.bravo.foxtrot.should be_true
+            conf.hotel.should be_true
           end
-          simple_configuration_example conf
-        end
 
-        it 'settings into the current configuration from a file (StringIO)' do
-          $simple_eval_string = simple_eval_string
-          conf = Configuration.new do
-            alpha true
-            _load StringIO.new $simple_eval_string
+        end # nested configuration
+
+        context 'dynamic setting' do
+
+          it 'name can be a local' do
+            conf = nil
+            expect do
+              conf = Configuration.new do
+                alpha true
+                local1 = 'bravo'
+                self[local1] = true
+                local2 = 'charlie'
+                self[local2] = true
+              end
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_true
+            conf.charlie.should be_true
           end
-          simple_configuration_example conf
-        end
 
-        it 'settings into a nested configuration from a string' do
-          $simple_eval_string = simple_eval_string
-          conf = Configuration.new do
-            alpha true
-            bravo do
+          it 'name can be a setting' do
+            conf = nil
+            expect do
+              conf = Configuration.new do
+                alpha true
+                setting1 'bravo'
+                self[setting1] = true
+                setting2 'charlie'
+                self[setting2] = true
+              end
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_true
+            conf.charlie.should be_true
+            conf.setting1.should == 'bravo'
+            conf.setting2.should == 'charlie'
+          end
+
+          it 'can reference a nested configuration' do
+            conf = nil
+            expect do
+              conf = Configuration.new do
+                alpha true
+                local = :bravo
+                self[local] = Configuration.new do
+                  charlie true
+                end
+              end
+            end.to_not raise_error
+            conf.should_not be_nil
+            conf.alpha.should be_true
+            conf.bravo.should be_a Configuration
+            conf.bravo.alpha should be_true
+            conf.bravo.charlie should be_true
+          end
+
+        end # dynamic setting
+
+        context 'can load' do
+
+          it 'settings into the current configuration from a string' do
+            $simple_eval_string = simple_eval_string
+            conf = Configuration.new do
+              alpha true
               _read $simple_eval_string
             end
-            echo { _read $simple_eval_string }
-            foxtrot true
+            simple_configuration_example conf
           end
-          nested_configuration_example conf
-        end
 
-        it 'settings into a nested configuration from a file (StringIO)' do
-          conf = Configuration.new do
-            alpha true
-            bravo do
+          it 'settings into the current configuration from a file (StringIO)' do
+            $simple_eval_string = simple_eval_string
+            conf = Configuration.new do
+              alpha true
               _load StringIO.new $simple_eval_string
             end
-            echo { _load StringIO.new $simple_eval_string }
-            foxtrot true
+            simple_configuration_example conf
+          end
+
+          it 'settings into a nested configuration from a string' do
+            $simple_eval_string = simple_eval_string
+            conf = Configuration.new do
+              alpha true
+              bravo do
+                _read $simple_eval_string
+              end
+              echo { _read $simple_eval_string }
+              foxtrot true
+            end
+            nested_configuration_example conf
           end
-          nested_configuration_example conf
-        end
 
-      end # can load
+          it 'settings into a nested configuration from a file (StringIO)' do
+            conf = Configuration.new do
+              alpha true
+              bravo do
+                _load StringIO.new $simple_eval_string
+              end
+              echo { _load StringIO.new $simple_eval_string }
+              foxtrot true
+            end
+            nested_configuration_example conf
+          end
 
-    end # instance_eval DSL
+        end # can load
 
-  end # mode of usage
+      end # instance_eval DSL
 
-  context 'merge' do
+    end # mode of usage
 
-    it 'can update its own configuration' do
-      orig = simple_explicit_configuration
-      orig.echo :original1
-      orig.foxtrot :original2
-      other = Configuration.new do
-                foxtrot :overridden
-                hotel :new
-              end
-      conf = orig._merge! other
-      simple_configuration_example conf
-      conf.echo.should be :original1
-      conf.hotel.should be :new
-      conf.foxtrot.should be :overridden
-      conf.__send__(:_parent).should be nil
-      conf.should be orig
-    end
+    context 'merge' do
 
-    it 'can create a new configuration' do
-      orig = simple_explicit_configuration
-      orig.echo :original1
-      orig.foxtrot :original2
-      other = Configuration.new do
-                foxtrot :overridden
-                hotel :new
-              end
-      conf = orig._merge other
-      simple_configuration_example conf
-      conf.echo.should be :original1
-      conf.hotel.should be :new
-      conf.foxtrot.should be :overridden
-      conf.__send__(:_parent).should be nil
-      conf.should_not be orig
-    end
+      it 'updates its own configuration' do
+        orig = simple_explicit_configuration
+        orig.echo :original1
+        orig.foxtrot :original2
+        other = Configuration.new do
+                  foxtrot :overridden
+                  hotel :new
+                end
+        conf = orig._merge! other
+        simple_configuration_example conf
+        conf.echo.should be :original1
+        conf.hotel.should be :new
+        conf.foxtrot.should be :overridden
+        conf.__send__(:_parent).should be nil
+        conf.should be orig
+      end
 
-    it 'can update with a nested configuration' do
-      orig = simple_explicit_configuration
-      orig.echo    :original1
-      orig.foxtrot :original2
-      other = Configuration.new do
-                foxtrot :overridden
-                hotel   :new
-                nested do
-                  golf  :also_new
-                  hotel :overridden
-                  echo  :overridden
+      it 'creates a new configuration' do
+        orig = simple_explicit_configuration
+        orig.echo :original1
+        orig.foxtrot :original2
+        other = Configuration.new do
+                  foxtrot :overridden
+                  hotel :new
                 end
-              end
-      conf = orig._merge! other
-      simple_configuration_example conf
-      conf.echo.should be :original1
-      conf.hotel.should be :new
-      conf.foxtrot.should be :overridden
-      conf.nested.alpha.should be 1
-      conf.nested.echo.should be :overridden
-      conf.nested.foxtrot.should be :overridden
-      conf.nested.golf.should be :also_new
-      conf.nested.hotel.should be :overridden
-      conf.nested.__send__(:_parent).should be conf
-      conf.__send__(:_parent).should be nil
-      conf.should be orig
-    end
+        conf = orig._merge other
+        simple_configuration_example conf
+        conf.echo.should be :original1
+        conf.hotel.should be :new
+        conf.foxtrot.should be :overridden
+        conf.__send__(:_parent).should be nil
+        conf.should_not be orig
+      end
 
-    it 'can create with a nested configuration' do
-      orig = simple_explicit_configuration
-      orig.echo    :original1
-      orig.foxtrot :original2
-      other = Configuration.new do
-                foxtrot :overridden
-                hotel   :new
-                nested do
-                  golf  :also_new
-                  hotel :overridden
-                  echo  :overridden
+      it 'updates with a nested configuration' do
+        orig = simple_explicit_configuration
+        orig.echo    :original1
+        orig.foxtrot :original2
+        other = Configuration.new do
+                  foxtrot :overridden
+                  hotel   :new
+                  nested do
+                    golf  :also_new
+                    hotel :overridden
+                    echo  :overridden
+                  end
                 end
-              end
-      conf = orig._merge other
-      simple_configuration_example conf
-      conf.echo.should be :original1
-      conf.hotel.should be :new
-      conf.foxtrot.should be :overridden
-      conf.nested.alpha.should be 1
-      conf.nested.echo.should be :overridden
-      conf.nested.foxtrot.should be :overridden
-      conf.nested.golf.should be :also_new
-      conf.nested.hotel.should be :overridden
-      conf.nested.__send__(:_parent).should be conf
-      conf.__send__(:_parent).should be nil
-      conf.should_not be orig
+        conf = orig._merge! other
+        simple_configuration_example conf
+        conf.echo.should be :original1
+        conf.hotel.should be :new
+        conf.foxtrot.should be :overridden
+        conf.nested.alpha.should be 1
+        conf.nested.echo.should be :overridden
+        conf.nested.foxtrot.should be :overridden
+        conf.nested.golf.should be :also_new
+        conf.nested.hotel.should be :overridden
+        conf.nested.__send__(:_parent).should be conf
+        conf.__send__(:_parent).should be nil
+        conf.should be orig
+      end
+
+      it 'creates with a nested configuration' do
+        orig = simple_explicit_configuration
+        orig.echo    :original1
+        orig.foxtrot :original2
+        other = Configuration.new do
+                  foxtrot :overridden
+                  hotel   :new
+                  nested do
+                    golf  :also_new
+                    hotel :overridden
+                    echo  :overridden
+                  end
+                end
+        conf = orig._merge other
+        simple_configuration_example conf
+        conf.echo.should be :original1
+        conf.hotel.should be :new
+        conf.foxtrot.should be :overridden
+        conf.nested.alpha.should be 1
+        conf.nested.echo.should be :overridden
+        conf.nested.foxtrot.should be :overridden
+        conf.nested.golf.should be :also_new
+        conf.nested.hotel.should be :overridden
+        conf.nested.__send__(:_parent).should be conf
+        conf.__send__(:_parent).should be nil
+        conf.should_not be orig
+      end
+
+      it 'updates by recursively merging conflicting nested configurations' do
+        orig = simple_explicit_configuration
+        orig.nested1 = Configuration.new do
+          echo    :original
+          foxtrot :original
+          nested2 do
+            golf  :original
+            hotel :original
+          end
+        end
+        other = Configuration.new do
+          nested1 do
+            echo  :replaced
+            india :new
+            nested2 do
+              golf :replaced
+              juliet :new
+            end
+          end
+        end
+        conf = orig._merge! other
+        simple_configuration_example conf
+        conf.nested1.echo.should be :replaced
+        conf.nested1.foxtrot.should be :original
+        conf.nested1.india.should be :new
+        conf.nested1.nested2.golf.should be :replaced
+        conf.nested1.nested2.hotel.should be :original
+        conf.nested1.nested2.juliet.should be :new
+        conf.nested1.__send__(:_parent).should be conf
+        conf.__send__(:_parent).should be nil
+        conf.should be orig
+      end
+
+      it 'creates by recursively merging conflicting nested configurations' do
+        orig = simple_explicit_configuration
+        orig.nested1 = Configuration.new do
+          echo    :original
+          foxtrot :original
+          nested2 do
+            golf  :original
+            hotel :original
+          end
+        end
+        other = Configuration.new do
+          nested1 do
+            echo  :replaced
+            india :new
+            nested2 do
+              golf :replaced
+              juliet :new
+            end
+          end
+        end
+        conf = orig._merge other
+        simple_configuration_example conf
+        conf.nested1.echo.should be :replaced
+        conf.nested1.foxtrot.should be :original
+        conf.nested1.india.should be :new
+        conf.nested1.nested2.golf.should be :replaced
+        conf.nested1.nested2.hotel.should be :original
+        conf.nested1.nested2.juliet.should be :new
+        conf.nested1.__send__(:_parent).should be conf
+        conf.__send__(:_parent).should be nil
+        conf.should_not be orig
+      end
+
     end
 
-  end
+  end # "v1.0"
+
+  #context 'v1.1' do
+  #
+  #  context 'merge' do
+  #
+  #  end
+  #
+  #end #v1.1
 
 end