ez_config

This gem can load your yaml configuration files from a specified path.

The idea behind this type of configuration is a similar concept to the traditional database.yml file found in Rails applications. This file specifies all environments for a service in one file, instead of all services for an environment in one file.

Install

Terminal:

gem install ez_config

Bundler:

gem 'ez_config'

Usage

The following example creates a new EzConfig object and loads all configurations from your applications config directory. Obviously you can use this gem in any ruby project, and it is not rails specific.

@config = EzConfig.new({
  :env          => Rails.env,
  :path         => "#{Rais.root}/config"
})

To configure a new service called new_service, you will create a YML file in your config direcotry. The file has to have an extension of .yml. The name of the file will become the config key. This file has to contain at least two environments, production and non_production:

non_production:
  uri: http://dev.path.to.new.service
  something: else

production:
  uri: http://path.to.new.service
  something: else

After this file has been created, access to it can be obtained by doing:

@config['new_service']
# {'uri' => 'http://path.to.new.service', 'something' => 'else'}

By the fault if your env name does not start with production and is not specified in your yaml file, EzConfig will load the default non_production env. If your env name starts with production( e.g. production-1 ), and is not specified in your yaml file, it will load the default production env. This simplifies configuration for large projects that may have many a dozen different environments.

Lastly, if your cretiria in recognizing production and production environments differs from the default, you can pass in :production_regex to specify your own cretieria. The example below determins whether to use production or non_production configurations by checking if current environment ends with -prod

@config = EzConfig.new({
  :env          => Rails.env,
  :path         => "#{Rais.root}/config",
  :production_regex => /-prod$/
})

Contributing to ez_config

Copyright © 2012 Aaron Qian. See LICENSE.txt for further details.