iqeo-conf 1.0.1 → 1.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 060e0a2e9dc2deb6a741f7d914a3b551ba80c9b4bbdf5436704e50b270406a5f
+  data.tar.gz: c8ad2d06e8b258f211c273635a65222d39cf2e2110306b178722899429b6783d
+SHA512:
+  metadata.gz: 30bd99bf790acbf6008b8d36037ef76f350ca9792b067c82f46e742f9280bcd9c0a51925b17ff2d094e01c1108a09f761ee29949c65223e1dae396acefeb4418
+  data.tar.gz: ed1dce1772edc9d2dab9016f4b628b060ef923d1dc8fda19da6caf46f35a1338295f41f2551a5f23c94e62d6658d5049385a1ca5165e76f47817c2d89012e9d9

data/.gitignore

@@ -1,4 +1,18 @@
-.idea/
-.rspec
-.rvmrc
-pkg/
+*.gem
+*.rbc
+*.swp
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format doc

data/.ruby-gemset

@@ -0,0 +1 @@
+iqeo-conf

data/.ruby-version

@@ -0,0 +1 @@
+ruby-3.4.4

data/Gemfile

@@ -1,3 +1,12 @@
 source 'https://rubygems.org'
 
 gemspec
+
+group :development, :test do
+  gem "rake", "~> 13.3"
+  gem "rdoc", "~> 6.14"
+  gem "redcarpet", "~> 3.6"
+  gem "rspec", "~> 3.13"
+  gem "yard", "~> 0.9.37"
+end
+

data/Gemfile.lock

@@ -1,34 +1,49 @@
 PATH
   remote: .
   specs:
-    iqeo-conf (1.1.0)
+    iqeo-conf (1.1.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    diff-lcs (1.1.3)
-    json (1.7.1)
-    rake (0.9.2.2)
-    rdoc (3.12)
-      json (~> 1.4)
-    redcarpet (2.1.1)
-    rspec (2.10.0)
-      rspec-core (~> 2.10.0)
-      rspec-expectations (~> 2.10.0)
-      rspec-mocks (~> 2.10.0)
-    rspec-core (2.10.0)
-    rspec-expectations (2.10.0)
-      diff-lcs (~> 1.1.3)
-    rspec-mocks (2.10.1)
-    yard (0.8.1)
+    date (3.4.1)
+    diff-lcs (1.6.2)
+    erb (5.0.2)
+    psych (5.2.6)
+      date
+      stringio
+    rake (13.3.0)
+    rdoc (6.14.2)
+      erb
+      psych (>= 4.0.0)
+    redcarpet (3.6.1)
+    rspec (3.13.1)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.5)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.4)
+    stringio (3.1.7)
+    yard (0.9.37)
 
 PLATFORMS
   ruby
+  x86_64-linux
 
 DEPENDENCIES
   iqeo-conf!
-  rake (~> 0.9.2)
-  rdoc (~> 3.12.0)
-  redcarpet (~> 2.1.1)
-  rspec (~> 2.10.0)
-  yard (~> 0.8.1)
+  rake (~> 13.3)
+  rdoc (~> 6.14)
+  redcarpet (~> 3.6)
+  rspec (~> 3.13)
+  yard (~> 0.9.37)
+
+BUNDLED WITH
+   2.6.7

data/README.md

@@ -1,5 +1,8 @@
 # Iqeo::Configuration
 
