configuration 1.2.0 → 1.3.1

data/README.rdoc

@@ -0,0 +1,221 @@
+= configuration.rb
+pure ruby scoped configuration files
+
+== Description
+configuration.rb provides a mechanism for configuring ruby programs with
+ruby configuration files.  a configuration.rb file, for example
+'config/app.rb', can be written simply as
+
+  Configuration.for('app') {
+    key 'value'
+    foo 'bar'
+    port 42
+  }
+  
+and loaded via the normal ruby require/load mechanism
+
+  Kernel.load 'config/app.rb'
+
+or with a slightly augmented loading mechnanism which simply searches an
+extra set of paths in *addition* to the standard ones
+
+  Configuration.path = %w( config configuration )
+
+  Configuration.load 'app'
+
+configurations are completely open
+
+  Configuration.for('app') {
+    object_id 'very open'
+  }
+
+support arbitrarily nested values
+
+  Configuration.for('app') {
+    a { b { c { d 42 } } }
+  }
+
+  c = Configuration.for 'app'
+
+  p c.a.b.c.d #=> 42
+
+allow POLS scoped lookup of vars
+
+  Configuration.for('config') {
+    outer 'bar'
+
+    inner {
+      value 42
+    }
+  }
+
+  c = Configuration.for 'config'
+
+  p c.outer       #=> 'bar'
+  p c.inner.value #=> 42
+  p c.inner.outer #=> 'bar'
+
+allow default values
+
+  default = Configuration.for( 'default' ) {
+    a 1
+    b 2
+  }
+
+  c = Configuration.for( 'config', default ) {
+   a 10
+  }
+
+  p c.a     #=> 10
+  p c.b     #=> 2
+
+and not a whole lot else - configuration.rb is s very small library
+consisting of one file and < 150 loc
+
+== Samples
+
+=== samples/a.rb
+  ~ > cat samples/a.rb
+
+    #
+    # basic usage is quite, simple, load the config and use it's values.  the
+    # config syntax is fairly obvious, i think, but note that it *is* ruby and any
+    # ruby can be included.  also note that each config is named, allowing
+    # multiple configs to be places in one file
+    #
+      require 'configuration'
+
+      c = Configuration.load 'a'
+
+      p c.a + c.b - c.c
+
+  ~ > ruby samples/a.rb
+
+    42
+
+
+=== samples/b.rb
+  ~ > cat samples/b.rb
+
+    #
+    # configuration.rb supports a very natural nesting syntax.  note how values
+    # are scoped in a POLS fashion
+    #
+      require 'configuration'
+
+      c = Configuration.for 'b'
+
+      p c.www.url
+      p c.db.url
+      p c.mail.url
+
+  ~ > ruby samples/b.rb
+
+    "http://codeforpeople.com:80"
+    "db://codeforpeople.com:5342"
+    "mail://gmail.com:25"
+
+
+=== samples/c.rb
+  ~ > cat samples/c.rb
+
+    #
+    # configuration.rb let's you keep code very dry.
+    #
+
+      require 'configuration'
+
+      Configuration.load 'c'
+
+      p Configuration.for('development').db
+      p Configuration.for('production').db
+      p Configuration.for('testing').db
+
+  ~ > ruby samples/c.rb
+
+    "db/development"
+    "db/production"
+    "db/testing"
+
+
+=== samples/d.rb
+  ~ > cat samples/d.rb
+
+    #
+    # configuration.rb makes use of an external blank slate dsl, this means that
+    # you Configuration objects do, in fact, have all built-in ruby methods such
+    # as #inspect, etc, *unless* you configure over the top of them.  the effect
+    # is a configuration object that behaves like a nice ruby object, but which
+    # allows *any* key to be configured
+    #
+      require 'configuration'
+
+      c = Configuration.for 'd'
+
+      p c.object_id
+      p c.inspect
+      p c.p
+
+  ~ > ruby samples/d.rb
+
+    config/d.rb:2:in `object_id': wrong number of arguments (1 for 0) (ArgumentError)
+      from config/d.rb:2
+      from ./lib/configuration.rb:159:in `instance_eval'
+      from ./lib/configuration.rb:159:in `call'
+      from ./lib/configuration.rb:159:in `method_missing'
+      from ./lib/configuration.rb:105:in `evaluate'
+      from ./lib/configuration.rb:68:in `initialize'
+      from ./lib/configuration.rb:29:in `new'
+      from ./lib/configuration.rb:29:in `for'
+      from config/d.rb:1
+      from ./lib/configuration.rb:53:in `load'
+      from ./lib/configuration.rb:53:in `load'
+      from ./lib/configuration.rb:31:in `for'
+      from samples/d.rb:10
+
+
+=== samples/e.rb
+  ~ > cat samples/e.rb
+
+    #
+    # configuration.rb uses a totally clean slate dsl for the block.  if you need
+    # to access base Object methods you can do this
+    #
+
+      require 'configuration'
+
+      c = Configuration.for 'e'
+
+      p c.foo
+      p c.bar
+      p c.foobar
+
+  ~ > ruby samples/e.rb
+
+    42
+    "forty-two"
+    42.0
+
+=== samples/f.rb
+  ~ > cat samples/f.rb
+
+    #
+    # configuration.rb let's you inherit values from another configuration.
+    # Like this, you keep your code very dry.
+    #
+
+      require 'configuration'
+
+      Configuration.load 'f'
+
+      p c.a
+      p c.b
+
+  ~ > ruby samples/f.rb
+
+    10
+    2
+
+
+== Author
+ara.t.howard@gmail.com

data/Rakefile

@@ -1,23 +1,66 @@
+This.rubyforge_project = 'codeforpeople'
 This.author = "Ara T. Howard"
 This.email = "ara.t.howard@gmail.com"
-This.homepage = "http://github.com/ahoward/#{ This.lib }/tree/master"
-This.rubyforge_project = 'codeforpeople'
+This.homepage = "https://github.com/ahoward/#{ This.lib }"
+
 
 task :default do
-  puts(Rake::Task.tasks.map{|task| task.name} - ['default'])
+  puts((Rake::Task.tasks.map{|task| task.name.gsub(/::/,':')} - ['default']).sort)
+end
+
+task :test do
+  run_tests!
+end
+
+namespace :test do
+  task(:unit){ run_tests!(:unit) }
+  task(:functional){ run_tests!(:functional) }
+  task(:integration){ run_tests!(:integration) }
 end
 
-task :spec do
-  require 'spec/rake/spectask'
-  Spec::Rake::SpecTask.new do |t|
-    t.spec_files = FileList['spec/*_spec.rb']
+def run_tests!(which = nil)
+  which ||= '**'
+  test_dir = File.join(This.dir, "test")
+  test_glob ||= File.join(test_dir, "#{ which }/**_test.rb")
+  test_rbs = Dir.glob(test_glob).sort
+        
+  div = ('=' * 119)
+  line = ('-' * 119)
+
+  test_rbs.each_with_index do |test_rb, index|
+    testno = index + 1
+    command = "#{ This.ruby } -I ./lib -I ./test/lib #{ test_rb }"
+
+    puts
+    say(div, :color => :cyan, :bold => true)
+    say("@#{ testno } => ", :bold => true, :method => :print)
+    say(command, :color => :cyan, :bold => true)
+    say(line, :color => :cyan, :bold => true)
+
+    system(command)
+
+    say(line, :color => :cyan, :bold => true)
+
+    status = $?.exitstatus
+
+    if status.zero? 
+      say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      say("SUCCESS", :color => :green, :bold => true)
+    else
+      say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      say("FAILURE", :color => :red, :bold => true)
+    end
+    say(line, :color => :cyan, :bold => true)
+
+    exit(status) unless status.zero?
   end
 end
 
+
 task :gemspec do
-  ignore_extensions = 'git', 'svn', 'tmp', /sw./, 'bak', 'gem'
-  ignore_directories = 'pkg'
-  ignore_files = 'test/log'
+  ignore_extensions = ['git', 'svn', 'tmp', /sw./, 'bak', 'gem']
+  ignore_directories = ['pkg']
+  ignore_files = ['test/log']
 
   shiteless = 
     lambda do |list|
@@ -39,14 +82,18 @@ task :gemspec do
     end
 
   lib         = This.lib
+  object      = This.object
   version     = This.version
   files       = shiteless[Dir::glob("**/**")]
   executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
-  has_rdoc    = true #File.exist?('doc')
+  #has_rdoc    = true #File.exist?('doc')
   test_files  = "test/#{ lib }.rb" if File.file?("test/#{ lib }.rb")
+  summary     = object.respond_to?(:summary) ? object.summary : "summary: #{ lib } kicks the ass"
+  description = object.respond_to?(:description) ? object.description : "description: #{ lib } kicks the ass"
 
-  extensions = This.extensions
-  if extensions.nil?
+  if This.extensions.nil?
+    This.extensions = []
+    extensions = This.extensions
     %w( Makefile configure extconf.rb ).each do |ext|
       extensions << ext if File.exists?(ext)
     end
@@ -67,18 +114,17 @@ task :gemspec do
             spec.version = #{ version.inspect }
             spec.platform = Gem::Platform::RUBY
             spec.summary = #{ lib.inspect }
+            spec.description = #{ description.inspect }
 
-            spec.files = #{ files.inspect }
+            spec.files =\n#{ files.sort.pretty_inspect }
             spec.executables = #{ executables.inspect }
             
-            <% if test(?d, 'lib') %>
             spec.require_path = "lib"
-            <% end %>
 
-            spec.has_rdoc = #{ has_rdoc.inspect }
             spec.test_files = #{ test_files.inspect }
-            #spec.add_dependency 'lib', '>= version'
-            #spec.add_dependency 'fattr'
+
+          ### spec.add_dependency 'lib', '>= version'
+          #### spec.add_dependency 'map'
 
             spec.extensions.push(*#{ extensions.inspect })
 
@@ -91,19 +137,21 @@ task :gemspec do
       }
     end
 
-  open("#{ lib }.gemspec", "w"){|fd| fd.puts template}
-  This.gemspec = "#{ lib }.gemspec"
+  Fu.mkdir_p(This.pkgdir)
+  gemspec = "#{ lib }.gemspec"
+  open(gemspec, "w"){|fd| fd.puts(template)}
+  This.gemspec = gemspec
 end
 
 task :gem => [:clean, :gemspec] do
-  Fu.mkdir_p This.pkgdir
+  Fu.mkdir_p(This.pkgdir)
   before = Dir['*.gem']
   cmd = "gem build #{ This.gemspec }"
   `#{ cmd }`
   after = Dir['*.gem']
   gem = ((after - before).first || after.first) or abort('no gem!')
