choices 0.1.0

data/README.md

@@ -0,0 +1,49 @@
+The choice is yours
+===================
+
+Easy-peasy external settings for your Rails app.
+
+    # Gemfile
+    gem 'choices'
+
+In your app initializer block:
+
+    config.from_file 'settings.yml'
+
+This will read configuration from "config/settings.yml" and, additionally, "settings.local.yml" if it exists. You should check the main file into version control, but not the ".local" file which is to be used for per-machine configuration: tweaks in development or private keys in production, for example.
+
+    # .gitignore
+    config/settings.local.yml
+
+Configuration files can contain ERB; this is useful for reading in Heroku configuration. For example:
+
+    # settings.yml
+    defaults: &defaults
+      secret_token: <%= ENV['COOKIE_SECRET'] %>
+      heroku: <%= !!ENV['HEROKU_TYPE'] %>
+      mongodb:
+        uri: <%= ENV['MONGOHQ_URL'] %>
+
+    development:
+      <<: *defaults
+
+    test: &testing
+      <<: *defaults
+      secret_token: <%= "banana" * 5 %>
+      mongodb:
+        database: myapp_test
+
+    cucumber:
+      <<: *testing
+
+The ".local" file can contain overrides for your development environment:
+
+    # settings.local.yml
+    development:
+      mongodb:
+        database: myapp_dev
+
+Finally, the config keys can be read in your app as such:
+
+    Rails.configuration.heroku              #=> false
+    Rails.configuration.mongodb.database    #=> "myapp_dev"

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/choices.rb

@@ -0,0 +1,40 @@
+require 'hashie/mash'
+require 'erb'
+
+module Choices
+  extend self
+  
+  def load_settings(filename, env)
+    mash = Hashie::Mash.new(load_settings_hash(filename, env))
+    
+    with_local_settings(filename, env, '.local') do |local|
+      mash.update local
+    end
+    
+    return mash
+  end
+  
+  def load_settings_hash(filename, env)
+    yaml_content = ERB.new(IO.read(filename)).result
+    YAML::load(yaml_content)[env]
+  end
+  
+  def with_local_settings(filename, env, suffix)
+    local_filename = filename.sub(/(\.\w+)?$/, "#{suffix}\\1")
+    if File.exists? local_filename
+      hash = load_settings_hash(local_filename, env)
+      yield hash if hash
+    end
+  end
+end
+
+if defined? Rails::Application::Configuration
+  Rails::Application::Configuration.class_eval do
+    def from_file(name)
+      file = self.root + 'config' + name
+      Choices.load_settings(file, Rails.env.to_s).each do |key, value|
+        self.send("#{key}=", value)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification 
+name: choices
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- "Mislav Marohni\xC4\x87"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-23 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 0
+        - 4
+        - 0
+        version: 0.4.0
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: mislav.marohnic@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- lib/choices.rb
+- README.md
+has_rdoc: false
+homepage: http://github.com/mislav/choices
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Easy settings for your app
+test_files: []
+