Iqeo::Configuration

A DSL representing configuration files.

Installation

It`s a gem...

$ gem install iqeo-conf

Usage

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

require 'iqeo/configuration'
include Iqeo

Create configuration

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

Explicit

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"

Block DSL

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

Eval DSL

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

Read configuration

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

Directly

Named method

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

[ 'string' ]

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

[ :symbol ]

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

Indirectly

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

Hash & Enumerable methods

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

Features

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
blank slate for DSL

Fancy usage

Dynamic settings by '[]' & '[]=' & 'self'
Multiple configuration files
Hierarchial configuration files

License

Licensed under GPL Version 3 license. See LICENSE file.