loquacious 1.8.1 → 1.9.0

data/History.txt

@@ -1,116 +1,122 @@
+== 1.9.0 / 2011-09-13
+
+Enhancements
+- Iterator now skips Undefined values
+- Method to convert Configuration objects to a hash [mcmire]
+
 == 1.8.1 / 2011-06-09
 
 Bug Fixes
-  - Assignment methods now mirror one another in their return values
+- Assignment methods now mirror one another in their return values
 
 == 1.8.0 / 2011-06-03
 
 Enhancements
-  - Support for defalut values on configuration properties
+- Support for defalut values on configuration properties
 
 == 1.7.1 / 2011-02-11
 
 Bug Fixes
-  - Fixing the "alias instance_eval" warning on JRuby
+- Fixing the "alias instance_eval" warning on JRuby
 
 == 1.7.0 / 2010-08-16
 
-* Enhancements
-  * Adding a "copy" function for configuration objects
-* Bug Fixes
-  * Fixing warnings
+Enhancements
+- Adding a "copy" function for configuration objects
+Bug Fixes
+- Fixing warnings
 
 == 1.6.4 / 2010-06-08
 
-* Bug Fixes
-  * Extending a configuration was not working properly
-  * Descriptions were being overwritten when extending a configuration
+Bug Fixes
+- Extending a configuration was not working properly
+- Descriptions were being overwritten when extending a configuration
 
 == 1.6.3 / 2010-06-07
 
-* Bug Fixes
-  * Assign a nil description when none is given [Nathan Witmer]
+Bug Fixes
+- Assign a nil description when none is given [Nathan Witmer]
 
 == 1.6.2 / 2010-06-01
 
-* Bug Fixes
-  * Compatibility with Ruby 1.9.2
+Bug Fixes
+- Compatibility with Ruby 1.9.2
 
 == 1.6.1 / 2010-04-19
 
-* 1 bug fix
-  * Allow interrogative methods on configuration objects (nil?)
+Bug Fixes
+- Allow interrogative methods on configuration objects (nil?)
 
 == 1.6.0 / 2010-04-18
 
-* 1 minor enhancement
-  * Added a default "undefined" value
+Enhancements
+- Added a default "undefined" value
 
 == 1.5.2 / 2010-04-06
 
-* 1 bug fix
-  * Accidentally undefining the initialize method for the DSL
+Bug Fixes
+- Accidentally undefining the initialize method for the DSL
 
 == 1.5.1 / 2010-04-06
 
-* 1 bug fix
-  * Private methods were accessible in the configuration objects
+Bug Fixes
+- Private methods were accessible in the configuration objects
 
 == 1.5.0 / 2010-03-11
 
-* 2 minor enhancements
-  * Adding support for evaluation of Proc objects
-  * Upgrading to the latest Mr Bones
+Enhancements
+- Adding support for evaluation of Proc objects
+- Upgrading to the latest Mr Bones
 
 
 == 1.4.2 / 2010-02-01
 
-* 1 bug fix
-  * Resolving some circular dependencies
+Bug Fixes
+- Resolving some circular dependencies
 
 == 1.4.1 / 2009-11-29
 
-* 2 bug fixes
-  - Fixing warning message from jRuby
-  - Kernel methods can now be used as configuration attributes
+Bug Fixes
+- Fixing warning message from jRuby
+- Kernel methods can now be used as configuration attributes
 
 == 1.4.0 / 2009-11-07
 
-* 2 minor enhancement
-  - Added a help option to hide nesting configuration atrributes
-  - Update to Mr Bones 3.0.0
+Enhancements
+- Added a help option to hide nesting configuration atrributes
+- Update to Mr Bones 3.0.0
 
 == 1.3.1 / 2009-10-30
 
-* 1 minor enhancement
-  - Added a remove method to clobber unwanted methods in the configuration
-* 1 bug fix
-  - Could not assign false as a default value
+Enhancements
+- Added a remove method to clobber unwanted methods in the configuration
+Bug Fixes
+- Could not assign false as a default value
 
 == 1.3.0 / 2009-04-05
 
-* 1 minor enhancement
-  - Adding colorization options to the Help object
+Enhancements
+- Adding colorization options to the Help object
 
 == 1.2.0 / 2009-04-05
 
-* 1 minor enhancement
-  - Help#show now matches using a regular expression
+Enhancements
+- Help#show now matches using a regular expression
 
 == 1.1.1 / 2009-04-05
 
