easyconf-rails 0.1 → 0.2

data/README.md

@@ -0,0 +1,60 @@
+easyconf-rails
+==============
+
+easyconf-rails makes customizing your Rails application easy. (Surprise!) To use
+it, follow these simple steps:
+
+1.
+Add the following line to your project's `Gemfile`:
+
+	gem 'easyconf-rails'
+
+2.
+Run `bundle update`.
+
+3.
+Create a YAML file called `defaults.yml` in your project's `config`
+directory. This file will contain your project's default configuration values.
+Individual installations SHOULD NOT change this file. For example:
+
+	---
+	should_donate: 10
+	awesomeness:
+	  ruby: true
+	  rspec: true
+
+4.
+Create a YAML file called `config.yml` in your project's root directory. These
+settings will take precedence over the settings in `defaults.yml`, so you should
+instruct your users to change their settings here. For example:
+
+	---
+	should_support_easyconf: true
+	should_donate: 5
+	donate_to: 1A9hGUYswsMLNdaeH9qMrjoJKQGnYKgmT2
+	awesomeness:
+	  easyconf: true
+	  rails: true
+	  perl: false
+	  rspec: false
+
+	why_easyconf_is_awesome:
+	  - its_easiness
+	  - YAML
+	  -
+	    recursive_processing: true
+
+5.
+Now you're ready to use `config` in your application.
+
+	$config.should_support_easyconf # true
+	$config.should_donate # 5
+	$config.awesomeness.easyconf # true
+	$config.awesomeness.ruby # true
+	$config.awesomeness.rspec # false
+	$config.why_easyconf_is_awesome[0] # 'its_easiness'
+	$config.why_easyconf_is_awesome[2].recursive_processing # true
+	$config.variable_that_was_never_defined # raises NameError
+
+	# You can reload your configuration file by with .reload!.
+	$config.reload!

data/lib/easyconf-rails.rb

@@ -3,11 +3,34 @@ require 'ostruct'
 # SemiOpenStruct is like OpenStruct, except that accessing an uninitialized key
 # will raise a KeyError.
 class SemiOpenStruct < OpenStruct
+	# Return the value corresponding to +key.to_sym+, or raise +KeyError+ if no
+	# such value exists.
+	def [](key)
+		@table.fetch(key.to_sym)
+	end
+
+	# Set +key.to_sym+ to +val+.
+	def []=(key, val)
+		@table[key.to_sym] = val
+	end
+
 	# Return true if the given key is present.
 	def has_key?(key)
 		singleton_methods.grep(/[^=]$/).include?(key)
 	end
 
+	# Return a new array populated with our keys.
+	def keys
+		@table.keys
+	end
+
+	# Call the given block for every key and value we have.
+	def each # :yields: key, val
+		@table.each do |key, val|
+			yield(key, val)
+		end
+	end
+
 	def method_missing(key, *val)
 		if key.to_s.end_with?('=') and (val.length == 1)
 			super(key, val.first)
@@ -73,7 +96,14 @@ class EasyConfRails < Rails::Railtie
 		hash_to_openstruct(merge_hashes(config_hash, defaults_hash))
 	end
 
-	config.before_initialize do
+	# Assign $config to the result of load_config().
+	def assign_config()
 		$config = load_config()
+		$config.define_singleton_method(:reload!, &method(:assign_config))
+		$config
+	end
+
+	config.before_initialize do
+		assign_config()
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easyconf-rails
 version: !ruby/object:Gem::Version
-  version: '0.1'
+  version: '0.2'
   prerelease: 
 platform: ruby
 authors:
@@ -50,11 +50,11 @@ cert_chain:
   -----END CERTIFICATE-----
 
 '
-date: 2012-01-30 00:00:00.000000000 Z
+date: 2012-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &77519290 !ruby/object:Gem::Requirement
+  requirement: &78323930 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -62,7 +62,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *77519290
+  version_requirements: *78323930
 description: Configure Rails apps with a simple YAML file.
 email: the.magical.kat@gmail.com
 executables: []
@@ -70,6 +70,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/easyconf-rails.rb
+- README.md
 homepage: https://github.com/katmagic/easyconf-rails
 licenses: []
 post_install_message: