Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Yet another *fu - this time for rails configuration made easier
Ruby
branch: master

Remove Gemfile.lock

In an attempt to run with Rails 3.1.0. Gemfile.lock should not be in gem
repo anyway
latest commit adae666b82
@skanev skanev authored committed

README

Confu
=====

Confu is a micro-mini (think wicked weasel sized) utility I extracted from a couple of projects. Influenced by 
http://github.com/cjbottaro/app_config/tree/master
and 
http://github.com/railsmonk/configuration-file-plugin/tree/master

The main thing I wanted to change is that files are separated not by environment, but by concern. Each file can use merging (described below) to avoid repeating, and accidentally miss adding new stuff (which I constantly do). And you can also use ignore + yml.sample approach for sensitive config. 

Installation
============

Add it in your Gemfile

gem 'confu'

From your project's RAILS_ROOT, run:

rails generate confu:install

This will create sample config/site/app.yml file.
Then you put multiple yml files in the site folder. Each config file will result in {file_name}Config constant defined, loading the current environment's section values. 

So if you have site.yml, containing

development:
  home_page_entries: 3
production:
  home_page_entries: 5

You will have SiteConfig defined, and SiteConfig.home_page_entries returning 3 and 5 in development and production, respectively.

YAML has some neat DRY stuff, actually - check this out:
http://www.yaml.org/refcard.html


One thing that comes in handy is merging keys from mapping - like this.

development: &default
  home_page_entries: 3
  admin_entries: 4
production:
  <<: *default
  home_page_entries: 5

Copyright (c) 2009 Petyo Ivanov, released under the MIT license
Something went wrong with that request. Please try again.