ambience 0.3.1 → 1.0.0

data/.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+.yardoc
+doc
+coverage
+tmp
+*~
+*.gem
+.bundle
+Gemfile.lock

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,8 @@
+script: "rake"
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ree
+  - rbx
+  - jruby
+

data/{CHANGELOG → CHANGELOG.md}

@@ -1,38 +1,50 @@
+== 1.0.0 (2011-06-15)
+
+  * Cleaned up the project's setup.
+  * Moved the config into a module. Instead of calling `Ambience.new`, you can now use
+    `Ambience.create` to create the config.
+  * Added a Railtie which gets loaded when `Rails` is defined. The Railtie creates an
+    `AppConfig` mash from `config/ambience.yml` if such a file exists.
+  * Added travis integration: http://travis-ci.org/#!/rubiii/ambience
+
 == 0.3.1 (2010-05-27)
+
   * Ambience now requires "java" (for JRuby support) if it's available.
 
 == 0.3.0 (2010-05-13)
+
   * Ambience now operates on the instance level. So after setting up a new Ambience config
     like before:
-    
-      AppConfig = Ambience.new File.join(Rails.root, "config", "ambience.yml")
-    
+
+        AppConfig = Ambience.new File.join(Rails.root, "config", "ambience.yml")
+
     you now have to choose whether you like to have the config returned as a simple Hash
     or a Hashie::Mash (which was the default since version 0.2.0):
-    
-      AppConfig.to_hash
-      AppConfig.to_mash
-    
+
+        AppConfig.to_hash
+        AppConfig.to_mash
+
   * Along with support for a basic config and JVM properties, version 0.3.0 adds support
     for local (user-specific) settings. By default, Ambience tries to load a local YAML
     config from:
-    
-      File.join ENV["HOME"].to_s, ".ambience", "ambience.yml"
-    
+
+        File.join ENV["HOME"].to_s, ".ambience", "ambience.yml"
+
     Ambience will still work fine if the file does not exist. But if you want to use a
     local config and change the default location, you can use the +local_config+ class
     method to do so.
-    
-      Ambience.local_config # => "/Users/you/.ambience/ambience.yml"
-      
-      # Change the location of the local config file:
-      Ambience.local_config = File.join "config", "user_config.yml"
+
+        Ambience.local_config # => "/Users/you/.ambience/ambience.yml"
+
+        # Change the location of the local config file:
+        Ambience.local_config = File.join "config", "user_config.yml"
 
 == 0.2.0 (2010-03-06)