-* 1 bug fix
-  - You can no longer use object_id as a configuration value
-    (Ruby 1.9 is very cranky if object_id gets undefined)
+Bug Fixes
+- You can no longer use object_id as a configuration value
+  (Ruby 1.9 is very cranky if object_id gets undefined)
 
 == 1.1.0 / 2009-04-05
 
-* 1 minor enhancement
-  - Added hash accessor methods for configuration attributes
-* 1 bug fix
-  - Hash values were not being handeld properly by the DSL
+Enhancements
+- Added hash accessor methods for configuration attributes
+Bug Fixes
+- Hash values were not being handeld properly by the DSL
 
 == 1.0.0 / 2009-04-04
 
-* 1 major enhancement
-  - Birthday!
+Enhancements
+- Birthday!

data/lib/loquacious/configuration.rb

@@ -82,6 +82,29 @@ module Loquacious
         ::Loquacious::Configuration::Help.new(name, opts)
       end
       alias :help :help_for
+
+      # call-seq:
+      #   Configuration.to_hash( config )
+      #
+      # Recursively convert a configuration object to a hash.
+      #
+      def to_hash( config )
+        cache = { nil => {} }
+
+        Iterator.new(config).each do |node|
+          ary = node.name.split('.')
+          name = ary.pop.to_sym
+          parent = ary.empty? ? nil : ary.join('.')
+
+          if node.config?
+            cache[node.name] = cache[parent][name] = {}
+          else
+            cache[parent][name] = node.obj
+          end
+        end
+
+        return cache[nil]
+      end
     end
 
     instance_methods(true).each do |m|
@@ -245,6 +268,11 @@ module Loquacious
       self.__send(key, value)
     end
 
+    # Recursively convert the configuration object to a hash.
+    #
+    def to_hash
+      ::Loquacious::Configuration.to_hash(self)
+    end
 
     # Implementation of a domain specific language for creating configuration
     # objects. Blocks of code are evaluted by the DSL which returns a new

data/lib/loquacious/configuration/iterator.rb

@@ -108,6 +108,7 @@ class Loquacious::Configuration
       frame.index += 1
       stack << new_frame(node.obj, node.name) if node.config?
 
+      node = next_node if node.undefined?
       return node
     end
 
@@ -145,10 +146,8 @@ class Loquacious::Configuration
     #
     Node = Struct.new( :config, :name, :desc, :key ) {
       def config?() obj.kind_of? ::Loquacious::Configuration; end
-      def obj()
-        o = config.__send__(key)
-        o.kind_of?(::Loquacious::Undefined) ? nil : o
-      end
+      def undefined?() obj.kind_of? ::Loquacious::Undefined; end
+      def obj() config.__send__(key); end
     }
 
   end  # class Iterator

data/spec/configuration_spec.rb

@@ -11,27 +11,27 @@ describe Loquacious::Configuration do
             first    'foo'
             second   'bar'
           }
-    obj.first.should == 'foo'
-    obj.second.should == 'bar'
+    obj.first.should be == 'foo'
+    obj.second.should be == 'bar'
     obj.third.should be_nil
   end
 
   it 'should respond to any method' do
     @obj.first.should be_nil
     @obj.first = 'foo'
-    @obj.first.should == 'foo'
+    @obj.first.should be == 'foo'
 
     @obj.second = 'bar'
-    @obj.second.should == 'bar'
+    @obj.second.should be == 'bar'
   end
 
   it 'should deine attribute accessors when first used' do
-    @obj.respond_to?(:foo).should == false
-    @obj.respond_to?(:foo=).should == false
+    @obj.respond_to?(:foo).should be == false
+    @obj.respond_to?(:foo=).should be == false
 
     @obj.foo
-    @obj.respond_to?(:foo).should == true
-    @obj.respond_to?(:foo=).should == true
+    @obj.respond_to?(:foo).should be == true
+    @obj.respond_to?(:foo=).should be == true
   end
 
   it 'should provide a hash object for storing method descriptions' do
@@ -43,7 +43,7 @@ describe Loquacious::Configuration do
     cfg = Loquacious::Configuration.new {
             hash({:one => 1})
           }
-    cfg.hash.should == {:one => 1}
+    cfg.hash.should be == {:one => 1}
   end
 
   it 'should provide hash accessor notation for attributes' do
@@ -53,17 +53,17 @@ describe Loquacious::Configuration do
             three 3
           }
 
