constellation 0.1.0 → 0.1.1

data/README.md

@@ -4,7 +4,7 @@ Constellation is a powerful configuration system. It's great for
 API client libraries and applications and anywhere else you need to
 let your users set some configuration parameters.
 
-## Usage
+## Putting Settings In
 
 ### Ruby Parameters
 
@@ -112,3 +112,45 @@ class MyConfiguration
   end
 end
 ```
+
+## Getting Settings Out
+
+Given a `Constellation` configuration object
+
+```ruby
+c = MyConfiguration.new(:foo => 'bar')
+```
+
+you can get the settings out in a few ways.
+
+Keys are available as methods:
+
+```ruby
+c.foo     # => "bar"
+```
+
+Keys are converted to `String`s and available via `[]`:
+
+```ruby
+c['foo']  # => "bar"
+```
+
+`to_hash` will return all of the settings:
+
+```ruby
+c.to_hash # => { "foo" => "bar" }
+```
+
+The enumerable methods are available:
+
+```ruby
+c.map { |k,v| k + ':' + v } # => [ "foo:bar" ]
+```
+
+If you have loaded [`activesupport`](http://rubygems.org/gems/activesupport),
+the configuration will be available with
+[indifferent access](http://guides.rubyonrails.org/active_support_core_extensions.html#indifferent-access):
+
+```ruby
+c[:foo]   # => "bar"
+```

data/lib/constellation.rb

@@ -22,6 +22,7 @@ module Constellation
 
     def initialize(data = nil)
       @data = {}
+      indifferentize!
       reverse_merge(data || {})
       fall_back_on_env
       fall_back_on_file(Dir.pwd)
@@ -57,6 +58,11 @@ module Constellation
 
     attr_reader :data
 
+    def indifferentize!
+      return unless data.respond_to?(:with_indifferent_access)
+      @data = data.with_indifferent_access
+    end
+
     def fall_back_on_env
       env_values = self.class.env_params.inject({}) do |sum, (prop, env_prop)|
         sum[prop] = ENV[env_prop] if ENV.has_key?(env_prop)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: constellation
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-03-10 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
-  requirement: &70157990197000 !ruby/object:Gem::Requirement
+  requirement: &70178361315940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70157990197000
+  version_requirements: *70178361315940
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70157990196420 !ruby/object:Gem::Requirement
+  requirement: &70178361315460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70157990196420
+  version_requirements: *70178361315460
 - !ruby/object:Gem::Dependency
   name: fakefs
-  requirement: &70157990195860 !ruby/object:Gem::Requirement
+  requirement: &70178361314880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70157990195860
+  version_requirements: *70178361314880
 - !ruby/object:Gem::Dependency
   name: mocha
-  requirement: &70157990195320 !ruby/object:Gem::Requirement
+  requirement: &70178361314260 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70157990195320
+  version_requirements: *70178361314260
 description: Load configuration settings from ENV, dotfiles, and gems
 email:
 - james.a.rosen@gmail.com