+
   * Complete rewrite. Removed Rails-specific defaults and returning the Ambience config
     as a Hashie::Mash (http://github.com/intridea/hashie). Take a look at the new Readme
     and Specs for examples.
 
 == 0.1.0 (2009-12-12)
-  * Initial release.
 
+  * Initial release.

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2010 Daniel Harrington
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.md

@@ -0,0 +1,74 @@
+Ambience [![Build Status](http://travis-ci.org/rubiii/ambience.png)](http://travis-ci.org/rubiii/ambience)
+========
+
+App configuration feat. YAML and JVM properties. Lets you specify a default configuration in a YAML file
+and overwrite details via local settings and JVM properties for production.
+
+
+Installation
+------------
+
+Ambience is available through [Rubygems](http://rubygems.org/gems/ambience) and can be installed via:
+
+```
+$ gem install ambience
+```
+
+
+Getting started
+---------------
+
+Given you created a YAML config like this:
+
+``` yml
+auth:
+  address: http://example.com
+  username: ferris
+  password: test
+```
+
+You can instantiate an Ambience config by passing in the path to your config file:
+
+``` ruby
+AppConfig = Ambience.create Rails.root.join("config", "ambience.yml")
+```
+
+Ambience will load and convert your config into a Hash:
+
+``` ruby
+{ "auth" => { "address" => "http://example.com", "username" => "ferris", "password" => "test" } }
+```
+
+Afterwards it tries to merge these settings with local ones specified in an Ambience.local_config file.
+Finally it looks for any JVM properties (if your running JRuby) and merge these properties with your config:
+
+``` ruby
+auth.address = "http://live.example.com"
+auth.password = "topsecret"
+```
+
+The result would be something like this:
+
+``` ruby
+{ "auth" => { "address" => "http://live.example.com", "username" => "ferris", "password" => "topsecret" } }
+```
+
+In the end you can decide whether you want to return the config as a Hash:
+
+``` ruby
+AppConfig = Ambience.create(Rails.root.join("config", "ambience.yml")).to_hash
+```
+
+or a [Hashie::Mash](http://github.com/intridea/hashie):
+
+``` ruby
+AppConfig = Ambience.create(Rails.root.join("config", "ambience.yml")).to_mash
+```
+
+
+Railtie
+-------
+
+Ambience comes with a Railtie which looks for `config/ambience.yml` inside your Rails project.
+If the file exists, Ambience loads the config and stores it in an `AppConfig` constant.
+All this happens before Rails evaluates your environment config.

data/Rakefile

@@ -1,31 +1,11 @@
-require "rake"
-require "spec/rake/spectask"
-require "spec/rake/verify_rcov"
+require "bundler"
+Bundler::GemHelper.install_tasks
 
-task :default => :spec
-
-Spec::Rake::SpecTask.new do |spec|
-  spec.spec_files = FileList["spec/**/*_spec.rb"]
-  spec.spec_opts << "--color"
-  spec.libs += ["lib", "spec"]
-  spec.rcov = true
-end
+require "rspec/core/rake_task"
 
-RCov::VerifyTask.new(:spec_verify => :spec) do |verify|
-  verify.threshold = 100.0
-  verify.index_html = "rcov/index.html"
+RSpec::Core::RakeTask.new do |t|
+  t.rspec_opts = %w(-c)
 end
 
-begin
-  require "hanna/rdoctask"
-
-  Rake::RDocTask.new do |rdoc|
-    rdoc.title = "Ambience - App configuration feat. YAML and JVM properties"
-    rdoc.rdoc_dir = "doc"
-    rdoc.rdoc_files.include("**/*.rdoc").include("lib/**/*.rb")
-    rdoc.options << "--line-numbers"
-    rdoc.options << "--webcvs=http://github.com/rubiii/ambience/tree/master/"
-  end
-rescue LoadError
-  puts "'gem install hanna' for documentation"
-end
+task :default => :spec
+task :test => :spec

data/ambience.gemspec

@@ -0,0 +1,25 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "ambience/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ambience"
+  s.version     = Ambience::VERSION
+  s.author      = "Daniel Harrington"
+  s.email       = "me@rubiii.com"
+  s.homepage    = "http://github.com/rubiii/#{s.name}"
+  s.summary     = %q{App configuration feat. YAML and JVM properties}
+  s.description = s.summary
+
+  s.rubyforge_project = s.name
+
+  s.add_dependency "hashie", ">= 0.2.0"
+
+  s.add_development_dependency "rspec", "~> 2.6.0"
+  s.add_development_dependency "mocha", "~> 0.9.12"
+  s.add_development_dependency "autotest"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/ambience.rb

@@ -1,7 +1,16 @@
-require "yaml" unless defined? YAML
-require "erb" unless defined? ERB
+require "ambience/config"
+require "ambience/version"
 
-require "hashie"
+require "ambience/railtie" if defined? Rails
 
-require "ambience/core_ext"
-require "ambience/ambience"
+module Ambience
+
+  def self.create(config_file, env = nil)
+    Config.new(config_file, env)
+  end
+
+  def self.jruby?
+    RUBY_PLATFORM =~ /java/
+  end
+
+end

data/lib/ambience/config.rb

@@ -0,0 +1,86 @@
+require "yaml" unless defined? YAML
+require "erb" unless defined? ERB
+
+require "hashie"
+require "ambience/core_ext"
+
+begin
+  require "java"
+rescue LoadError
+end
+
+module Ambience
+
+  # = Ambience::Config
+  #
+  # App configuration feat. YAML and JVM properties. Lets you specify a default configuration
+  # in a YAML file and overwrite details via local settings and JVM properties for production.
+  class Config
+
+    # Sets the path to a local ambience config file.
+    def self.local_config=(local_config)
+      @@local_config = local_config
+    end
+
+    # Returns the path to a local ambience config file for specifying user-specific
+    # settings that don't belong into the application config file.
+    def self.local_config
+      @@local_config ||= File.join ENV["HOME"].to_s, ".ambience", "ambience.yml"
+    end
+
+    def initialize(config_file, env = nil)
+      @config_file, @env = config_file, env
+    end
+
+    # Returns the Ambience config as a Hash.
+    def to_hash
+      config = load_config @config_file
+      config = config.deep_merge local_config
+      config.deep_merge jvm_config
+    end
+
+    # Returns the Ambience config as a Hashie::Mash.
+    def to_mash
+      Hashie::Mash.new to_hash
+    end
+
+  private
+
+    def load_config(config_file)
+      raise ArgumentError, "Missing config: #{config_file}" unless File.exist? config_file
+
+      config = File.read config_file
+      config = YAML.load ERB.new(config).result || {}
+      config = config[@env.to_s] || config[@env.to_sym] if @env
+      config
+    end
+
+    # Returns a Hash containing any local settings from the +@@local_config+.
+    def local_config
+      File.exist?(self.class.local_config) ? load_config(self.class.local_config) : {}
+    end
+
+    ## Returns a Hash containing any JVM properties.
+    def jvm_config
+      jvm_properties.inject({}) do |hash, (key, value)|
+        hash.deep_merge hash_from_property(key, value)
+      end
+    end
+
+    # Returns the JVM properties.
+    def jvm_properties
+      Ambience.jruby? ? java.lang.System.get_properties : {}
+    end
+
+    # Returns a Hash generated from a JVM +property+ and its +value+.
+    #
+    # ==== Example:
+    #
+    #   hash_from_property "webservice.auth.address", "http://auth.example.com"
+    #   # => { "webservice" => { "auth" => { "address" => "http://auth.example.com" } } }
+    def hash_from_property(property, value)
+      property.split(".").reverse.inject(value) { |value, item| { item => value } }
+    end
+
+  end
+end

data/lib/ambience/core_ext.rb

@@ -1,19 +1,25 @@
-class Hash
+module Ambience
+  module CoreExt
+    module Hash
 
-  # Returns a new Hash with self and +other_hash+ merged recursively.
-  # Implementation from ActiveSupport::CoreExtensions::Hash::DeepMerge.
-  def deep_merge(other_hash)
-    merge(other_hash) do |key, oldval, newval|
-      oldval = oldval.to_hash if oldval.respond_to? :to_hash
-      newval = newval.to_hash if newval.respond_to? :to_hash
-      oldval.class.to_s == "Hash" && newval.class.to_s == "Hash" ? oldval.deep_merge(newval) : newval
-    end
-  end
+      # Returns a new Hash with self and +other_hash+ merged recursively.
+      # Implementation from ActiveSupport::CoreExtensions::Hash::DeepMerge.
+      def deep_merge(other_hash)
+        merge(other_hash) do |key, oldval, newval|
+          oldval = oldval.to_hash if oldval.respond_to? :to_hash
+          newval = newval.to_hash if newval.respond_to? :to_hash
+          oldval.class.to_s == "Hash" && newval.class.to_s == "Hash" ? oldval.deep_merge(newval) : newval
+        end
+      end
 
-  # Returns a new Hash with self and +other_hash+ merged recursively. Modifies the receiver in place.
-  # Implementation from ActiveSupport::CoreExtensions::Hash::DeepMerge.
-  def deep_merge!(other_hash)
-    replace deep_merge(other_hash)
-  end
+      # Returns a new Hash with self and +other_hash+ merged recursively. Modifies the receiver in place.
+      # Implementation from ActiveSupport::CoreExtensions::Hash::DeepMerge.
+      def deep_merge!(other_hash)
+        replace deep_merge(other_hash)
+      end
 
+    end
+  end
 end
+
+Hash.send :include, Ambience::CoreExt::Hash

data/lib/ambience/railtie.rb

@@ -0,0 +1,13 @@
+module Ambience
+  class Railtie < Rails::Railtie
+
+    initializer 'ambience.railtie', :before => :load_environment_config do |app|
+      default_config_file = Rails.root.join("config", "ambience.yml")
+
+      if File.exist?(default_config_file)
+        ::AppConfig = Ambience.create(default_config_file, Rails.env).to_mash
+      end
+    end
+
+  end
+end

data/lib/ambience/version.rb

@@ -0,0 +1,5 @@
+module Ambience
+
+  VERSION = "1.0.0"
+
+end

data/spec/ambience/ambience_spec.rb

@@ -1,57 +1,70 @@
 require "spec_helper"
 
 describe Ambience do
-  include SpecHelper
 
-  it "should return the content of a given config file as a Hash" do
-    config = Ambience.new(config_file(:basic)).to_hash
-    
+  it "returns the content of a given config file as a Hash" do
+    config = Ambience.create(config_file(:basic)).to_hash
+
     config.should be_a(Hash)
     config["auth"]["username"].should == "ferris"
     config["auth"]["password"].should == "test"
   end
 
-  it "should return the content of a given config file as a Hashie::Mash" do
-    config = Ambience.new(config_file(:basic)).to_mash
-    
+  it "returns the content of a given config file as a Hashie::Mash" do
+    config = Ambience.create(config_file(:basic)).to_mash
+
     config.should be_a(Hashie::Mash)
     config.auth.username.should == "ferris"
     config[:auth][:address].should == "http://example.com"
     config["auth"]["password"].should == "test"
   end
 
-  it "should return the config for an optional environment as a Hashie::Mash" do
-    config = Ambience.new(config_file(:environments), :production).to_mash
-    
+  it "returns the config for an optional environment as a Hashie::Mash" do
+    config = Ambience.create(config_file(:environments), :production).to_mash
+
     config.should be_a(Hashie::Mash)
     config.auth.username.should == "ferris"
     config[:auth]["password"].should == "topsecret"
   end
 
-  it "should return the config specified as Symbols as a Hashie::Mash" do
-    config = Ambience.new(config_file(:symbols), "production").to_mash
-    
+  it "returns the config specified as Symbols as a Hashie::Mash" do
+    config = Ambience.create(config_file(:symbols), "production").to_mash
+
     config.should be_a(Hashie::Mash)
     config.auth.username.should == "ferris"
     config[:auth]["password"].should == "test"
   end
 
-  it "should merge the config with any JVM properties when using JRuby" do
-    Ambience.stubs(:jruby?).returns(true)
-    Ambience.any_instance.stubs(:jvm_properties).returns(
-      "auth.address" => "http://live.example.com",
-      "auth.password" => "topsecret"
-    )
-    config = Ambience.new(config_file(:basic)).to_mash
+  it "raises an ArgumentError when the given config file could not be found" do
+    lambda { Ambience.create("missing_config.yml").to_hash }.should raise_error(ArgumentError)
+  end
+
+  context "when using JRuby" do
+    before do
+      Ambience::Config.send(:define_method, :java) { JavaMock }
+    end
 
-    config.should be_a(Hashie::Mash)
-    config.auth.username.should == "ferris"
-    config[:auth][:address].should == "http://live.example.com"
-    config["auth"]["password"].should == "topsecret"
+    after do
+      Ambience::Config.send(:remove_method, :java)
+    end
+
+    it "merges the config with any JVM properties" do
+      Ambience.stubs(:jruby?).returns(true)
+      Ambience::Config.any_instance.stubs(:jvm_properties).returns(
+        "auth.address" => "http://live.example.com",
+        "auth.password" => "topsecret"
+      )
+      config = Ambience.create(config_file(:basic)).to_mash
+
+      config.should be_a(Hashie::Mash)
+      config.auth.username.should == "ferris"
+      config[:auth][:address].should == "http://live.example.com"
+      config["auth"]["password"].should == "topsecret"
+    end
   end
 
-  it "should raise an ArgumentError in case the given config file could not be found" do
-    lambda { Ambience.new("missing_config.yml").to_hash }.should raise_error(ArgumentError)
+  def config_file(name)
+    File.expand_path("../../fixtures/#{name}.yml", __FILE__)
   end
 
 end

data/spec/spec_helper.rb

@@ -1,16 +1,4 @@
-require "spec"
-require "mocha"
+require "bundler"
+Bundler.require :default, :development
 
-Spec::Runner.configure do |config|
-  config.mock_with :mocha
-end
-
-require "ambience"
-
-module SpecHelper
-
-  def config_file(name)
-    File.join File.dirname(__FILE__), "fixtures", "#{name}.yml"
-  end
-
-end
+require "support/java_mock"

data/spec/support/java_mock.rb

@@ -0,0 +1,15 @@
+class JavaMock
+
+  def self.lang
+    self
+  end
+
+  def self.System
+    self
+  end
+
+  def self.get_properties
+    { "auth.address" => "http://live.example.com", "auth.password" => "topsecret" }
+  end
+
+end

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ambience
 version: !ruby/object:Gem::Version 
-  prerelease: false
+  hash: 23
+  prerelease: 
   segments: 
-  - 0
-  - 3
   - 1
-  version: 0.3.1
+  - 0
+  - 0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Daniel Harrington
@@ -14,16 +15,18 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-27 00:00:00 +02:00
+date: 2011-06-15 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: 23
         segments: 
         - 0
         - 2
@@ -35,84 +38,115 @@ dependencies:
   name: rspec
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
+        hash: 23
         segments: 
-        - 1
         - 2
-        - 8
-        version: 1.2.8
+        - 6
+        - 0
+        version: 2.6.0
   type: :development
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
   name: mocha
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
+        hash: 35
         segments: 
         - 0
         - 9
-        - 7
-        version: 0.9.7
+        - 12
+        version: 0.9.12
   type: :development
   version_requirements: *id003
-description: 
+- !ruby/object:Gem::Dependency 
+  name: autotest
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: App configuration feat. YAML and JVM properties
 email: me@rubiii.com
 executables: []
 
 extensions: []
 
-extra_rdoc_files: 
-- README.rdoc
+extra_rdoc_files: []
+
 files: 
-- CHANGELOG
+- .gitignore
+- .rspec
+- .travis.yml
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
 - Rakefile
-- README.rdoc
-- lib/ambience/ambience.rb
-- lib/ambience/core_ext.rb
+- ambience.gemspec
 - lib/ambience.rb
+- lib/ambience/config.rb
+- lib/ambience/core_ext.rb
+- lib/ambience/railtie.rb
+- lib/ambience/version.rb
 - spec/ambience/ambience_spec.rb
-- spec/spec_helper.rb
 - spec/fixtures/basic.yml
 - spec/fixtures/environments.yml
 - spec/fixtures/symbols.yml
+- spec/spec_helper.rb
+- spec/support/java_mock.rb
 has_rdoc: true
 homepage: http://github.com/rubiii/ambience
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
-- --line-numbers
-- --inline-source
-- --title
-- Ambience - App configuration feat. YAML and JVM properties
+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.6
+rubyforge_project: ambience
+rubygems_version: 1.4.1
 signing_key: 
 specification_version: 3
 summary: App configuration feat. YAML and JVM properties
 test_files: 
 - spec/ambience/ambience_spec.rb
+- spec/fixtures/basic.yml
+- spec/fixtures/environments.yml
+- spec/fixtures/symbols.yml
 - spec/spec_helper.rb
+- spec/support/java_mock.rb

data/README.rdoc

@@ -1,41 +0,0 @@
-= Ambience
-
-App configuration feat. YAML and JVM properties. Lets you specify a default configuration in a YAML file and overwrite details via local settings and JVM properties for production.
-
-== Installation
-
-  $ gem install ambience
-
-== How it works
-
-Given you created a YAML config like this:
-
-  auth:
-    address: http://example.com
-    username: ferris
-    password: test
-
-You can instantiate an Ambience config by passing in the path to your config file:
-
-  AppConfig = Ambience.new File.join(Rails.root, "config", "ambience.yml")
-
-Ambience will load and convert your config into a Hash:
-
-  { "auth" => { "address" => "http://example.com", "username" => "ferris", "password" => "test" } }
-
-Afterwards it tries to merge these settings with local ones specified in an Ambience.local_config file. Finally it looks for any JVM properties (if your running JRuby) and merge these properties with your config:
-
-  auth.address = "http://live.example.com"
-  auth.password = "topsecret"
-
-The result would be something like this:
-
-  { "auth" => { "address" => "http://live.example.com", "username" => "ferris", "password" => "topsecret" } }
-
-In the end you can decide whether you want to return the config as a Hash:
-
-  AppConfig = Ambience.new(File.join(Rails.root, "config", "ambience.yml")).to_hash
-
-or a {Hashie::Mash}[http://github.com/intridea/hashie]:
-
-  AppConfig = Ambience.new(File.join(Rails.root, "config", "ambience.yml")).to_mash

data/lib/ambience/ambience.rb

@@ -1,93 +0,0 @@
-begin
-  require "java"
-rescue LoadError
-end
-
-# = Ambience
-#
-# App configuration feat. YAML and JVM properties. Lets you specify a default configuration
-# in a YAML file and overwrite details via local settings and JVM properties for production.
-class Ambience
-
-  # Sets the path to a local ambience config file.
-  def self.local_config=(local_config)
-    @@local_config = local_config
-  end
-
-  # Returns the path to a local ambience config file for specifying user-specific
-  # settings that don't belong into the application config file.
-  def self.local_config
-    @@local_config ||= File.join ENV["HOME"].to_s, ".ambience", "ambience.yml"
-  end  
-
-  # Returns whether the current Ruby platfrom is JRuby.
-  def self.jruby?
-   RUBY_PLATFORM =~ /java/
-  end
-
-  def initialize(config_file, env = nil)
-    @config_file, @env = config_file, env
-  end
-
-  # Returns the Ambience config as a Hash.
-  def to_hash
-    config = load_config @config_file
-    config = config.deep_merge local_config
-    config.deep_merge jvm_config
-  end
-
-  # Returns the Ambience config as a Hashie::Mash.
-  def to_mash
-    Hashie::Mash.new to_hash
-  end
-
-private
-
-  def load_config(config_file)
-    raise ArgumentError, "Missing config: #{config_file}" unless File.exist? config_file
-    
-    config = File.read config_file
-    config = YAML.load ERB.new(config).result || {}
-    config = config[@env.to_s] || config[@env.to_sym] if @env
-    config
-  end
-
-  # Returns a Hash containing any local settings from the +@@local_config+.
-  def local_config
-    File.exist?(self.class.local_config) ? load_config(self.class.local_config) : {}
-  end
-
-  ## Returns a Hash containing any JVM properties.
-  def jvm_config
-    jvm_properties.inject({}) do |hash, (key, value)|
-      hash.deep_merge hash_from_property(key, value)
-    end
-  end
-
-  # Returns the JVM properties.
-  def jvm_properties
-    JavaLang::System.get_properties rescue {}
-  end
-
-  # Returns a Hash generated from a JVM +property+ and its +value+.
-  #
-  # ==== Example:
-  #
-  #   hash_from_property "webservice.auth.address", "http://auth.example.com"
-  #   # => { "webservice" => { "auth" => { "address" => "http://auth.example.com" } } }
-  def hash_from_property(property, value)
-    property.split(".").reverse.inject(value) { |value, item| { item => value } }
-  end
-
-  # Returns the JVM properties.
-  def jvm_properties
-    self.class.jruby? ? JavaLang::System.get_properties : {}
-  end
-
-  if jruby?
-    module JavaLang
-      include_package "java.lang"
-    end
-  end
-
-end