-    cfg['one'].should == 1
-    cfg[:two].should == 2
-    cfg['three'].should == 3
+    cfg['one'].should be == 1
+    cfg[:two].should be == 2
+    cfg['three'].should be == 3
 
     cfg[:four].should be_nil
     cfg.four = 4
-    cfg[:four].should == 4
+    cfg[:four].should be == 4
 
     cfg[:five] = 5
-    cfg.five.should == 5
-    cfg[:five].should == 5
+    cfg.five.should be == 5
+    cfg[:five].should be == 5
   end
 
   it 'should allow Kernel methods to be treated as configuration attributes' do
@@ -74,20 +74,20 @@ describe Loquacious::Configuration do
             puts   'not what you think'
           }
 
-    cfg['fork'].should == 'spoon knife spork'
-    cfg['split'].should == 'join'
-    cfg['raise'].should == 'double down'
-    cfg['puts'].should == 'not what you think'
+    cfg['fork'].should be == 'spoon knife spork'
+    cfg['split'].should be == 'join'
+    cfg['raise'].should be == 'double down'
+    cfg['puts'].should be == 'not what you think'
 
-    cfg[:fork].should == 'spoon knife spork'
-    cfg[:split].should == 'join'
-    cfg[:raise].should == 'double down'
-    cfg[:puts].should == 'not what you think'
+    cfg[:fork].should be == 'spoon knife spork'
+    cfg[:split].should be == 'join'
+    cfg[:raise].should be == 'double down'
+    cfg[:puts].should be == 'not what you think'
 
-    cfg.fork.should == 'spoon knife spork'
-    cfg.split.should == 'join'
-    cfg.raise.should == 'double down'
-    cfg.puts.should == 'not what you think'
+    cfg.fork.should be == 'spoon knife spork'
+    cfg.split.should be == 'join'
+    cfg.raise.should be == 'double down'
+    cfg.puts.should be == 'not what you think'
   end
 
   it 'should not be affected by loading other modules like timeout' do
@@ -98,9 +98,9 @@ describe Loquacious::Configuration do
             foo      'bar'
             baz      'buz'
           }
-    cfg.timeout.should == 10
-    cfg.foo.should == 'bar'
-    cfg.baz.should == 'buz'
+    cfg.timeout.should be == 10
+    cfg.foo.should be == 'bar'
+    cfg.baz.should be == 'buz'
   end
 
   it 'should evaluate Proc objects when fetching values' do
@@ -110,14 +110,14 @@ describe Loquacious::Configuration do
           }
 
     obj.third = Proc.new { obj.first + obj.second }
-    obj.third.should == 'foobar'
+    obj.third.should be == 'foobar'
 
     obj.second = 'baz'
-    obj.third.should == 'foobaz'
+    obj.third.should be == 'foobaz'
 
     obj.first = 'Hello '
     obj.second = 'World!'
-    obj.third.should == 'Hello World!'
+    obj.third.should be == 'Hello World!'
   end
 
   it 'should return a value when evaluating inside the DSL' do
@@ -128,7 +128,7 @@ describe Loquacious::Configuration do
             }
           }
 
-    obj.first.should == 'foo'
+    obj.first.should be == 'foo'
     obj.second.bar.should be_nil
 
     Loquacious::Configuration::DSL.evaluate(:config => obj) {
@@ -136,8 +136,8 @@ describe Loquacious::Configuration do
       second.bar 'no longer nil'
     }
 
-    obj.first.should == 'bar'
-    obj.second.bar.should == 'no longer nil'
+    obj.first.should be == 'bar'
+    obj.second.bar.should be == 'no longer nil'
   end
 
   it 'should not delete descriptions' do
@@ -150,24 +150,24 @@ describe Loquacious::Configuration do
             }
           }
 
-    obj.first.should == 'foo'
+    obj.first.should be == 'foo'
     obj.second.bar.should be_nil
 
-    obj.__desc[:first].should == 'the first value'
-    obj.__desc[:second].should == 'the second value'
-    obj.second.__desc[:bar].should == 'time to go drinking'
+    obj.__desc[:first].should be == 'the first value'
+    obj.__desc[:second].should be == 'the second value'
+    obj.second.__desc[:bar].should be == 'time to go drinking'
 
     Loquacious::Configuration::DSL.evaluate(:config => obj) {
       first 'bar'
       second.bar 'no longer nil'
     }
 
