settings-tree 0.1.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--drb

data/Gemfile

@@ -0,0 +1,17 @@
+source 'http://rubygems.org'
+
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'recursive-open-struct'
+gem 'hash-deep-merge'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem 'rspec'    #, "~> 2.3.0"
+  gem 'bundler'  #, "~> 1.0.0"
+  gem 'jeweler'  #, "~> 1.6.0"
+  gem 'rcov'     #, ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    hash-deep-merge (0.1.1)
+    jeweler (1.6.0)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.0)
+    rcov (0.9.9)
+    recursive-open-struct (0.1.0)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.3)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  hash-deep-merge
+  jeweler
+  rcov
+  recursive-open-struct
+  rspec

data/LICENSE.txt

@@ -0,0 +1,7 @@
+No Copyright
+
+The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law.
+
+You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.
+
+http://creativecommons.org/publicdomain/zero/1.0/

data/README.rdoc

@@ -0,0 +1,111 @@
+= settings-tree
+
+== Introduction
+
+This gem offers you a convenient settings structure for parameterizing your applications.
+
+The good things over similar gems is the ability to have deep, recursive structures and the ability to have 'specialized' config according to the environment.
+
+Example :
+
+  Settings.web_app.infos.company_name     => 'Acme'
+  Settings.web_app.infos.app_name         => 'Coffe maker'
+  Settings.web_app.engine.workers_count   => 3
+
+Those settings are read from a YAML file, like this one :
+
+  # YAML private config file
+  # XXX Beware ! This YAML : indention with spaces only ! XXX
+  
+  ####### Common / default values #######
+  defaults:
+    root_url: localhost:3000
+    public_access: true
+    
+    infos:
+      company_name: 'Acme'
+      app_name: 'Coffe maker'
+      copyright_starting_year: 2011
+      legend: 'A superb app which does ...'
+    
+    engine:
+      workers_count: 3
+      auto_manage_workers: true
+      auto_manage_workers_redirect_output: true
+  
+  ####### production environment #######
+  production:
+  # nothing special
+  
+  ####### development environment #######
+  development:
+    engine:
+      auto_manage_workers_redirect_output: false
+  
+  ####### test environment #######
+  test:
+    engine:
+      workers_count: 0
+
+Note : the settings must reside under a root named 'defaults'. Other roots ('production', 'development'...) will be picked depending on the environment. (more about thet later)
+
+This gem has more good features, keep reading for more.
+
+Ideas taken from : http://kpumuk.info/ruby-on-rails/flexible-application-configuration-in-ruby-on-rails/
+
+== Installation
+Available as a gem
+  gem 'settings-tree'
+  
+Isn't it easy ?
+
+== Use
+Just register a settings group from a file :
+  Settings.register_settings_file('web_app', File.join(File.dirname(__FILE__), "config/config.yml"))
+or for ruby on rails :
+  Settings.register_settings_file('web_app', File.join(::Rails.root.to_s, "config/config.yml"))
+
+And now you can access your settings from anywhere :
+  puts Settings.web_app.infos.company_name
+
+Note : of course, the group name must be a valid keyword, able to be converted to a sym.
+
+You can register any number of group you want :
+  Settings.register_settings_file('web_game', File.join(File.dirname(__FILE__), "config/another_config.yml"))
+And then :
+  puts Settings.web_game.guild_name.should == 'gang'
+
+It's common to have settings that you don't want to stay under version control (accounts, passwords).
+A solution is to use a complementary file not under version control. Just use :
+  Settings.register_settings_file('web_app', File.join(File.dirname(__FILE__), "config/config_complement.yml"))
+And data will be merged, the new one taking precedence in case of conflicts.
+
+In case you want to reload the settings, you have two functions for that :
+  Settings.reload_all
+  Settings.reload_group('web_app')
+
+== Advanced use
+Note : since those functions are rarely used, they don't have 'Settings.' shortcuts. Don't mind, it's the same.
+=== Environment
+In a rails app, the environment will be taken automatically from 'Rails.env'. If not under a rails app or if the environment is not available, set it manually :
+  SettingsHolder.instance.environment = 'test'
+The files will automatically be reloaded to take that into account.
+
+You may also want to reset all the settings (everything will be forgotten) :
+  SettingsHolder.instance.reset
+  
+== Contributing to settings-tree
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Offirmo. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,54 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "settings-tree"
+  gem.homepage = "http://github.com/Offirmo/settings-tree"
+  gem.license = "CC0 1.0"
+  gem.summary = "Simple, arborescent settings structure from a YAML file."
+  gem.description = <<-EOF
+This gem offers you a convenient settings structure for parameterizing your application.
+Those settings are read from a YAML file.
+Inheritance of settings (like in development modes) and multiple settings groups are available.
+Great for a rails app but can be used for any ruby app.
+EOF
+  gem.email = "offirmo.net@gmail.com"
+  gem.authors = ["Offirmo"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "settings-tree #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/lib/settings_tree.rb

@@ -0,0 +1,21 @@
+require 'settings_tree/settings_holder'
+
+module Settings
+	
+	### Convenient shortcuts to the SettingsHolder class
+	def self.register_settings_file(name, file)
+		SettingsHolder.instance.register_settings_file(name, file)
+	end
+	def self.reload_all
+		return SettingsHolder.instance.reload_all
+	end
+	def self.reload_group(name)
+		return SettingsHolder.instance.reload_group(name)
+	end
+	
+	# automatic access to settings groups
+	def self.method_missing(method, *args, &block)
+		return SettingsHolder.instance.get_settings(method)
+	end
+	
+end

data/lib/settings_tree/settings_holder.rb

@@ -0,0 +1,194 @@
+require 'singleton'
+require 'recursive_open_struct'
+require 'hash_deep_merge'
+require 'yaml'
+
+##
+# Part of the "rails-settings" gem, this class is designed
+# to store several OpenStruct representing 'settings'.
+# It can load them from a YAML file, reload them, and accept queries.
+#
+# This class is usually not used directly but through the 'settings' module, offering shortcuts.
+# ---
+#
+class SettingsHolder
+	
+	# We want this class to be a singleton.
+	# This is on of the cases where singletons are acceptable.
+	include Singleton
+	
+	### Variables
+	@settings_list = nil
+	
+	@environment = nil
+	attr_accessor :environment
+	
+	### Implementation
+	
+	# a convenience function which reset the settings,
+	# forgetting about all the groups, files, etc.
+	def reset
+		initialize
+	end
+	
+	#
+	def register_settings_file(name, file)
+		
+		group_just_created = false
+		
+		# create the group if not already here
+		unless has_group?(name)
+			register_new_group(name) unless has_group?(name)
+			group_just_created = true
+		end
+		
+		# add this file as source
+		res = false
+		begin
+			res = register_new_src_file_for_group(name, file)
+		rescue Exception => e
+			# delete group if just created ? Not for now.
+			# proceed with exception
+			raise e
+		end
+		
+		return res
+	end
+	
+	def get_settings(name)
+		#puts name.inspect
+		#puts @settings_list.inspect
+		if !@settings_list.has_key?(name) then
+			raise ArgumentError, "Settings : unknown settings group '#{name.to_s}'"
+		else
+			return @settings_list[name][:data]
+		end
+	end
+	
+	def environment=(env)
+		@environment = env
+		
+		# need to reload all
+		reload_all
+	end
+	
+	def reload_all
+		@settings_list.each do |key, value|
+			reload_group(key)
+		end
+	end
+	
+	def reload_group(name)
+		
+		res = false
+		
+		if !has_group?(name) then
+			raise ArgumentError, "This group doesn't exist !"
+		else
+			data = Hash.new
+			
+			@settings_list[name.to_sym][:src].each do |src|
+				data.deep_merge!(hash_data_for_src(src))
+			end
+			
+			@settings_list[name.to_sym][:data] = RecursiveOpenStruct.new(data)
+			res = true
+		end # check parameters
+		
+		return res
+	end
+	
+	protected
+		
+		def initialize
+			@settings_list = Hash.new
+			
+			if defined? Rails then
+				@environment = Rails.env
+			end
+		end
+		
+		def has_group?(name)
+			#puts @settings_list.inspect
+			return @settings_list.has_key?(name.to_sym)
+		end
+		
+		def register_new_group(name)
+			
+			if has_group?(name) then
+				raise ArgumentError, "This group already exists !"
+			else
+				@settings_list[name.to_sym] = {:data => nil, :src => Array.new }
+			end # check parameters
+			
+			true
+		end
+		
+		def group_has_src?(name, type, value)
+			
+			if !has_group?(name) then
+				raise ArgumentError, "This group doesn't exist !"
+			else
+				@settings_list[name.to_sym][:src].any? {|src| src[:type] == type && src[:value] == value}
+			end # check parameters
+		end
+		
+		def register_new_src_file_for_group(name, file)
+			
+			res = false
+			
+			if !has_group?(name) then
+				raise ArgumentError, "This group doesn't exist !"
+			elsif group_has_src?(name, :file, file) then
+				# this source is already registered. Ignore.
+				# should signal it ?
+				# res stays false, like in 'require'
+			else
+				@settings_list[name.to_sym][:src] << { :type => :file,  :value => file}
+				# don't forget to update to take the new infos into account
+				begin
+					res = reload_group(name)
+				rescue Exception => e
+					# remove the src, since it's invalid
+					@settings_list[name.to_sym][:src].each_with_index do |item, index|
+						if item[:type] == :file && item[:value] == file then
+							@settings_list[name.to_sym][:src].delete_at(index)
+							break
+						end
+					end
+					# proceed with exception
+					raise e
+				end
+			end # check parameters
+			
+			return res
+		end
+		
+		def hash_data_for_src(src)
+			data = nil
+			
+			case src[:type]
+			when :file
+				begin
+					   complete_config = YAML.load_file( src[:value] ) || {}
+					    default_config = complete_config['defaults'] || {}
+					specialized_config = @environment.nil? ? {} : (complete_config[@environment] || {})
+					
+					data = default_config.deep_merge(specialized_config)
+				rescue Errno::ENOENT => e
+					# no file, classic error.
+					# resend
+					raise e
+				rescue Exception => e
+					#puts e.inspect
+					raise RuntimeError, "XXX There was a problem in parsing the file #{src[:value]}. Please investigate... #{e.message}"
+				end
+			else  
+				raise RuntimeError, "Unknown source type : #{src[:type]}"
+			end
+			
+			return data
+		end
+		
+		
+end

data/settings-tree.gemspec

@@ -0,0 +1,75 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{settings-tree}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = [%q{Offirmo}]
+  s.date = %q{2011-05-25}
+  s.description = %q{This gem offers you a convenient settings structure for parameterizing your application.
+Those settings are read from a YAML file.
+Inheritance of settings (like in development modes) and multiple settings groups are available.
+Great for a rails app but can be used for any ruby app.
+}
+  s.email = %q{offirmo.net@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/settings_tree.rb",
+    "lib/settings_tree/settings_holder.rb",
+    "settings-tree.gemspec",
+    "spec/settings-tree_spec.rb",
+    "spec/settings_holder_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/test_files/another_config.yml",
+    "spec/test_files/config.yml",
+    "spec/test_files/config_complement.yml"
+  ]
+  s.homepage = %q{http://github.com/Offirmo/settings-tree}
+  s.licenses = [%q{CC0 1.0}]
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.3}
+  s.summary = %q{Simple, arborescent settings structure from a YAML file.}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<recursive-open-struct>, [">= 0"])
+      s.add_runtime_dependency(%q<hash-deep-merge>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<recursive-open-struct>, [">= 0"])
+      s.add_dependency(%q<hash-deep-merge>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<recursive-open-struct>, [">= 0"])
+    s.add_dependency(%q<hash-deep-merge>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/spec/settings-tree_spec.rb

@@ -0,0 +1,56 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'settings_tree'
+
+describe "SettingsTree" do
+	
+	before(:all) do
+		#puts "Reseting settings before the suite..."
+		SettingsHolder.instance.reset
+	end
+	
+	it "should be able to load settings from a file" do
+		res = Settings.register_settings_file('web_app', File.join(File.dirname(__FILE__), "test_files/config.yml"))
+		res.should be_true
+	end
+	
+	it "should provide a convenient way to access settings" do
+		Settings.web_app.root_url.should == 'localhost:3000'
+		Settings.web_app.public_access.should be_true
+		
+		Settings.web_app.infos.company_name.should == 'Acme'
+		Settings.web_app.infos.app_name.should == 'Coffe maker'
+		Settings.web_app.infos.copyright_starting_year.should == 2011
+		Settings.web_app.infos.legend.should == 'A superb app which does ...'
+		
+		Settings.web_app.engine.workers_count.should == 3
+		Settings.web_app.engine.auto_manage_workers.should == true
+		Settings.web_app.engine.auto_manage_workers_redirect_output.should == true
+		
+		# now we'll query non-existent fields just to be sure
+		Settings.web_app.infos.foo.should be_nil
+	end
+	
+	it "should be able to load settings from two files at once" do
+		res = Settings.register_settings_file('web_app', File.join(File.dirname(__FILE__), "test_files/config_complement.yml"))
+		res.should be_true
+		
+		# now let's query the new/changed values
+		Settings.web_app.root_url.should == 'talkmap.testhost:3000'
+		Settings.web_app.engine.workers_count.should == 3 # cause no environment
+		Settings.web_app.foo.bar.should == 42
+	end
+	
+	it "should be able to hold several groups of settings" do
+		res = Settings.register_settings_file('web_game', File.join(File.dirname(__FILE__), "test_files/another_config.yml"))
+		res.should be_true
+		
+		# now let's query the new values
+		Settings.web_game.guild_name.should == 'gang'
+		Settings.web_game.party_size.should == 4
+	end
+	
+	it "should provide a way to reload settings" do
+		res = Settings.reload_all
+	end
+	
+end

data/spec/settings_holder_spec.rb

@@ -0,0 +1,122 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'settings_tree/settings_holder'
+
+#
+#  XXX   WARNING   XXX
+# Due to the singleton nature of the class tested
+# It is *NOT* reset between individual tests.
+# Keep it in mind.
+#
+
+describe "SettingsHolder" do
+	
+	before(:all) do
+		#puts "Reseting settings before the suite..."
+		SettingsHolder.instance.reset
+	end
+	
+	describe "basic use" do
+		
+		it "should be instantiable" do
+			s = SettingsHolder.instance
+			s.should_not be_nil
+		end
+		
+		it "should be able to load settings from a file" do
+			res = SettingsHolder.instance.register_settings_file(:web_app, File.join(File.dirname(__FILE__), "test_files/config.yml"))
+			res.should be_true
+		end
+		
+		it "should load all settings" do
+			# and now let's query all the expected settings
+			SettingsHolder.instance.get_settings(:web_app).root_url.should == 'localhost:3000'
+			SettingsHolder.instance.get_settings(:web_app).public_access.should be_true
+			
+			SettingsHolder.instance.get_settings(:web_app).infos.company_name.should == 'Acme'
+			SettingsHolder.instance.get_settings(:web_app).infos.app_name.should == 'Coffe maker'
+			SettingsHolder.instance.get_settings(:web_app).infos.copyright_starting_year.should == 2011
+			SettingsHolder.instance.get_settings(:web_app).infos.legend.should == 'A superb app which does ...'
+			
+			SettingsHolder.instance.get_settings(:web_app).engine.workers_count.should == 3
+			SettingsHolder.instance.get_settings(:web_app).engine.auto_manage_workers.should == true
+			SettingsHolder.instance.get_settings(:web_app).engine.auto_manage_workers_redirect_output.should == true
+			
+			# now we'll query non-existent fields just to be sure
+			SettingsHolder.instance.get_settings(:web_app).infos.foo.should be_nil
+		end
+		
+		it "should load and merge specialized settings" do
+			
+			# Since those tests are not run from a rails app, there is no environment.
+			# We'll set one manually.
+			
+			# before
+			SettingsHolder.instance.environment.should be_nil
+			SettingsHolder.instance.get_settings(:web_app).engine.auto_manage_workers_redirect_output.should == true
+			# change environment (settings are automatically reloaded)
+			SettingsHolder.instance.environment = 'development'
+			# after
+			SettingsHolder.instance.environment.should == 'development'
+			SettingsHolder.instance.get_settings(:web_app).engine.auto_manage_workers_redirect_output.should == false
+			
+			# OK, another one
+			# before
+			SettingsHolder.instance.environment.should == 'development'
+			SettingsHolder.instance.get_settings(:web_app).engine.auto_manage_workers_redirect_output.should == false
+			SettingsHolder.instance.get_settings(:web_app).engine.workers_count.should == 3
+			# change environment (settings are automatically reloaded)
+			SettingsHolder.instance.environment = 'test'
+			# after
+			SettingsHolder.instance.environment.should == 'test'
+			SettingsHolder.instance.get_settings(:web_app).engine.auto_manage_workers_redirect_output.should == true
+			SettingsHolder.instance.get_settings(:web_app).engine.workers_count.should == 0
+		end
+		
+		it "should be able to load settings from two files at once" do
+			res = SettingsHolder.instance.register_settings_file(:web_app, File.join(File.dirname(__FILE__), "test_files/config_complement.yml"))
+			res.should be_true
+			
+			# now let's query the new/changed values
+			SettingsHolder.instance.get_settings(:web_app).root_url.should == 'talkmap.testhost:3000'
+			SettingsHolder.instance.get_settings(:web_app).engine.workers_count.should == 27
+			SettingsHolder.instance.get_settings(:web_app).foo.bar.should == 42
+		end
+		
+	end
+	
+	describe "advanced use" do
+		it "should handle if a file is invalid" do
+			
+			# default case : an exception is thrown
+			expect {
+				SettingsHolder.instance.register_settings_file(:web_app, File.join(File.dirname(__FILE__), "test_files/a_non_existing_file.yml"))
+			}.to raise_error(Errno::ENOENT)
+			
+			# the file shouldn't have been registered, so an update shouldn't throw an exception
+			expect {
+				SettingsHolder.instance.reload_all
+			}.to_not raise_error
+			
+			# now we have a special option to allow a file to not exist (yet)
+			# XXX TODO maybe some day
+		end
+		
+		it "should act correctly if a file is already used" do
+			res = SettingsHolder.instance.register_settings_file(:web_app, File.join(File.dirname(__FILE__), "test_files/config.yml"))
+			res.should be_false # like in require
+		end
+		
+		it "should be a singleton" do
+			expect {
+				SettingsHolder.new
+			}.to raise_error(NoMethodError)
+			
+			SettingsHolder.should respond_to :instance
+			
+			s = SettingsHolder.instance
+			SettingsHolder.instance.should == s
+		end
+		
+	end
+	
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+# we need other gems : load them via bundler :
+require "rubygems"
+require "bundler/setup"
+# now our dependencies are available.
+
+require 'rspec'
+require 'settings_tree'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+
+# I add some display to clearly mark the beginning of the tests
+puts "*\n"*12
+
+RSpec.configure do |config|
+  
+end

data/spec/test_files/another_config.yml

@@ -0,0 +1,11 @@
+# YAML private config file
+# http://kpumuk.info/ruby-on-rails/flexible-application-configuration-in-ruby-on-rails/
+
+# XXX Beware ! This YAML : indention with spaces only ! XXX
+
+
+####### Common / default values #######
+defaults:
+  guild_name: 'gang'
+  party_size: 4
+  

data/spec/test_files/config.yml

@@ -0,0 +1,42 @@
+# YAML private config file
+# http://kpumuk.info/ruby-on-rails/flexible-application-configuration-in-ruby-on-rails/
+
+# XXX Beware ! This YAML : indention with spaces only ! XXX
+
+
+####### Common / default values #######
+defaults:
+  root_url: localhost:3000
+  public_access: true
+  
+  infos:
+    company_name: 'Acme'
+    app_name: 'Coffe maker'
+    copyright_starting_year: 2011
+    legend: 'A superb app which does ...'
+  
+  engine:
+    # How many workers we want :
+    workers_count: 3
+    # Should workers be launched and stopped automatically when launching/stopping the application ?
+    # Workers sometimes need to be launched separately (ex. delayed_job). This remove the hassle.
+    auto_manage_workers: true
+    # Should the thread which will launch the workers output in a file or in the same standard output as the current application ?
+    # Should be usually set to true (in a file) to avoid trace confusion.
+    # Put this to "false" if you want to debug the workers automatic launch or see what happen.
+    auto_manage_workers_redirect_output: true
+  
+
+####### production environment #######
+production:
+# nothing special
+
+####### development environment #######
+development:
+  engine:
+    auto_manage_workers_redirect_output: false
+
+####### test environment #######
+test:
+  engine:
+    workers_count: 0

data/spec/test_files/config_complement.yml

@@ -0,0 +1,17 @@
+# YAML private config file - complement for local adaptations
+
+# XXX Beware ! This YAML : indention with spaces only ! XXX
+
+
+####### Common / default values #######
+defaults:
+  root_url: talkmap.testhost:3000
+  
+  # a new key
+  foo:
+    bar: 42
+  
+####### test environment #######
+test:
+  engine:
+    workers_count: 27

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: settings-tree
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease: 
+platform: ruby
+authors:
+- Offirmo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-05-25 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: recursive-open-struct
+  requirement: &79882210 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *79882210
+- !ruby/object:Gem::Dependency
+  name: hash-deep-merge
+  requirement: &79881970 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *79881970
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &79881730 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *79881730
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &79881490 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *79881490
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &79881250 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *79881250
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &79881010 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *79881010
+description: ! 'This gem offers you a convenient settings structure for parameterizing
+  your application.
+
+  Those settings are read from a YAML file.
+
+  Inheritance of settings (like in development modes) and multiple settings groups
+  are available.
+
+  Great for a rails app but can be used for any ruby app.
+
+'
+email: offirmo.net@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/settings_tree.rb
+- lib/settings_tree/settings_holder.rb
+- settings-tree.gemspec
+- spec/settings-tree_spec.rb
+- spec/settings_holder_spec.rb
+- spec/spec_helper.rb
+- spec/test_files/another_config.yml
+- spec/test_files/config.yml
+- spec/test_files/config_complement.yml
+homepage: http://github.com/Offirmo/settings-tree
+licenses:
+- CC0 1.0
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 228111425
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.3
+signing_key: 
+specification_version: 3
+summary: Simple, arborescent settings structure from a YAML file.
+test_files: []