cjbottaro-app_config 1.0.0

data/README.rdoc

@@ -0,0 +1,59 @@
+== Summary
+Application level configuration.
+
+== Features
+
+ * simple YAML config files
+ * config files support ERB
+ * config files support inheritance
+ * access config information via convenient object member notation
+
+=== Basic Usage
+
+You simply write a configuration file in YAML.  Notice you can use ERB.
+
+<em>config.yml</em>
+  aws:
+    access_key: 123ABC
+    secret_key: ABC123
+  now: <%= Time.now %>
+  servers: [ {name: example1.com}, {name: example2.com} ]
+
+Then somewhere in your code, you create a global constant from the config file.  Then access the config data via object member notation.
+
+_code_
+  ::AppConfig = ApplicationConfiguration.new("config.yml")
+  AppConfig.aws.access_key  # => "123ABC"
+  AppConfig.aws.secret_key  # => "ABC123"
+  AppConfig.now             # => Tue May 05 21:55:15 -0500 2009
+  AppConfig.servers[0].name # => "example1.com"
+
+=== Inheritance
+
+You can have a second config file that is recursively merged with the first config file.
+
+<em>base.yml</em>
+  app_name:  MyCoolApp
+  domain:  dev.mycoolapp.com
+
+<em>production.yml</em>
+  domain:  www.mycoolapp.com
+
+_code_
+  ::AppConfig = ApplicationConfiguration.new("base.yml", "production.yml")
+  AppConfig.app_name # => "MyCoolApp"
+  AppConfig.domain   # => "www.mycoolapp.com"
+
+=== Using in a Rails app
+
+You just need to create an initializer that looks something like this.
+
+ require 'app_config'
+ ::AppConfig = ApplicationConfiguration.new(RAILS_ROOT+"/config/app_config.yml",
+                                            RAILS_ROOT+"/config/environments/#{RAILS_ENV}.yml")
+
+If you installed this as a Rails plugin instead of a gem, that code is already run for you in
+the plugin's init.rb.
+
+== Author
+Christopher J. Bottaro

data/Rakefile

@@ -0,0 +1,38 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "app_config"
+    gem.summary = %Q{Application level configuration.}
+    gem.description = %Q{Application level configuration that supports YAML config file, inheritance, ERB, and object member notation.}
+    gem.email = "cjbottaro@alumni.cs.utexas.edu"
+    gem.homepage = "http://github.com/cjbottaro/app_config"
+    gem.authors = ["Christopher J Bottaro"]
+
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the app_config plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the app_config plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'AppConfig'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 1
+:minor: 0
+:patch: 0

data/lib/app_config.rb

@@ -0,0 +1,66 @@
+require 'closed_struct'
+require 'yaml'
+require 'erb'
+
+class ApplicationConfiguration
+  
+  # Create a new ApplicationConfiguration object.  <tt>conf_path_1</tt> is the path to your YAML configuration file.
+  # If <tt>conf_path_2</tt> is given, the contents are recursively merged with the contents of <tt>conf_path_1</tt>.
+  # This allows you to have a "base" configuration with settings that are overrided by "environment specific"
+  # (developement, test, production, etc) settings.
+  #
+  # Ex:
+  #  ApplicationConfiguration.new(RAILS_ROOT+"/config/base.yml", RAILS_ROOT+"/environments/#{RAILS_ENV}_config.yml")
+  def initialize(conf_path_1, conf_path_2 = nil)
+    @conf_path_1, @conf_path_2 = conf_path_1, conf_path_2
+    reload!
+  end
+  
+  # Rereads your configuration files and rebuilds your ApplicationConfiguration object.  This is useful
+  # for when you edit your config files, but don't want to restart your web server.
+  def reload!
+    conf1 = load_conf_file(@conf_path_1)
+    conf2 = load_conf_file(@conf_path_2)
+    conf  = recursive_merge(conf1, conf2)
+    @config = convert(conf)
+  end
+  
+private
+  
+  def method_missing(name, *args)
+    if @config.respond_to?(name)
+      @config.send(name, *args)
+    else
+      super
+    end
+  end
+  
+  def load_conf_file(conf_path)
+    return {} if !conf_path or conf_path.empty?
+    File.open(conf_path, "r") do |file|
+      YAML.load(ERB.new(file.read).result) || {}
+    end
+  end
+  
+  # Recursively converts Hashes to ClosedStructs (including Hashes inside Arrays)
+  def convert(h) #:nodoc:
+    s = ClosedStruct.new(h.keys)
+    h.each do |k, v|
+      if v.instance_of?(Hash)
+        s.send( (k+'=').to_sym, convert(v))
+      elsif v.instance_of?(Array)
+        converted_array = v.collect { |e| e.instance_of?(Hash) ? convert(e) : e }
+        s.send( (k+'=').to_sym, converted_array)
+      else
+        s.send( (k+'=').to_sym, v)
+      end
+    end
+    s
+  end
+  
+  # Recursively merges hashes.  h2 will overwrite h1.
+  def recursive_merge(h1, h2) #:nodoc:
+    h1.merge(h2){ |k, v1, v2| v2.kind_of?(Hash) ? recursive_merge(v1, v2) : v2 }
+  end
+  
+end