-  Fu.mv gem, This.pkgdir
-  This.gem = File.basename(gem)
+  Fu.mv(gem, This.pkgdir)
+  This.gem = File.join(This.pkgdir, File.basename(gem))
 end
 
 task :readme do
@@ -122,7 +170,7 @@ task :readme do
     cmd = "ruby #{ sample }"
     samples << Util.indent(prompt + cmd, 2) << "\n\n"
 
-    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -Ilib -Iconfig #{ sample })'"
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -I ./lib #{ sample })'"
     samples << Util.indent(`#{ cmd } 2>&1`, 4) << "\n"
   end
 
@@ -159,9 +207,18 @@ task :release => [:clean, :gemspec, :gem] do
   gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
   raise "which one? : #{ gems.inspect }" if gems.size > 1
   raise "no gems?" if gems.size < 1
-  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.pkgdir }/#{ This.gem }"
+
+  cmd = "gem push #{ This.gem }"
+  puts cmd
+  puts
+  system(cmd)
+  abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
+
+  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.gem }"
   puts cmd
-  system cmd
+  puts
+  system(cmd)
+  abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
 end
 
 
@@ -169,44 +226,63 @@ end
 
 
 BEGIN {
+# support for this rakefile
+#
   $VERBOSE = nil
 
   require 'ostruct'
   require 'erb'
   require 'fileutils'
+  require 'rbconfig'
+  require 'pp'
 
+# fu shortcut
+#
   Fu = FileUtils
 
+# cache a bunch of stuff about this rakefile/environment
+#
   This = OpenStruct.new
 
   This.file = File.expand_path(__FILE__)
   This.dir = File.dirname(This.file)
   This.pkgdir = File.join(This.dir, 'pkg')
 
+# grok lib
+#
   lib = ENV['LIB']
   unless lib
-    lib = File.basename(Dir.pwd)
+    lib = File.basename(Dir.pwd).sub(/[-].*$/, '')
   end
   This.lib = lib
 
+# grok version
+#
   version = ENV['VERSION']
   unless version
-    name = lib.capitalize
-    library = "./lib/#{ lib }.rb"
-    program = "./bin/#{ lib }"
-    if test(?e, library)
-      require library
-      version = eval(name).send(:version)
-    elsif test(?e, program)
-      version = `#{ program } --version`.strip
-    end
-    abort('no version') if(version.nil? or version.empty?)
+    require "./lib/#{ This.lib }"
+    This.name = lib.capitalize
+    This.object = eval(This.name)
+    version = This.object.send(:version)
   end
   This.version = version
 
+# we need to know the name of the lib an it's version
+#
   abort('no lib') unless This.lib
   abort('no version') unless This.version
 
+# discover full path to this ruby executable
+#
+  c = Config::CONFIG
+  bindir = c["bindir"] || c['BINDIR']
+  ruby_install_name = c['ruby_install_name'] || c['RUBY_INSTALL_NAME'] || 'ruby'
+  ruby_ext = c['EXEEXT'] || ''
+  ruby = File.join(bindir, (ruby_install_name + ruby_ext))
+  This.ruby = ruby
+
+# some utils
+#
   module Util
     def indent(s, n = 2)
       s = unindent(s)
@@ -216,7 +292,7 @@ BEGIN {
 
     def unindent(s)
       indent = nil
-      s.each do |line|
+      s.each_line do |line|
       next if line =~ %r/^\s*$/
       indent = line[%r/^\s*/] and break
     end
@@ -225,17 +301,71 @@ BEGIN {
     extend self
   end
 
+# template support
+#
   class Template
     def initialize(&block)
       @block = block
       @template = block.call.to_s
     end
     def expand(b=nil)
-      ERB.new(Util.unindent(@template)).result(b||@block)
+      ERB.new(Util.unindent(@template)).result((b||@block).binding)
     end
     alias_method 'to_s', 'expand'
   end
   def Template(*args, &block) Template.new(*args, &block) end
 
+# colored console output support
+#
+  This.ansi = {
+    :clear      => "\e[0m",
+    :reset      => "\e[0m",
+    :erase_line => "\e[K",
+    :erase_char => "\e[P",
+    :bold       => "\e[1m",
+    :dark       => "\e[2m",
+    :underline  => "\e[4m",
+    :underscore => "\e[4m",
+    :blink      => "\e[5m",
+    :reverse    => "\e[7m",
+    :concealed  => "\e[8m",
+    :black      => "\e[30m",
+    :red        => "\e[31m",
+    :green      => "\e[32m",
+    :yellow     => "\e[33m",
+    :blue       => "\e[34m",
+    :magenta    => "\e[35m",
+    :cyan       => "\e[36m",
+    :white      => "\e[37m",
+    :on_black   => "\e[40m",
+    :on_red     => "\e[41m",
+    :on_green   => "\e[42m",
+    :on_yellow  => "\e[43m",
+    :on_blue    => "\e[44m",
+    :on_magenta => "\e[45m",
+    :on_cyan    => "\e[46m",
+    :on_white   => "\e[47m"
+  }
+  def say(phrase, *args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    options[:color] = args.shift.to_s.to_sym unless args.empty?
+    keys = options.keys
+    keys.each{|key| options[key.to_s.to_sym] = options.delete(key)}
+
+    color = options[:color]
+    bold = options.has_key?(:bold)
+
+    parts = [phrase]
+    parts.unshift(This.ansi[color]) if color
+    parts.unshift(This.ansi[:bold]) if bold
+    parts.push(This.ansi[:clear]) if parts.size > 1
+
+    method = options[:method] || :puts
+
+    Kernel.send(method, parts.join)
+  end
+
+# always run out of the project dir
+#
   Dir.chdir(This.dir)
 }

data/config/f.rb

@@ -0,0 +1,12 @@
+default = Configuration.for( 'default' ) {
+
+  a 1
+  b 2
+
+}
+
+Configuration.for( 'f', default ) {
+
+  a 10
+  
+}

data/configuration.gemspec

@@ -3,26 +3,46 @@
 
 Gem::Specification::new do |spec|
   spec.name = "configuration"
-  spec.version = "1.2.0"
+  spec.version = "1.3.1"
   spec.platform = Gem::Platform::RUBY
   spec.summary = "configuration"
+  spec.description = "description: configuration kicks the ass"
+
+  spec.files =
+["LICENSE",
+ "README.rdoc",
+ "Rakefile",
+ "config",
+ "config/a.rb",
+ "config/b.rb",
+ "config/c.rb",
+ "config/d.rb",
+ "config/e.rb",
+ "config/f.rb",
+ "configuration.gemspec",
+ "lib",
+ "lib/configuration.rb",
+ "samples",
+ "samples/a.rb",
+ "samples/b.rb",
+ "samples/c.rb",
+ "samples/d.rb",
+ "samples/e.rb",
+ "samples/f.rb"]
 
-  spec.files = ["config", "config/a.rb", "config/b.rb", "config/c.rb", "config/d.rb", "config/e.rb", "configuration.gemspec", "lib", "lib/configuration.rb", "LICENSE", "Rakefile", "README", "README.erb", "samples", "samples/a.rb", "samples/b.rb", "samples/c.rb", "samples/d.rb", "samples/e.rb"]
   spec.executables = []
   
-  
   spec.require_path = "lib"
-  
 
-  spec.has_rdoc = true
   spec.test_files = nil
-  #spec.add_dependency 'lib', '>= version'
-  #spec.add_dependency 'fattr'
+
+### spec.add_dependency 'lib', '>= version'
+#### spec.add_dependency 'map'
 
   spec.extensions.push(*[])
 
   spec.rubyforge_project = "codeforpeople"
   spec.author = "Ara T. Howard"
   spec.email = "ara.t.howard@gmail.com"
-  spec.homepage = "http://github.com/ahoward/configuration/tree/master"
+  spec.homepage = "https://github.com/ahoward/configuration"
 end

data/lib/configuration.rb

@@ -1,5 +1,5 @@
 class Configuration
-  Configuration::Version = '1.2.0'
+  Configuration::Version = '1.3.1'
   def Configuration.version() Configuration::Version end
 
   Path = [
@@ -16,6 +16,8 @@ class Configuration
   module ClassMethods
     def for name, options = nil, &block
       name = name.to_s
+      options = options.to_hash if options.is_a?( Configuration )
+
       if Table.has_key?(name)
         if options or block
           configuration = Table[name]
@@ -132,8 +134,10 @@ class Configuration
 
     def self.evaluate configuration, options = {}, &block
       dsl = new configuration
-      Pure[dsl].instance_eval(&block) if block
+      
       options.each{|key, value| Pure[dsl].send key, value}
+      Pure[dsl].instance_eval(&block) if block
+
       Pure[dsl].instance_eval{ @__configuration }
     end
 

data/samples/f.rb

@@ -0,0 +1,11 @@
+#
+# configuration.rb let's you inherit values from another configuration.
+# Like this, you keep your code very dry.
+#
+
+  require 'configuration'
+
+  c = Configuration.for 'f'
+
+  p c.a
+  p c.b

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: configuration
 version: !ruby/object:Gem::Version 
-  hash: 31
-  prerelease: false
+  hash: 25
+  prerelease: 
   segments: 
   - 1
-  - 2
-  - 0
-  version: 1.2.0
+  - 3
+  - 1
+  version: 1.3.1
 platform: ruby
 authors: 
 - Ara T. Howard
@@ -15,11 +15,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-18 00:00:00 -07:00
+date: 2011-06-20 00:00:00 -06:00
 default_executable: 
 dependencies: []
 
-description: 
+description: "description: configuration kicks the ass"
 email: ara.t.howard@gmail.com
 executables: []
 
@@ -28,24 +28,25 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- LICENSE
+- README.rdoc
+- Rakefile
 - config/a.rb
 - config/b.rb
 - config/c.rb
 - config/d.rb
 - config/e.rb
+- config/f.rb
 - configuration.gemspec
 - lib/configuration.rb
-- LICENSE
-- Rakefile
-- README
-- README.erb
 - samples/a.rb
 - samples/b.rb
 - samples/c.rb
 - samples/d.rb
 - samples/e.rb
+- samples/f.rb
 has_rdoc: true
-homepage: http://github.com/ahoward/configuration/tree/master
+homepage: https://github.com/ahoward/configuration
 licenses: []
 
 post_install_message: 
@@ -74,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: codeforpeople
-rubygems_version: 1.3.7
+rubygems_version: 1.4.2
 signing_key: 
 specification_version: 3
 summary: configuration

data/README

@@ -1,197 +0,0 @@
-NAME
-  configuration.rb
-
-SYNOPSIS
-  pure ruby scoped configuration files
-
-DESCRIPTION
-  configuration.rb provides a mechanism for configuring ruby programs with
-  ruby configuration files.  a configuration.rb file, for example
-  'config/app.rb', can be written simply as
-
-      Configuration.for('app'){
-        key 'value'
-        foo 'bar'
-        port 42
-      }
-  
-  and loaded via the normal ruby require/load mechanism
-
-      Kernel.load 'config/app.rb'
-  
-  or with a slightly augmented loading mechnanism which simply searches an
-  extra set of paths in *addition* to the standard ones
-
-      Configuration.path = %w( config configuration )
-
-      Configuration.load 'app'
-
-  configurations are completely open
-
-      Configuration.for('app'){
-        object_id 'very open'
-      }
-
-  support arbitrarily nested values
-
-      Configuration.for('app'){
-        a { b { c { d 42 } } }
-      }
-
-      c = Configuration.for 'app'
-
-      p c.a.b.c.d #=> 42
-
-  allow POLS scoped lookup of vars
-
-    Configuration.for('config'){
-      outer 'bar'
-
-      inner {
-        value 42
-      }
-    }
-
-    c = Configuration.for 'config'
-
-    p c.outer       #=> 'bar'
-    p c.inner.value #=> 42
-    p c.inner.outer #=> 'bar' 
-  
-
-  and not a whole lot else - configuration.rb is s very small library
-  consisting of one file and < 150 loc
-
-SAMPLES
-
-  <========< samples/a.rb >========>
-
-  ~ > cat samples/a.rb
-
-    #
-    # basic usage is quite, simple, load the config and use it's values.  the
-    # config syntax is fairly obvious, i think, but note that it *is* ruby and any
-    # ruby can be included.  also note that each config is named, allowing
-    # multiple configs to be places in one file 
-    #
-      require 'configuration'
-     
-      c = Configuration.load 'a'
-    
-      p c.a + c.b - c.c
-
-  ~ > ruby samples/a.rb
-
-    42
-
-
-  <========< samples/b.rb >========>
-
-  ~ > cat samples/b.rb
-
-    #
-    # configuration.rb supports a very natural nesting syntax.  note how values
-    # are scoped in a POLS fashion
-    #
-      require 'configuration'
-    
-      c = Configuration.for 'b' 
-    
-      p c.www.url
-      p c.db.url
-      p c.mail.url
-
-  ~ > ruby samples/b.rb
-
-    "http://codeforpeople.com:80"
-    "db://codeforpeople.com:5342"
-    "mail://gmail.com:25"
-
-
-  <========< samples/c.rb >========>
-
-  ~ > cat samples/c.rb
-
-    #
-    # configuration.rb let's you keep code very dry.
-    #
-    
-      require 'configuration'
-    
-      Configuration.load 'c'
-    
-      p Configuration.for('development').db
-      p Configuration.for('production').db
-      p Configuration.for('testing').db
-
-  ~ > ruby samples/c.rb
-
-    "db/development"
-    "db/production"
-    "db/testing"
-
-
-  <========< samples/d.rb >========>
-
-  ~ > cat samples/d.rb
-
-    #
-    # configuration.rb makes use of an external blank slate dsl, this means that
-    # you Configuration objects do, in fact, have all built-in ruby methods such
-    # as #inspect, etc, *unless* you configure over the top of them.  the effect
-    # is a configuration object that behaves like a nice ruby object, but which
-    # allows *any* key to be configured
-    #
-      require 'configuration'
-    
-      c = Configuration.for 'd' 
-    
-      p c.object_id
-      p c.inspect
-      p c.p
-
-  ~ > ruby samples/d.rb
-
-    config/d.rb:2:in `object_id': wrong number of arguments (1 for 0) (ArgumentError)
-    	from config/d.rb:2
-    	from ./lib/configuration.rb:159:in `instance_eval'
-    	from ./lib/configuration.rb:159:in `call'
-    	from ./lib/configuration.rb:159:in `method_missing'
-    	from ./lib/configuration.rb:105:in `evaluate'
-    	from ./lib/configuration.rb:68:in `initialize'
-    	from ./lib/configuration.rb:29:in `new'
-    	from ./lib/configuration.rb:29:in `for'
-    	from config/d.rb:1
-    	from ./lib/configuration.rb:53:in `load'
-    	from ./lib/configuration.rb:53:in `load'
-    	from ./lib/configuration.rb:31:in `for'
-    	from samples/d.rb:10
-
-
-  <========< samples/e.rb >========>
-
-  ~ > cat samples/e.rb
-
-    #
-    # configuration.rb uses a totally clean slate dsl for the block.  if you need
-    # to access base Object methods you can do this
-    #
-    
-      require 'configuration'
-    
-      c = Configuration.for 'e'
-    
-      p c.foo
-      p c.bar
-      p c.foobar
-
-  ~ > ruby samples/e.rb
-
-    42
-    "forty-two"
-    42.0
-
-
-
-AUTHOR
-  ara.t.howard@gmail.com

data/README.erb

@@ -1,69 +0,0 @@
-NAME
-  configuration.rb
-
-SYNOPSIS
-  pure ruby scoped configuration files
-
-DESCRIPTION
-  configuration.rb provides a mechanism for configuring ruby programs with
-  ruby configuration files.  a configuration.rb file, for example
-  'config/app.rb', can be written simply as
-
-      Configuration.for('app'){
-        key 'value'
-        foo 'bar'
-        port 42
-      }
-  
-  and loaded via the normal ruby require/load mechanism
-
-      Kernel.load 'config/app.rb'
-  
-  or with a slightly augmented loading mechnanism which simply searches an
-  extra set of paths in *addition* to the standard ones
-
-      Configuration.path = %w( config configuration )
-
-      Configuration.load 'app'
-
-  configurations are completely open
-
-      Configuration.for('app'){
-        object_id 'very open'
-      }
-
-  support arbitrarily nested values
-
-      Configuration.for('app'){
-        a { b { c { d 42 } } }
-      }
-
-      c = Configuration.for 'app'
-
-      p c.a.b.c.d #=> 42
-
-  allow POLS scoped lookup of vars
-
-    Configuration.for('config'){
-      outer 'bar'
-
-      inner {
-        value 42
-      }
-    }
-
-    c = Configuration.for 'config'
-
-    p c.outer       #=> 'bar'
-    p c.inner.value #=> 42
-    p c.inner.outer #=> 'bar' 
-  
-
-  and not a whole lot else - configuration.rb is s very small library
-  consisting of one file and < 150 loc
-
-SAMPLES
-<%= samples %>
-
-AUTHOR
-  ara.t.howard@gmail.com