-    obj.first.should == 'bar'
-    obj.second.bar.should == 'no longer nil'
+    obj.first.should be == 'bar'
+    obj.second.bar.should be == 'no longer nil'
 
-    obj.__desc[:first].should == 'the first value'
-    obj.__desc[:second].should == 'the second value'
-    obj.second.__desc[:bar].should == 'time to go drinking'
+    obj.__desc[:first].should be == 'the first value'
+    obj.__desc[:second].should be == 'the second value'
+    obj.second.__desc[:bar].should be == 'time to go drinking'
   end
 
   # -----------------------------------------------------------------------
@@ -181,12 +181,12 @@ describe Loquacious::Configuration do
 
       @obj.first.should be_nil
       @obj.second.should be_nil
-      @obj.__desc.should == {:first => nil, :second => nil}
+      @obj.__desc.should be == {:first => nil, :second => nil}
 
       @obj.merge! other
-      @obj.first.should == 'foo'
-      @obj.second.should == 'bar'
-      @obj.__desc.should == {
+      @obj.first.should be == 'foo'
+      @obj.second.should be == 'bar'
+      @obj.__desc.should be == {
         :first => 'foo method',
         :second => 'bar method'
       }
@@ -211,17 +211,17 @@ describe Loquacious::Configuration do
 
       @obj.merge! other
 
-      @obj.first.should == 'foo'
-      @obj.second.should == 'bar'
-      @obj.third.question.should == '?'
-      @obj.third.answer.should == 42
+      @obj.first.should be == 'foo'
+      @obj.second.should be == 'bar'
+      @obj.third.question.should be == '?'
+      @obj.third.answer.should be == 42
 
-      @obj.__desc.should == {
+      @obj.__desc.should be == {
         :first => 'foo method',
         :second => 'bar method',
         :third => 'the third group'
       }
-      @obj.third.__desc.should == {
+      @obj.third.__desc.should be == {
         :question => 'perhaps you do not understand',
         :answer => 'life the universe and everything'
       }
@@ -246,8 +246,8 @@ describe Loquacious::Configuration do
         second  'bar', :desc => "bar method\n  also a multiline comment"
       }
 
-      other.__desc[:first].should == "This is the first thing we are defining in this config.\nIt has a multiline comment."
-      other.__desc[:second].should == "bar method\nalso a multiline comment"
+      other.__desc[:first].should be == "This is the first thing we are defining in this config.\nIt has a multiline comment."
+      other.__desc[:second].should be == "bar method\nalso a multiline comment"
     end
 
     it 'should leave whitespace after a gutter marker' do
@@ -268,8 +268,8 @@ describe Loquacious::Configuration do
         second  'bar'
       }
 
-      other.__desc[:first].should == "  This is the first thing we are defining in this config.\n  It has a multiline comment."
-      other.__desc[:second].should == "This is a short explanation\n\nExample:\n  do this then that\n  followed by this line"
+      other.__desc[:first].should be == "  This is the first thing we are defining in this config.\n  It has a multiline comment."
+      other.__desc[:second].should be == "This is a short explanation\n\nExample:\n  do this then that\n  followed by this line"
     end
   end
 
@@ -289,7 +289,7 @@ describe Loquacious::Configuration do
       }
 
       c = Loquacious::Configuration.for 'test'
-      c.first.should == 'foo'
+      c.first.should be == 'foo'
       c.second.bar.should be_nil
     end
 
@@ -307,13 +307,13 @@ describe Loquacious::Configuration do
         }
       }
 
-      c.first.should == 1
-      c.third.should == 3
+      c.first.should be == 1
+      c.third.should be == 3
       c.second.bar.should be_nil
 
-      c.__desc[:first].should == 'the first value'
-      c.__desc[:second].should == 'the second value'
-      c.second.__desc[:bar].should == 'time to go drinking'
+      c.__desc[:first].should be == 'the first value'
+      c.__desc[:second].should be == 'the second value'
+      c.second.__desc[:bar].should be == 'time to go drinking'
       c.__desc[:thrid].should be_nil
     end
 
@@ -343,21 +343,21 @@ describe Loquacious::Configuration do
         }
       }
 
-      c.first.should == 1
-      c.third.should == 3
-      c.second.bar.should == 'pub'
-      c.second.baz.buz.should == 'random text'
-      c.second.baz.boo.should == 'who'
+      c.first.should be == 1
+      c.third.should be == 3
+      c.second.bar.should be == 'pub'
+      c.second.baz.buz.should be == 'random text'
+      c.second.baz.boo.should be == 'who'
 
       c.second.bar = Loquacious::Undefined.new('second.bar')