data/lib/closed_struct.rb

@@ -0,0 +1,39 @@
+require 'ostruct'
+
+class ClosedStruct < OpenStruct # :nodoc:
+  
+  def initialize(*args)
+    if args.length == 1
+      super(args.first)
+    else
+      h = args.inject({}){ |memo, k| memo[k] = nil; memo }
+      super(h)
+    end
+    @closed = true
+  end
+  
+  def new_ostruct_member(name)
+    if @closed
+      raise RuntimeError, "cannot add members to closed struct"
+    else
+      super
+    end
+  end
+  
+  def method_missing(name, *args)
+    raise NoMethodError, "undefined method '#{name}' for #{self}"
+  end
+  
+  def id
+    if @table.has_key?(:id)
+      @table[:id]
+    else
+      method_missing(:id)
+    end
+  end
+  
+  def to_h
+    @table.dup
+  end
+  
+end

data/test/app_config.yml

@@ -0,0 +1,5 @@
+size: 1
+server: google.com
+emails:
+  support: support@domain.com
+  webmaster: web@domain.com

data/test/app_config_test.rb

@@ -0,0 +1,64 @@
+require 'test/unit'
+require 'app_config'
+
+class AppConfigTest < Test::Unit::TestCase
+  
+  def test_missing_files
+    assert_raise(Errno::ENOENT){ ApplicationConfiguration.new('not_here1', 'not_here2') }
+  end
+  
+  def test_empty_files
+    config = ApplicationConfiguration.new('test/empty1.yml', 'test/empty2.yml')
+    assert_equal OpenStruct.new, config.instance_variable_get("@config")
+  end
+  
+  def test_common
+    config = ApplicationConfiguration.new('test/app_config.yml')
+    assert_equal 1, config.size
+    assert_equal 'google.com', config.server
+  end
+  
+  def test_override
+    config = ApplicationConfiguration.new('test/app_config.yml', 'test/development.yml')
+    assert_equal 2, config.size
+    assert_equal 'google.com', config.server
+  end
+  
+  def test_nested
+    config = ApplicationConfiguration.new('test/development.yml')
+    assert_equal 3, config.section.size
+  end
+  
+  def test_array
+    config = ApplicationConfiguration.new('test/development.yml')
+    assert_equal 'yahoo.com', config.section.servers[0].name
+    assert_equal 'amazon.com', config.section.servers[1].name
+  end
+  
+  def test_erb
+    config = ApplicationConfiguration.new('test/development.yml')
+    assert_equal 6, config.computed
+  end
+  
+  def test_recursive_merge
+    config = ApplicationConfiguration.new('test/app_config.yml', 'test/development.yml')
+    assert_equal 'support@domain.com', config.emails.support
+    assert_equal 'webmaster@domain.com', config.emails.webmaster
+    assert_equal 'feedback@domain.com', config.emails.feedback
+  end
+  
+  def test_exception_on_non_existant_values
+    config = ApplicationConfiguration.new('test/app_config.yml')
+    assert_raise(NoMethodError){ config.not_here1 = "blah" }
+    assert_raise(NoMethodError){ config.not_here2 }
+  end
+  
+  def test_reload
+    config = ApplicationConfiguration.new('test/app_config.yml')
+    config.size = 2
+    assert_equal 2, config.size
+    config.reload!
+    assert_equal 1, config.size
+  end
+  
+end

data/test/development.yml

@@ -0,0 +1,8 @@
+size: 2
+computed: <%= 1 + 2 + 3 %>
+section:
+  size: 3
+  servers: [ {name: yahoo.com}, {name: amazon.com} ]
+emails:
+  webmaster: webmaster@domain.com
+  feedback: feedback@domain.com

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: cjbottaro-app_config
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Christopher J Bottaro
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-01 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Application level configuration that supports YAML config file, inheritance, ERB, and object member notation.
+email: cjbottaro@alumni.cs.utexas.edu
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- lib/app_config.rb
+- lib/closed_struct.rb
+- test/app_config.yml
+- test/app_config_test.rb
+- test/development.yml
+- test/empty1.yml
+- test/empty2.yml
+has_rdoc: true
+homepage: http://github.com/cjbottaro/app_config
+licenses: 
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Application level configuration.
+test_files: 
+- test/app_config_test.rb