app_conf 0.2.0 → 0.2.1

data/{README.md → README.markdown}

@@ -35,7 +35,7 @@ Or individually:
     AppConf.load(filename1)
     AppConf.load(filename2)
 
-Use either method calls or hash:
+Use either method calls or hash syntax:
     AppConf.fullname
     AppConf[:fullname]
     AppConf['fullname']
@@ -48,7 +48,7 @@ Override existing values:
     AppConf['loaded']['from']['yaml'] = 'can override'
 
 Set new values:
-    AppConf.non.existing.value = 'can set'
+    AppConf.non_existing_value = 'can set'
 
 Clear entire tree:
     AppConf.clear
@@ -57,6 +57,9 @@ Returns nil for non-existent keys:
     AppConf.non_existing -> nil
     AppConf.non_existing.name -> NoMethodError: undefined method 'name' for nil:NilClass
 
+Use `from_hash` to create non-existent nodes:
+    AppConf.from_hash({...})
+
 Not dependent on Rails but easy to use with it. For example:
     AppConf.load('config.yml', "#{Rails.env}.yml")
 
@@ -73,3 +76,8 @@ Why
 * Others are either too simple or incomplete, lack documentation or aren't Gem installable
 * Because I can :-)
 
+Known Issues
+----------------------------------
+Cannot assign values to unknown nested keys because they return nil (create the tree first):
+    AppConf.from_hash({:non_existing => {:name => 'bla'}})
+

data/app_conf.gemspec

@@ -2,7 +2,7 @@ require 'base64'
 
 Gem::Specification.new do |s|
   s.name        = 'app_conf'
-  s.version     = '0.2.0'
+  s.version     = '0.2.1'
   s.authors     = 'Phil Thompson'
   s.email       = Base64.decode64("cGhpbEBlbGVjdHJpY3Zpc2lvbnMuY29t\n")
   s.summary     = 'Simplest YAML Backed Application Wide Configuration (AppConfig)'

data/lib/app_conf.rb

@@ -1,30 +1,30 @@
 require 'yaml'
 
 class AppConf
-  private_class_method :new
+  @@root = new
+
   def initialize
-    @config = {}
+    @hash = {}
   end
-  @@config = new
 
   def self.load(*filenames)
     filenames.each do |filename|
-      recurse(YAML.load(File.open(filename)), @@config)
+      from_hash(YAML.load(File.open(filename)))
     end
   end
 
   def self.clear
-    @@config = new
+    @@root = new
     nil
   end
 
   def [](key)
-    @config[key.to_s]
+    value = @hash[key.to_s]
   end
 
   def []=(key, value)
-    raise "Not allowed to overwrite nested entities" if @config[key.to_s].is_a?(AppConf)
-    @config[key.to_s] = value
+    raise "Not allowed to overwrite nested entities" if @hash[key.to_s].is_a?(AppConf)
+    @hash[key.to_s] = value
   end
 
   def method_missing(method, *args, &block)
@@ -36,15 +36,14 @@ class AppConf
   end
 
   def self.method_missing(method, *args, &block)
-    @@config.send(method, *args)
+    @@root.send(method, *args)
   end
 
-private
-  def self.recurse(hash, app_config)
+  def self.from_hash(hash, app_config = @@root)
     hash.each do |key, value|
       if value.is_a?(Hash)
         new_app_config = new
-        value = recurse(value, app_config[key] || new_app_config)
+        value = from_hash(value, app_config[key] || new_app_config)
       end
       app_config[key] = value if new_app_config.nil? || value === new_app_config
     end

data/spec/app_conf_spec.rb

@@ -9,6 +9,12 @@ describe AppConf do
     AppConf.load("#{@dir}/config.yml")
   end
 
+  it 'creates from a hash' do
+    AppConf.clear
+    AppConf.from_hash({:user => {:name => {:first => 'Joe'}}})
+    AppConf.user.name.first.must_equal 'Joe'
+  end
+
   it 'works with dot notation' do
     AppConf.fullname.must_equal 'Joe Bloggs'
   end
@@ -73,10 +79,6 @@ describe AppConf do
   end
 
   describe 'limitations' do
-    it 'cannot be instantiated directly' do
-      AppConf.new.must_be_nil
-    end
-
     it 'returns nil when unknown key specified' do
       AppConf.unknown.must_be_nil
     end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 2
-  - 0
-  version: 0.2.0
+  - 1
+  version: 0.2.1
 platform: ruby
 authors: 
 - Phil Thompson
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-27 00:00:00 +00:00
+date: 2011-03-05 00:00:00 +00:00
 default_executable: 
 dependencies: []
 
@@ -29,7 +29,7 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - LICENSE
-- README.md
+- README.markdown
 - Rakefile
 - app_conf.gemspec
 - lib/app_conf.rb