-      c.second.bar.should == 'h-bar'
-
-      c.__desc[:first].should == 'the first value'
-      c.__desc[:second].should == 'the second value'
-      c.second.__desc[:bar].should == 'time to go drinking'
-      c.second.__desc[:baz].should == 'getting weird'
-      c.second.baz.__desc[:buz].should == 'post drinking feeling'
-      c.second.baz.__desc[:boo].should == 'no need to cry about it'
+      c.second.bar.should be == 'h-bar'
+
+      c.__desc[:first].should be == 'the first value'
+      c.__desc[:second].should be == 'the second value'
+      c.second.__desc[:bar].should be == 'time to go drinking'
+      c.second.__desc[:baz].should be == 'getting weird'
+      c.second.baz.__desc[:buz].should be == 'post drinking feeling'
+      c.second.baz.__desc[:boo].should be == 'no need to cry about it'
       c.__desc[:thrid].should be_nil
     end
 
@@ -384,12 +384,12 @@ describe Loquacious::Configuration do
         }
       }
 
-      c.second.baz.buz.should == 'random text'
-      c.second.baz.boo.should == 'who'
+      c.second.baz.buz.should be == 'random text'
+      c.second.baz.boo.should be == 'who'
 
       c.second.baz = Loquacious::Undefined.new('second.bar')
       c.second.baz.should be_nil
-      c.second.__desc[:baz].should == 'deprecated'
+      c.second.__desc[:baz].should be == 'deprecated'
     end
 
     it 'properly handles Proc default values' do
@@ -410,8 +410,42 @@ describe Loquacious::Configuration do
         }
       }
 
-      c.second.baz.should == 36
-      c.second.__desc[:baz].should == 'proc will be evaluated'
+      c.second.baz.should be == 36
+      c.second.__desc[:baz].should be == 'proc will be evaluated'
+    end
+  end
+
+  # -----------------------------------------------------------------------
+  describe 'when converting to a hash' do
+    it "should do so recursively" do
+      c = Loquacious::Configuration.new {
+        first 1, :desc => 'one is the loneliest number'
+        second {
+          bar 'pub', :desc => 'where the magic happens'
+          desc 'overwrite me'
+          baz {
+            buz 'random text'
+            boo 'who'
+          }
+        }
+        third 3
+      }
+      c.to_hash.should == {
+        :first => 1,
+        :second => {
+          :bar => 'pub',
+          :baz => {
+            :buz => 'random text',
+            :boo => 'who'
+          }
+        },
+        :third => 3
+      }
+    end
+
+    it "just returns an empty hash for an empty configuration" do
+      c = Loquacious::Configuration.new { }
+      c.to_hash.should == {}
     end
   end
 

data/spec/help_spec.rb

@@ -52,7 +52,7 @@ describe Loquacious::Configuration::Help do
     OUTPUT
 
     @help.show_all
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "prints out a specific attribute" do
@@ -62,7 +62,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     @help.show_attribute :second
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "properly parses nested attributes" do
@@ -78,7 +78,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     @help.show_attribute 'third'
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
 
     @sio.clear
     str = <<-OUTPUT
@@ -87,7 +87,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     @help.show_attribute %w[third question]
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
 
     @sio.clear
     str = <<-OUTPUT
@@ -96,7 +96,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     @help.show_attribute 'third.answer'
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "hides nesting attributes" do
@@ -118,7 +118,7 @@ describe Loquacious::Configuration::Help do
     OUTPUT
 
     help.show_all
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
 
     @sio.clear
     str = <<-OUTPUT
@@ -130,7 +130,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     help.show_attribute 'third'
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
 
     @sio.clear
   end
@@ -159,7 +159,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     @help.show_attribute 'fourth'
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "pretty prints values" do
@@ -181,7 +181,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     @help.show :values => true
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "closely packs attributes when descriptions are omitted" do
@@ -193,7 +193,7 @@ describe Loquacious::Configuration::Help do
     |  - third.question => :symbol
     OUTPUT
     @help.show_all :values => true, :descriptions => false
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "automatically picks up changes to the configuration" do
@@ -207,7 +207,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     @help.show_attribute 'fifth'
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "uses a custom name leader" do
@@ -230,7 +230,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     help.show_all
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
 
     @sio.clear
     str = <<-OUTPUT