+[![Gem Version](https://badge.fury.io/rb/iqeo-conf.png)](http://badge.fury.io/rb/iqeo-conf)
+[![Build Status](https://travis-ci.org/iqeo/iqeo-conf.png?branch=master)](https://travis-ci.org/iqeo/iqeo-conf)
+
 A DSL representing configuration files.
 
 ## Installation
@@ -121,12 +124,14 @@ conf.collect { |key,value| value }  # => [ 1, 2.0, :three, 'four' ]
 * defaults
 * merge configurations recursively
 * blank slate for DSL
+* wildcard * for chained usage: a.b.*.d
 
-## Fancy usage
+## Application
 
 * Dynamic settings by '[]' & '[]=' & 'self'
 * Multiple configuration files
 * Hierarchial configuration files
+* Validation: if a.b.*.d == true
 
 ## License
 

data/iqeo-conf.gemspec

@@ -1,23 +1,15 @@
 # -*- encoding: utf-8 -*-
-require File.expand_path('../lib/iqeo/configuration/version', __FILE__)
+require File.expand_path('../lib/iqeo/configuration', __FILE__)
 
 Gem::Specification.new do |gem|
-  gem.authors       = ["Gerard Fowley"]
-  gem.email         = ["gerard.fowley@iqeo.net"]
-  gem.description   = %q{A configuration DSL}
-  gem.summary       = %q{A DSL for writing configuration files}
-  gem.homepage      = "http://iqeo.github.com/iqeo-conf"
-  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  gem.files         = `git ls-files`.split("\n")
-  gem.test_files    = `git ls-files -- {spec}/*`.split("\n")
   gem.name          = "iqeo-conf"
-  gem.require_paths = ["lib"]
-  gem.version       = Iqeo::CONFIGURATION_VERSION
-
-  gem.add_development_dependency "rake",      "~> 0.9.2"
-  gem.add_development_dependency "rspec",     "~> 2.10.0"
-  gem.add_development_dependency "yard",      "~> 0.8.1"
-  gem.add_development_dependency "rdoc",      "~> 3.12.0"
-  gem.add_development_dependency "redcarpet", "~> 2.1.1"
-
+  gem.author        = "Gerard Fowley"
+  gem.email         = "gerard.fowley@iqeo.net"
+  gem.description   = "A configuration DSL"
+  gem.summary       = "A DSL for writing configuration files"
+  gem.homepage      = "http://github.com/iqeo/iqeo-conf"
+  gem.license       = "GPL-3.0"
+  gem.files         = `git ls-files`.split("\n")
+  gem.metadata      = { "rubygems_mfa_required" => "true" }
+  gem.version       = Iqeo::Configuration::VERSION
 end

data/lib/iqeo/configuration.rb

@@ -1,5 +1,5 @@
 
-require_relative "configuration/version"
+# require_relative "configuration/version"
 require_relative "configuration/hash_with_indifferent_access"
 
 # Iqeo namespace
@@ -24,7 +24,7 @@ module Iqeo
 
     instance_methods_to_undef = %w(
       !                     !=                      !~                         <=>
-      ==                    ===                     =~                         class
+      ==                    ===                     class
       clone                 define_singleton_method display                    enum_for
       eql?                  extend                  freeze                     frozen?
       hash                  initialize_clone        initialize_dup             inspect
@@ -32,9 +32,8 @@ module Iqeo
       instance_variable_set instance_variables      method                     methods
       nil?                  private_methods         protected_methods          public_method
       public_methods        public_send             respond_to?                respond_to_missing?
-      send                  singleton_class         singleton_methods          taint
-      tainted?              tap                     to_enum                    to_s
-      trust                 untaint                 untrust                    untrusted?
+      send                  singleton_class         singleton_methods
+      tap                   to_enum                 to_s
     )
 
     instance_methods_to_undef.each do |meth|
@@ -51,16 +50,18 @@ module Iqeo
 
     # Returns Configuration version number.
 
+    VERSION = '1.1.1'
+
     def self.version
-      Iqeo::CONFIGURATION_VERSION
+      VERSION
     end
 
     # Creates a new Configuration instance from string.
     #
     # Content should be in eval DSL format.
 
-    def self.read string
-      conf = self.new
+    def self.read string, options = {}
+      conf = self.new nil, options
       conf.instance_eval string
       conf
     end
@@ -69,12 +70,12 @@ module Iqeo
     #
     # Content should be in eval DSL format.
 
-    def self.load file
+    def self.load file, options = {}
       return self.read file.respond_to?(:read) ? file.read : File.read(file)
     end
 
-    def self.new_defer_block_for_parent parent, &block
-      conf = Configuration.new
+    def self.new_defer_block_for_parent parent, options = {}, &block
+      conf = Configuration.new nil, options
       conf._parent = parent
       if block_given? && block.arity > 0
         block.call(conf)                                              # this is 'yield self' from the outside
@@ -82,9 +83,18 @@ module Iqeo
       conf
     end
 
-    attr_accessor :_parent, :_items
+    OPTIONS = {
+      :blankslate => true,
+      :case_sensitive => true
+    }
+
+    attr_accessor :_parent, :_items, :_options
+
+    # todo: why can't :_parent= be protected ?
+    #protected :_parent, :_items, :_items= #, :_get, :[], :_set, :[]=
 
-    def initialize default = nil, &block
+    def initialize default = nil, options = {}, &block
+      _process_options options
       @_items = HashWithIndifferentAccess.new
       @_parent = nil
       _merge! default if default.kind_of?( Configuration )
@@ -105,11 +115,11 @@ module Iqeo
 
       name = name.to_s.chomp('=')
 
-      if block_given?                                                 # block is a nested configuration
-        if block.arity == 1                                           # yield DSL needs deferred block to set parent without binding
-          return _set name, Configuration.new_defer_block_for_parent( self, &block )
+      if block_given?                                                  # block is a nested configuration
+        if block.arity == 1                                            # yield DSL needs deferred block to set parent without binding
+          return _set name, Configuration.new_defer_block_for_parent( self, @_options, &block )
         else
-          return _set name, Configuration.new( &block )               # eval DSL can set parent from block binding in initialize
+          return _set name, Configuration.new( nil, @_options, &block ) # eval DSL can set parent from block binding in initialize
         end
       end
 
@@ -161,9 +171,45 @@ module Iqeo
       self.dup._merge! other
     end
 
-    # todo: why can't :_parent= be protected ?
+    def _configurations
+      @_items.values.select { |value| value.kind_of? Configuration }
+    end
+
+    def _process_options options
+      @_options = OPTIONS.merge options
+      #_wipe if @_options[:blankslate]         # todo: how to make blankslate optional ?
+    end
+
+    # todo: method '*' for wildcard dir glob like selections  eg top.*.bottom ?
+
+    def *
+      ConfigurationDelegator.new _configurations
+    end
+
+  end
+
+  class ConfigurationDelegator  # todo: inherit from < Blankslate ?
+
+    attr_reader :_confs
+
+    # protected :_confs
+
+    def initialize confs
+      @_confs = confs
+    end
 
-    protected :_parent, :_items, :_items=, :_get, :[], :_set, :[]=
+    def method_missing name, *values, &block
+      return @_confs.send( name, *values, &block ) if @_confs.respond_to? name     # @_confs methods are highest priority
+    end
+    #alias [] method_missing  # so we don't have to deal with [ and 'key' separately ( see alias [] _get in Configuration )
+
+    def empty?
+      @_confs.empty?
+    end
+
+    def *
+      ConfigurationDelegator.new( @_confs.inject([]) { |array,conf| array + conf._configurations } )
+    end
 
   end
 

data/spec/configuration_spec.rb

@@ -24,25 +24,25 @@ describe Configuration do
 
   def simple_configuration_example conf
     conf.should_not be_nil
-    conf.alpha.should   == 1     and conf.alpha.should be_a Fixnum
+    conf.alpha.should   == 1     and conf.alpha.should be_a Integer
     conf.bravo.should   == "two" and conf.bravo.should be_a String
     conf.charlie.should == 3.0   and conf.charlie.should be_a Float
     conf.delta.should   == :four and conf.delta.should be_a Symbol
   end
 
   def nested_configuration_example conf
-    conf.alpha.should be_true
-    conf.foxtrot.should be_true
+    conf.alpha.should be true
+    conf.foxtrot.should be true
     simple_configuration_example conf.bravo
-    conf.bravo.foxtrot.should be_true
+    conf.bravo.foxtrot.should be true
     simple_configuration_example conf.echo
-    conf.echo.foxtrot.should be_true
+    conf.echo.foxtrot.should be true
   end
 
   context 'v1.0' do
 
     it 'reports the correct version' do
-      Configuration.version.should == CONFIGURATION_VERSION
+      Configuration.version.should == '1.1.1'
     end
 
     context 'at creation' do
@@ -89,10 +89,10 @@ describe Configuration do
 
       it 'overrides defaults from another configuration' do
         conf_default = Configuration.new( simple_explicit_configuration ) { echo true }
-        conf_default.echo.should be_true
+        conf_default.echo.should be true
         conf = Configuration.new( conf_default ) { echo false }
         simple_configuration_example conf
-        conf.echo.should be_false
+        conf.echo.should be false
       end
 
       context 'can load' do
@@ -105,18 +105,6 @@ describe Configuration do
           simple_configuration_example Configuration.load StringIO.new simple_eval_string
         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
-        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"
-        end
-
         it 'complex eval DSL from string' do
           string = "alpha true
                     bravo do
@@ -127,14 +115,14 @@ describe Configuration do
                     end"
           conf = Configuration.read string
           conf.should_not be_nil
-          conf.alpha.should be_true
+          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.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.alpha.should be true
+          conf.bravo.delta.charlie.should be true
+          conf.bravo.delta.echo.should be true
         end
 
       end # loads
@@ -250,7 +238,7 @@ describe Configuration do
         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
+        conf.alpha.bravo.charlie.should be true
       end
 
       it 'knows its parent when referenced directly' do
@@ -278,12 +266,12 @@ describe Configuration do
           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
+        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 'can override inherited settings' do
@@ -364,14 +352,14 @@ describe Configuration do
             conf.bravo.delta.echo true
           end.to_not raise_error
           conf.should_not be_nil
-          conf.alpha.should be_true
+          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.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.alpha.should be true
+          conf.bravo.delta.charlie.should be true
+          conf.bravo.delta.echo.should be true
         end
 
       end # explicit
@@ -443,14 +431,14 @@ describe Configuration do
               end
             end.to_not raise_error
             conf.should_not be_nil
-            conf.alpha.should be_true
+            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.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.alpha.should be true
+            conf.bravo.delta.charlie.should be true
+            conf.bravo.delta.echo.should be true
           end
 
           it 'supported via {..}' do
@@ -459,14 +447,14 @@ describe Configuration 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.alpha.should be true
             conf.bravo.should be_a Configuration
-            conf.bravo.alpha should be_true
-            conf.bravo.charlie should be_true
+            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.alpha.should be true
+            conf.bravo.delta.charlie.should be true
+            conf.bravo.delta.echo.should be true
           end
 
           it 'can refer to an inherited setting' do
@@ -486,17 +474,17 @@ describe Configuration do
               end
             end.to_not raise_error
             conf.should_not be_nil
-            conf.alpha.should be_true
+            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.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.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
@@ -510,7 +498,7 @@ describe Configuration do
               c.echo true
             end
             simple_configuration_example conf
-            conf.echo.should be_true
+            conf.echo.should be true
           end
 
           it 'settings into the current configuration from a file (StringIO)' do
@@ -520,7 +508,7 @@ describe Configuration do
               c.echo true
             end
             simple_configuration_example conf
-            conf.echo.should be_true
+            conf.echo.should be true
           end
 
           it 'settings into a nested configuration from a string' do
@@ -622,14 +610,14 @@ describe Configuration do
               end
             end.to_not raise_error
             conf.should_not be_nil
-            conf.alpha.should be_true
+            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.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.alpha.should be true
+            conf.bravo.delta.charlie.should be true
+            conf.bravo.delta.echo.should be true
           end
 
           it 'supported via {..}' do
@@ -638,14 +626,14 @@ describe Configuration 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.alpha.should be true
             conf.bravo.should be_a Configuration
-            conf.bravo.alpha should be_true
-            conf.bravo.charlie should be_true
+            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.alpha.should be true
+            conf.bravo.delta.charlie.should be true
+            conf.bravo.delta.echo.should be true
           end
 
           it 'can refer to an inherited setting' do
@@ -665,17 +653,17 @@ describe Configuration do
               end
             end.to_not raise_error
             conf.should_not be_nil
-            conf.alpha.should be_true
+            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.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.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
@@ -694,9 +682,9 @@ describe Configuration do
               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 true
+            conf.bravo.should be true
+            conf.charlie.should be true
           end
 
           it 'name can be a setting' do
@@ -711,9 +699,9 @@ describe Configuration do
               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 true
+            conf.bravo.should be true
+            conf.charlie.should be true
             conf.setting1.should == 'bravo'
             conf.setting2.should == 'charlie'
           end
@@ -730,10 +718,10 @@ describe Configuration do
               end
             end.to_not raise_error
             conf.should_not be_nil
-            conf.alpha.should be_true
+            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.alpha.should be true
+            conf.bravo.charlie.should be true
           end
 
         end # dynamic setting
@@ -951,13 +939,168 @@ describe Configuration do
 
   end # "v1.0"
 
-  #context 'v1.1' do
-  #
-  #  context 'merge' do
-  #
-  #  end
-  #
-  #end #v1.1
+  def simple_config_1
+    Configuration.new do
+      alpha   1
+      bravo   'one'
+      charlie 1.0
+      delta   :one
+    end
+  end
+
+  def simple_config_1_example conf
+    conf.should_not be_nil
+    conf.alpha.should   == 1     and conf.alpha.should be_a Integer
+    conf.bravo.should   == "one" and conf.bravo.should be_a String
+    conf.charlie.should == 1.0   and conf.charlie.should be_a Float
+    conf.delta.should   == :one  and conf.delta.should be_a Symbol
+  end
+
+  def simple_config_2
+    Configuration.new do
+      echo    2
+      foxtrot 'two'
+      hotel   2.0
+      india   :two
+    end
+  end
+
+  def simple_config_2_example conf
+    conf.should_not be_nil
+    conf.echo.should    == 2     and conf.echo.should be_a Integer
+    conf.foxtrot.should == "two" and conf.foxtrot.should be_a String
+    conf.hotel.should   == 2.0   and conf.hotel.should be_a Float
+    conf.india.should   == :two  and conf.india.should be_a Symbol
+    conf['echo']
+    #and conf[:echo].should be_a Integer
+
+  end
+
+  def simple_config_3
+    Configuration.new do
+      juliet 3
+      kilo   'three'
+      lima   3.0
+      mike   :three
+    end
+  end
+
+  def simple_config_3_example conf
+    conf.should_not be_nil
+    conf.juliet.should == 3       and conf.juliet.should be_a Integer
+    conf.kilo.should   == "three" and conf.kilo.should be_a String
+    conf.lima.should   == 3.0     and conf.lima.should be_a Float
+    conf.mike.should   == :three  and conf.mike.should be_a Symbol
+  end
+
+  context 'v1.1' do
+
+    context 'options' do
+
+      it 'have defaults at Configuration creation' do
+        conf = Configuration.new
+        conf._options[:blankslate].should be true
+        conf._options[:case_sensitive].should be true
+      end
+
+      it 'are accepted at Configuration creation' do
+        conf = Configuration.new nil, :blankslate => false, :case_sensitive => false
+        conf._options[:blankslate].should be false
+        conf._options[:case_sensitive].should be false
+      end
+
+    end
+
+    context 'wildcard *' do
+
+      it 'returns an empty ConfigurationDelegator for subject with no child configurations' do
+        conf = simple_config_1
+        simple_config_1_example conf
+        delegator = conf.*
+        delegator.should be_a ConfigurationDelegator
+        delegator.should be_empty
+      end
+
+      it 'returns ConfigurationDelegator containing child configurations for subject' do
+        conf = simple_config_1
+        conf.nested2 = simple_config_2
+        conf.nested3 = simple_config_3
+        simple_config_1_example conf
+        simple_config_2_example conf.nested2
+        simple_config_3_example conf.nested3
+        delegator = conf.*
+        delegator.should be_a ConfigurationDelegator
+        delegator.size.should be 2
+        delegator[0].should be conf.nested2
+        delegator[1].should be conf.nested3
+      end
+
+    end
+
+    context 'ConfigurationDelegator' do
+
+      it 'can be created with no child configurations' do
+        delegator = ConfigurationDelegator.new []
+        delegator.should be_a ConfigurationDelegator
+        delegator.should be_empty
+      end
+
+      context 'wildcard *' do
+
+        # todo: question : should wildcard return nil for already empty ConfigurationDelegator / overshoot ?
+
+        it 'returns an empty ConfigurationDelegator for ConfigurationDelegator with no child configurations' do
+          conf = simple_config_1
+          conf.nested2 = simple_config_2
+          conf.nested3 = simple_config_3
+          simple_config_1_example conf
+          simple_config_2_example conf.nested2
+          simple_config_3_example conf.nested3
+          delegator = conf.*.*
+          delegator.should be_a ConfigurationDelegator
+          delegator.should be_empty
+        end
+
+        it 'returns an empty ConfigurationDelegator when overshoots' do
+          conf = simple_config_1
+          conf.nested2 = simple_config_2
+          conf.nested3 = simple_config_3
+          simple_config_1_example conf
+          simple_config_2_example conf.nested2
+          simple_config_3_example conf.nested3
+          delegator = conf.*.*.*.*.*.*.*.*.*
+          delegator.should be_a ConfigurationDelegator
+          delegator.should be_empty
+        end
+
+        it 'returns ConfigurationDelegator containing child configurations for ConfigurationDelegator' do
+          conf = simple_config_1
+          conf.nested2 = simple_config_2
+          conf.nested3 = simple_config_3
+          conf.nested2.nested2 = simple_config_2
+          conf.nested2.nested3 = simple_config_3
+          conf.nested3.nested2 = simple_config_2
+          conf.nested3.nested3 = simple_config_3
+          simple_config_1_example conf
+          simple_config_2_example conf.nested2
+          simple_config_2_example conf.nested2.nested2
+          simple_config_2_example conf.nested3.nested2
+          simple_config_3_example conf.nested3
+          simple_config_3_example conf.nested2.nested3
+          simple_config_3_example conf.nested3.nested3
+          delegator = conf.*.*
+          delegator.size.should be 4
+          delegator[0].should be conf.nested2.nested2
+          delegator[1].should be conf.nested2.nested3
+          delegator[2].should be conf.nested3.nested2
+          delegator[3].should be conf.nested3.nested3
+        end
+
+      end # wildcard *
+
+    end # ConfigurationDelagator
+
+  end #v1.1
 
 end
 

data/spec/spec_helper.rb

@@ -1,11 +1,9 @@
-# This file was generated by the `rspec --init` command. Conventionally, all
-# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
-# Require this file using `require "spec_helper.rb"` to ensure that it is only
-# loaded once.
-#
-# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
 RSpec.configure do |config|
-  config.treat_symbols_as_metadata_keys_with_true_values = true
-  config.run_all_when_everything_filtered = true
-  config.filter_run :focus
+  config.expect_with :rspec do |expectations|
+    expectations.syntax = [ :should, :expect ] 
+  end
+  config.mock_with :rspec do |mocks|
+    mocks.syntax = [ :should, :expect ]
+  end
 end
+

metadata

@@ -1,108 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: iqeo-conf
 version: !ruby/object:Gem::Version
-  version: 1.0.1
-  prerelease: 
+  version: 1.1.1
 platform: ruby
 authors:
 - Gerard Fowley
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-21 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.9.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.9.2
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 2.10.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 2.10.0
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.8.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.8.1
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 3.12.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 3.12.0
-- !ruby/object:Gem::Dependency
-  name: redcarpet
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 2.1.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 2.1.1
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
 description: A configuration DSL
-email:
-- gerard.fowley@iqeo.net
+email: gerard.fowley@iqeo.net
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .yardoc/checksums
-- .yardoc/object_types
-- .yardoc/objects/root.dat
-- .yardoc/proxy_types
+- ".gitignore"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".yardoc/checksums"
+- ".yardoc/object_types"
+- ".yardoc/objects/root.dat"
+- ".yardoc/proxy_types"
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -128,32 +48,28 @@ files:
 - iqeo-conf.gemspec
 - lib/iqeo/configuration.rb
 - lib/iqeo/configuration/hash_with_indifferent_access.rb
-- lib/iqeo/configuration/version.rb
 - spec/configuration_spec.rb
 - spec/spec_helper.rb
-homepage: http://iqeo.github.com/iqeo-conf
-licenses: []
-post_install_message: 
+homepage: http://github.com/iqeo/iqeo-conf
+licenses:
+- GPL-3.0
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.24
-signing_key: 
-specification_version: 3
+rubygems_version: 3.6.7
+specification_version: 4
 summary: A DSL for writing configuration files
 test_files: []
-has_rdoc: 

data/lib/iqeo/configuration/version.rb

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