Iqeo::Configuration

A DSL representing configuration files.

It`s a gem...

$ gem install iqeo-conf

Require 'iqeo/configuration' and optionally include Iqeo namespace:

require 'iqeo/configuration'
include Iqeo

There are three ways to create configurations; explicit, block DSL, eval DSL.

Call Configuration#new without a block. Explicitly call methods on instance to configure instance.

conf = Configuration.new
conf.alpha   1
conf.bravo   2.0
conf.charlie :three
conf.delta   "four"

Call Configuration#new with a block that expects a variable, a new instance will be yielded. Within block, call methods on yielded instance to configure.

conf = Configuration.new do |c|
  c.alpha   1
  c.bravo   2.0
  c.charlie :three
  c.delta   "four"
end

Call Configuration#new with a block that does not expect a variable, contents of the block are eval`d in the context of the new instance. Call methods with implied self to configure instance.

conf = Configuration.new do
  alpha   1
  bravo   2.0
  charlie :three
  delta   "four"
end

All examples above result in the same configuration. Configuration settings can be retrieved directly or indirectly.

conf.alpha        # => 1
conf.bravo        # => 2.0
conf.charlie      # => :three
conf.delta        # => "four"

conf['alpha']     # => 1
conf['bravo']     # => 2.0
conf['charlie']   # => :three
conf['delta']     # => "four"

conf[:alpha]      # => 1
conf[:bravo]      # => 2.0
conf[:charlie]    # => :three
conf[:delta]      # => "four"

The underlying storage is an indifferent hash, so the usual Hash and Enumerable methods work.

conf.size                           # => 4
conf.keys                           # => [ 'alpha', 'bravo', 'charlie', 'delta' ]
conf.collect { |key,value| value }  # => [ 1, 2.0, :three, 'four' ]

• settings by named methods
• settings by '[]' & '[]='
• settings & locals with '='
• referencing existing settings
• nested configurations
• inheritance & override
• read from string, at creation, or after - merged & nested
• load from filename, at creation, or after - merged & nested
• defaults
• merge configurations recursively
• blank slate for DSL
• wildcard * for chained usage: a.b.*.d

• Dynamic settings by '[]' & '[]=' & 'self'
• Multiple configuration files
• Hierarchial configuration files
• Validation: if a.b.*.d == true

Copyright Gerard Fowley (gerard.fowley@iqeo.net).

Licensed under GPL Version 3 license. See LICENSE file.