@@ -241,7 +241,7 @@ describe Loquacious::Configuration::Help do
     | ## third.question => :symbol
     OUTPUT
     help.show_all :values => true, :descriptions => false
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "uses a custom name length" do
@@ -264,7 +264,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     help.show_all
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
 
     @sio.clear
     str = <<-OUTPUT
@@ -275,7 +275,7 @@ describe Loquacious::Configuration::Help do
     |  - thir...ion => :symbol
     OUTPUT
     help.show_all :values => true, :descriptions => false
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "uses a custom name/value separator" do
@@ -298,7 +298,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     help.show_all :values => true
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
 
     @sio.clear
     str = <<-OUTPUT
@@ -309,7 +309,7 @@ describe Loquacious::Configuration::Help do
     |  - third.question :: :symbol
     OUTPUT
     help.show_all :values => true, :descriptions => false
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 
   it "uses a custom description leader" do
@@ -352,7 +352,7 @@ describe Loquacious::Configuration::Help do
     |
     OUTPUT
     help.show_all :values => true
-    @sio.to_s.should == str.gutter!
+    @sio.to_s.should be == str.gutter!
   end
 end
 

data/spec/iterator_spec.rb

@@ -10,24 +10,24 @@ describe Loquacious::Configuration::Iterator do
 
   it 'should find a particular attribute' do
     node = @iterator.find 'first'
-    node.name.should == 'first'
-    node.key.should == :first
-    node.desc.should == 'foo method'
-    node.obj.should == 'foo'
-    node.config?.should == false
+    node.name.should be == 'first'
+    node.key.should be == :first
+    node.desc.should be == 'foo method'
+    node.obj.should be == 'foo'
+    node.config?.should be == false
 
     node = @iterator.find :third
-    node.name.should == 'third'
-    node.key.should == :third
-    node.desc.should == 'the third group'
-    node.config?.should == true
+    node.name.should be == 'third'
+    node.key.should be == :third
+    node.desc.should be == 'the third group'
+    node.config?.should be == true
 
     node = @iterator.find('third.answer')
-    node.name.should == 'third.answer'
-    node.key.should == :answer
-    node.desc.should == 'life the universe and everything'
-    node.obj.should == 42
-    node.config?.should == false
+    node.name.should be == 'third.answer'
+    node.key.should be == :answer
+    node.desc.should be == 'life the universe and everything'
+    node.obj.should be == 42
+    node.config?.should be == false
   end
 
   it 'should return nil for unknown attributes' do
@@ -41,22 +41,31 @@ describe Loquacious::Configuration::Iterator do
     ary = Array.new
     @iterator.each {|n| ary << n.name}
 
-    ary.should == %w{first second third third.answer third.question}
+    ary.should be == %w{first second third third.answer third.question}
   end
 
   it 'should iterate over nested attributes if given' do
     ary = Array.new
     @iterator.each('third') {|n| ary << n.name}
-    ary.should == %w{third third.answer third.question}
+    ary.should be == %w{third third.answer third.question}
 
     ary.clear
     @iterator.each('first') {|n| ary << n.name}
-    ary.should == %w{first}
+    ary.should be == %w{first}
 
     ary.clear
     @iterator.each('not_here') {|n| ary << n.name}
     ary.should be_empty
   end
+
+  it 'should ignore undefined nodes' do
+    @config.does_not_exist.foo  # this creates a Loquacious::Undefined node
+    @config.does_not_exist.kind_of?(::Loquacious::Undefined).should be_true
+
+    ary = Array.new
+    @iterator.each {|n| ary << n.name}
+    ary.should be == %w{first second third third.answer third.question}
+  end
 end
 
 # EOF

data/spec/loquacious_spec.rb

@@ -11,11 +11,11 @@ describe Loquacious do
   end
 
   it "finds things releative to 'lib'" do
-    Loquacious.libpath(%w[loquacious config.rb]).should == File.join(@root_dir, %w[lib loquacious config.rb])
+    Loquacious.libpath(%w[loquacious config.rb]).should be == File.join(@root_dir, %w[lib loquacious config.rb])
   end
 
   it "finds things releative to 'root'" do
-    Loquacious.path('Rakefile').should == File.join(@root_dir, 'Rakefile')
+    Loquacious.path('Rakefile').should be == File.join(@root_dir, 'Rakefile')
   end
 
   describe "when copying configuration objects" do
