loquacious 1.3.0 → 1.3.1

data/History.txt

@@ -1,3 +1,10 @@
+== 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
+
 == 1.3.0 / 2009-04-05
 
 * 1 minor enhancement

data/lib/loquacious.rb

@@ -2,7 +2,7 @@
 module Loquacious
 
   # :stopdoc:
-  VERSION = '1.3.0'
+  VERSION = '1.3.1'
   LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
   PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
   # :startdoc:
@@ -67,6 +67,27 @@ module Loquacious
       Dir.glob(search_me).sort.each {|rb| require rb}
     end
 
+    # This is merely a convenience method to remove methods from the
+    # Loquacious::Configuration class. Some ruby gems add lots of crap to the
+    # Kernel module, and this interferes with the configuration system. The
+    # remove method should be used to anihilate unwanted methods from the
+    # configuration class as needed.
+    #
+    #   Loquacious.remove :gem           # courtesy of rubygems
+    #   Loquacious.remove :test, :file   # courtesy of rake
+    #
+    def remove( *args )
+      args.each { |name|
+        name = name.to_s.delete('=')
+        code = <<-__
+          undef_method :#{name} rescue nil
+          undef_method :#{name}= rescue nil
+        __
+        Loquacious::Configuration.module_eval code
+        Loquacious::Configuration::DSL.module_eval code
+      }
+    end
+
   end  # class << self
 end  # module Loquacious
 

data/lib/loquacious/configuration.rb

@@ -80,8 +80,8 @@ module Loquacious
           v = (1 == args.length ? args.first : args)
           v = nil if args.empty?
           v = DSL.evaluate(&block) if block
-          
-          return @#{m} unless v
+
+          return @#{m} unless v or v == false
 
           if @#{m}.kind_of?(Configuration)
             @#{m}.merge! v
@@ -162,7 +162,7 @@ module Loquacious
 
       instance_methods.each do |m|
         undef_method m unless m[%r/^__/] or m.to_s == 'object_id'
-      end 
+      end
 
       # Create a new DSL and evaluate the given _block_ in the context of
       # the DSL. Returns a newly created configuration object.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: loquacious
 version: !ruby/object:Gem::Version 
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors: 
 - Tim Pease
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-04-05 00:00:00 -06:00
+date: 2009-10-30 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -20,7 +20,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.2.2
+        version: 1.2.8
     version: 
 - !ruby/object:Gem::Dependency 
   name: bones
@@ -30,9 +30,52 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.5.0
+        version: 2.5.1
     version: 
-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."
+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.
 email: tim.pease@gmail.com
 executables: []
 
@@ -76,6 +119,8 @@ files:
 - tasks/zentest.rake
 has_rdoc: true
 homepage: http://codeforpeople.rubyforge.org/loquacious
+licenses: []
+
 post_install_message: 
 rdoc_options: 
 - --main
@@ -97,9 +142,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: codeforpeople
-rubygems_version: 1.3.1
+rubygems_version: 1.3.5
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: Descriptive configuration files for Ruby written in Ruby
 test_files: []