Konfigurator

Konfigurator is a configuration toolkit strongly inspired by Sinatra framework settings. Thanks to it you can easy implement configuration options to your apps, modules or classes. Take a look at simple example.

Installation

You can install Konfigurator simply using rubygems:

sudo gem install konfigurator

…or install it from source:

git clone git://github.com/nu7hatch/konfigurator.git
cd konfigurator
rake install

Basic usage

Konfigurator is very easy to use. Take a look at simple example.

class MyClass do 
  include Konfigurator

  set :foo, "bar"
  enable :bar
  disable :bla

  configure :production
    enable :bla
    set :spam, "eggs!"
  end
end

Now you can get configured options directly from your class:

MyClass.foo # => "bar"
MyClass.bar # => true
MyClass.bla # => false

… or when current environment is set to :production:

MyClass.bla  # => true
MyClass.spam # => "eggs!"

All settings are also available from objects via #settings method:

obj = MyObject.new
obj.settings.foo # => "bar"
obk.settings.bar # => true

Remember! when option is not set then NoMethodError will be raised after try to get it direcly from class, eg:

MyObject.set :exist
MyObject.exist      # => true
MyObject.not_exist  # => will raise NoMethodError

Note on Patches/Pull Requests

Fork the project.
Make your feature addition or bug fix.
Add tests for it. This is important so I don’t break it in a future version unintentionally.
Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
Send me a pull request. Bonus points for topic branches.

Konfigurator

Installation

Basic usage

Note on Patches/Pull Requests

Copyright