@@ -31,10 +31,10 @@ describe Loquacious do
       copy.first = 'foobar'
       copy.second.bar = 'buz'
 
-      obj.first.should == 'foo'
-      obj.second.bar.should == 'baz'
-      copy.first.should == 'foobar'
-      copy.second.bar.should == 'buz'
+      obj.first.should be == 'foo'
+      obj.second.bar.should be == 'baz'
+      copy.first.should be == 'foobar'
+      copy.second.bar.should be == 'buz'
     end
 
     it "looks up a configuration object by name" do
@@ -46,8 +46,8 @@ describe Loquacious do
       }
 
       copy = Loquacious.copy('by name')
-      copy.first.should == 'foo'
-      copy.second.bar.should == 'baz'
+      copy.first.should be == 'foo'
+      copy.second.bar.should be == 'baz'
     end
 
     it "returns nil when a configuration object cannot be found" do
@@ -67,9 +67,9 @@ describe Loquacious do
         third "hey I'm new"
       }
 
-      copy.first.should == 'foo'
-      copy.second.bar.should == 'foobar'
-      copy.third.should == "hey I'm new"
+      copy.first.should be == 'foo'
+      copy.second.bar.should be == 'foobar'
+      copy.third.should be == "hey I'm new"
     end
   end
 end

data/spec/string_spec.rb

@@ -4,29 +4,29 @@ require File.expand_path('spec_helper', File.dirname(__FILE__))
 describe String do
 
   it "reduces to a size by replacing characters from the middle" do
-    "this is a longish string".reduce(10).should == "this...ing"
-    "this is a longish string".reduce(15).should == "this i...string"
-    "this is a longish string".reduce(24).should == "this is a longish string"
+    "this is a longish string".reduce(10).should be == "this...ing"
+    "this is a longish string".reduce(15).should be == "this i...string"
+    "this is a longish string".reduce(24).should be == "this is a longish string"
 
-    "this is a longish string".reduce(10, '--').should == "this--ring"
+    "this is a longish string".reduce(10, '--').should be == "this--ring"
   end
 
   it "indents by a given number of spaces" do
-    "hello".indent(2).should == "  hello"
-    "hello\nworld".indent(4).should == "    hello\n    world"
-    "  a\nslightly\n longer\n   string\n".indent(2).should == "    a\n  slightly\n   longer\n     string\n  "
+    "hello".indent(2).should be == "  hello"
+    "hello\nworld".indent(4).should be == "    hello\n    world"
+    "  a\nslightly\n longer\n   string\n".indent(2).should be == "    a\n  slightly\n   longer\n     string\n  "
   end
 
   it "indents using a leader string" do
-    "hello".indent("foo ").should == "foo hello"
-    "hello\nworld".indent("...").should == "...hello\n...world"
-    "  a\nslightly\n longer\n   string\n".indent("#").should == "#  a\n#slightly\n# longer\n#   string\n#"
+    "hello".indent("foo ").should be == "foo hello"
+    "hello\nworld".indent("...").should be == "...hello\n...world"
+    "  a\nslightly\n longer\n   string\n".indent("#").should be == "#  a\n#slightly\n# longer\n#   string\n#"
   end
 
   it "removes a leading gutter from all lines" do
     str = "  | foo"
     result = str.gutter!
-    result.should == " foo"
+    result.should be == " foo"
     result.should equal(str)
 
     str = <<-STRING
@@ -39,13 +39,13 @@ describe String do
     STRING
 
     str.gutter!
-    str.should == " And this is where gutters really shine!\n HERE DOCS!!\n|they are the best\n\n    You can indent stuff nicely and all that\nall done now\n"
+    str.should be == " And this is where gutters really shine!\n HERE DOCS!!\n|they are the best\n\n    You can indent stuff nicely and all that\nall done now\n"
   end
 
   it "creates a copy when removing a leading gutter" do
     str = "  | foo"
     result = str.gutter
-    result.should == " foo"
+    result.should be == " foo"
     result.should_not equal(str)
   end
 end

data/version.txt

@@ -1 +1 @@
-1.8.1
+1.9.0

metadata

