configurethis 1.0.3 → 1.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: de51c7bf8ff307aa213f4f6431be1fdd79beb4c4
+  data.tar.gz: c12f30afd2ac5c311cb13d9974f1d1a3b2c28868
+SHA512:
+  metadata.gz: ea2e4efb4bc08bccd90d4e529a3118731273df9599bea18f4a772b4412499f1dd15b0af26d794de8865f4385982c1b1d14ebc6f88217ce31a07c1ea3fdeb10cf
+  data.tar.gz: ae2b9a342b327bfd077e013ef825c36eba9d20f597123ac8155a5885c3d29ac812cf97f350efcb2d25952ddfc5e90b4b5f224b77ef1224b1c866427cbbe0a48c

data/README.md

@@ -1,4 +1,5 @@
 [![Build Status](https://travis-ci.org/mattsnyder/configurethis.png?branch=master)](https://travis-ci.org/mattsnyder/configurethis)
+[![Code Climate](https://codeclimate.com/repos/5201505856b1022e8f000a78/badges/b728182dffefc2f344ab/gpa.png)](https://codeclimate.com/repos/5201505856b1022e8f000a78/feed)
 # Configurethis
 Clean up your configuration approach by using Configurethis. Configurethis allows you to access your config values using
 method names instead of string literals to identify which config value you want to retrieve. 
@@ -71,7 +72,7 @@ Configurethis.root_path = File.join(Rails.root, "config")
 
 If your configuration is dependent on environment variables, you can specify it (Unfortunately at this time you need to do this once per each class that is environmentally dependent):
 ```ruby
-MyConfigurationClass.set_root = RAILS_ENV
+MyConfigurationClass.set_root = Rails.env
 ```
 
 ### Creating a configuration
@@ -107,6 +108,26 @@ class IWantToBeDifferent
 end
 ```
 
+### Testing
+While working with Configurethis in your specs/tests you can override the configuration
+and avoid using the real configuration files to simulate behavior. This enables you to 
+avoid using messing stubbing hierarchies and keep your tests clean!
+
+Just pass a hash representing your configuration to `#test_with`.
+
+```ruby
+# my_configuration.rb
+class BourbonConfig
+  extend Configurethis
+end
+
+# my_behavior_spec.rb
+it "should do some drinking" do
+  BourbonConfiguration.test_with({"bourbons" => {"Woodford" => "awesome", "Buffalo Trace" => "ok"} })
+  expect( my_behavior.drink("Woodford") ).to eql("awesome") # => true
+end
+```
+
 ## Contributing
 
 1. Fork it

data/lib/configurethis.rb

@@ -1,5 +1,6 @@
 require "configurethis/version"
 require "configurethis/value_container"
+require "configurethis/mock_configuration"
 require "configurethis/configuration"
 require "configurethis/configurethis_properties"
 
@@ -22,6 +23,17 @@ module Configurethis
     configuration.root = key.to_s
   end
 
+  # Meant for testing different scenarios
+  # and avoid using the real configuration
+  # values in your tests/specs.
+  #
+  # To use, pass a hash that represents the
+  # values you like so that it mirrors the yml files
+  # structure.
+  def test_with(values)
+    @configuration = MockConfiguration.new values
+  end
+
   def configure_this_with(path)
     @configuration_file = path
   end

data/lib/configurethis/mock_configuration.rb

@@ -0,0 +1,31 @@
+module Configurethis
+  class MockConfiguration
+    attr_reader :path
+
+    def initialize(values)
+      @path = "<mocked_configuration>"
+      @mock_values = values
+    end
+
+    def root=(key)
+      @values = load_configuration.fetch(key)
+    rescue ::IndexError
+      raise "'#{key}' is not configured in #{path}"
+    end
+
+    def [](key)
+      @values ||= load_configuration
+      val = @values.fetch(key)
+      return ValueContainer.new(val, path) if val.is_a?(Hash)
+      val
+    rescue ::IndexError
+      raise "'#{key}' is not configured in #{path}"
+    end
+
+    def load_configuration
+      @mock_values
+    end
+
+
+  end
+end

data/lib/configurethis/version.rb

@@ -1,3 +1,3 @@
 module Configurethis
-  VERSION = "1.0.3"
+  VERSION = "1.0.4"
 end

data/spec/configurethis/configurethis_spec.rb

@@ -50,6 +50,29 @@ describe Configurethis do
     end
   end
 
+  describe "providing test values to use" do
+    after(:each) { NestedConfig.reload_configuration }
+    Given (:config) { NestedConfig }
+
+    context "when no test values are passed" do
+      Given { config.test_with(Hash.new) }
+      Then  { expect{ config.level1 }.to raise_error(RuntimeError, "'level1' is not configured in <mocked_configuration>") }
+    end
+
+    context "when values are passed" do
+      Given { config.test_with({ "level100" => "faked out!"}) }
+      Then  { expect( config.level100 ).to eql( "faked out!" ) }
+
+      context "and root value is set" do
+        Given { config.test_with( {"qa" => { "alpha" => "a" }, "alpha" => "wrong one"} ) }
+        Given { config.set_root = "qa" }
+        Then  { expect( config.alpha ).to eql( "a" ) }
+      end
+    end
+
+
+  end
+
   describe "using configured values" do
     Given { Configurethis.root_path = File.join(File.dirname(__FILE__), 'support/config') }
 

metadata

@@ -1,30 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: configurethis
 version: !ruby/object:Gem::Version
-  version: 1.0.3
-  prerelease: 
+  version: 1.0.4
 platform: ruby
 authors:
 - Matt Snyder
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-29 00:00:00.000000000 Z
+date: 2013-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-given
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: 3.0.0
 description: Clean up your configuration approach by using Configurethis. Configurethis
@@ -47,6 +44,7 @@ files:
 - lib/configurethis.rb
 - lib/configurethis/configuration.rb
 - lib/configurethis/configurethis_properties.rb
+- lib/configurethis/mock_configuration.rb
 - lib/configurethis/value_container.rb
 - lib/configurethis/version.rb
 - spec/configurethis/configurethis_spec.rb
@@ -67,27 +65,26 @@ homepage: https://github.com/mattsnyder/configurethis
 licenses:
 - MIT
 - GPL-2
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 2.0.6
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Clean up your configuration approach by using Configurethis. Configurethis
   allows you to access your config values using method names instead of string literals
   to identify which config value you want to retrieve.