@@ -1,91 +1,50 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: loquacious
-version: !ruby/object:Gem::Version 
-  hash: 53
-  prerelease: false
-  segments: 
-  - 1
-  - 8
-  - 1
-  version: 1.8.1
+version: !ruby/object:Gem::Version
+  version: 1.9.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Tim Pease
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-06-09 00:00:00 -06:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-09-13 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rspec
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &2161298080 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 15
-        segments: 
-        - 2
-        - 6
-        version: "2.6"
+      - !ruby/object:Gem::Version
+        version: '2.6'
   type: :development
-  version_requirements: *id001
-description: |-
-  Descriptive configuration files for Ruby written in Ruby.
-  
-  Loquacious provides a very open configuration system written in ruby and
-  descriptions for each configuration attribute. The attributes and descriptions
-  can be iterated over allowing for helpful information about those attributes to
-  be displayed to the user.
-  
-  In the simple case we have a file something like
-  
-    Loquacious.configuration_for('app') {
-      name 'value', :desc => "Defines the name"
-      foo  'bar',   :desc => "FooBar"
-      id   42,      :desc => "Ara T. Howard"
-    }
-  
-  Which can be loaded via the standard Ruby loading mechanisms
-  
-    Kernel.load 'config/app.rb'
-  
-  The attributes and their descriptions can be printed by using a Help object
-  
-    help = Loquacious.help_for('app')
-    help.show :values => true        # show the values for the attributes, too
-  
-  Descriptions are optional, and configurations can be nested arbitrarily deep.
-  
-    Loquacious.configuration_for('nested') {
-      desc "The outermost level"
-      a {
-        desc "One more level in"
-        b {
-          desc "Finally, a real value"
-          c 'value'
-        }
-      }
-    }
-  
-    config = Loquacious.configuration_for('nested')
-  
-    p config.a.b.c  #=> "value"
-  
-  And as you can see, descriptions can either be given inline after the value or
-  they can appear above the attribute and value on their own line.
+  prerelease: false
+  version_requirements: *2161298080
+description: ! "Descriptive configuration files for Ruby written in Ruby.\n\nLoquacious
+  provides a very open configuration system written in ruby and\ndescriptions for
+  each configuration attribute. The attributes and descriptions\ncan be iterated over
+  allowing for helpful information about those attributes to\nbe displayed to the
+  user.\n\nIn the simple case we have a file something like\n\n  Loquacious.configuration_for('app')
+  {\n    name 'value', :desc => \"Defines the name\"\n    foo  'bar',   :desc => \"FooBar\"\n
+  \   id   42,      :desc => \"Ara T. Howard\"\n  }\n\nWhich can be loaded via the
+  standard Ruby loading mechanisms\n\n  Kernel.load 'config/app.rb'\n\nThe attributes
+  and their descriptions can be printed by using a Help object\n\n  help = Loquacious.help_for('app')\n
+  \ help.show :values => true        # show the values for the attributes, too\n\nDescriptions
+  are optional, and configurations can be nested arbitrarily deep.\n\n  Loquacious.configuration_for('nested')
+  {\n    desc \"The outermost level\"\n    a {\n      desc \"One more level in\"\n
+  \     b {\n        desc \"Finally, a real value\"\n        c 'value'\n      }\n
+  \   }\n  }\n\n  config = Loquacious.configuration_for('nested')\n\n  p config.a.b.c
+  \ #=> \"value\"\n\nAnd as you can see, descriptions can either be given inline after
+  the value or\nthey can appear above the attribute and value on their own line."
 email: tim.pease@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - History.txt
 - README.rdoc
-files: 
+files:
 - History.txt
 - README.rdoc
 - Rakefile
@@ -105,42 +64,31 @@ files:
 - spec/spec.opts
 - spec/spec_helper.rb
 - spec/string_spec.rb
-- tmp.rb
 - version.txt
-has_rdoc: true
 homepage: http://rubygems.org/gems/loquacious
 licenses: []
-
 post_install_message: 
-rdoc_options: 
+rdoc_options:
 - --main
 - README.rdoc
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: loquacious
-rubygems_version: 1.3.7
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
 summary: Descriptive configuration files for Ruby written in Ruby.
 test_files: []
-

data/tmp.rb

@@ -1,15 +0,0 @@
-#!/usr/bin/env ruby
-
-$:.unshift 'lib'
-require 'loquacious'
-
-config = Loquacious.configuration_for('test') {}
-
-Loquacious.defaults_for('test') {
-  bar(Proc.new { config.foo + '.bar' })
-  foo 'foo'
-}
-
-$stdout.puts "foo => #{config.foo}"
-$stdout.puts "bar => #{config.bar}"
-