constellation 0.0.2 → 0.1.0

data/README.md

@@ -8,11 +8,11 @@ let your users set some configuration parameters.
 
 ### Ruby Parameters
 
-Start by creating a class and calling `acts_as_constellation`
+Start by creating a class and calling `Constellation.enhance`:
 
 ```ruby
 class MyConfiguration
-  acts_as_constellation
+  Constellation.enhance self
 end
 ```
 
@@ -39,6 +39,7 @@ ENV['MY_FOO'] = 'bar'
 ...
 config = MyConfiguration.new
 config.foo # => "bar"
+```
 
 ### Configuration Files
 
@@ -110,4 +111,4 @@ class MyConfiguration
     result
   end
 end
-```
+```

data/lib/constellation.rb

@@ -6,12 +6,10 @@ module Constellation
     end
   end
 
-  module ActsAs
-    def acts_as_constellation
-      extend Constellation::ClassMethods
-      self.env_params = {}
-      include Constellation::InstanceMethods
-    end
+  def self.enhance(klass)
+    klass.extend Constellation::ClassMethods
+    klass.env_params = {}
+    klass.send :include, Constellation::InstanceMethods
   end
 
   module ClassMethods
@@ -20,6 +18,8 @@ module Constellation
 
   module InstanceMethods
 
+    include Enumerable
+
     def initialize(data = nil)
       @data = {}
       reverse_merge(data || {})
@@ -29,10 +29,18 @@ module Constellation
       fall_back_on_gems
     end
 
+    def to_hash
+      @data.dup
+    end
+
     def [](key)
       @data[key.to_s]
     end
 
+    def each(&block)
+      @data.each &block
+    end
+
     def method_missing(name, *arguments, &block)
       if data.has_key?(name.to_s)
         data[name.to_s]
@@ -110,5 +118,3 @@ module Constellation
   end
 
 end
-
-Class.send :include, Constellation::ActsAs

data/spec/constellation_spec.rb

@@ -10,7 +10,7 @@ describe Constellation do
 
   let(:config_class) do
     Class.new.tap do |c|
-      c.acts_as_constellation
+      Constellation.enhance c
       c.env_params = { foo: 'MY_FOO', bar: 'MY_BAR' }
       c.config_file = path
       c.load_from_gems = load_from_gems
@@ -121,4 +121,29 @@ describe Constellation do
       it('parses with the given parse method') { subject.foo.should == 'colonfoo' }
     end
   end
+
+  describe '#to_hash' do
+    subject { config_class.new(foo: 'FOO') }
+
+    it 'returns a Hash containing the settings' do
+      subject.to_hash['foo'].should == 'FOO'
+    end
+
+    it 'returns a defensive copy' do
+      subject.to_hash['foo'] = 'BAR'
+      subject.foo.should == 'FOO'
+    end
+  end
+
+  describe 'enumerable methods' do
+    subject { config_class.new(foo: 'FOO') }
+
+    it 'enumerates over the settings' do
+      result = []
+      subject.each { |k,v| result << [k,v] }
+      result.should == [ ['foo', 'FOO'] ]
+    end
+
+    it('is an Enumerable') { subject.should be_kind_of(Enumerable) }
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: constellation
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-08 00:00:00.000000000Z
+date: 2012-03-10 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
-  requirement: &70109801362700 !ruby/object:Gem::Requirement
+  requirement: &70157990197000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70109801362700
+  version_requirements: *70157990197000
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70109801362020 !ruby/object:Gem::Requirement
+  requirement: &70157990196420 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70109801362020
+  version_requirements: *70157990196420
 - !ruby/object:Gem::Dependency
   name: fakefs
-  requirement: &70109801360920 !ruby/object:Gem::Requirement
+  requirement: &70157990195860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70109801360920
+  version_requirements: *70157990195860
 - !ruby/object:Gem::Dependency
   name: mocha
-  requirement: &70109801360340 !ruby/object:Gem::Requirement
+  requirement: &70157990195320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70109801360340
+  version_requirements: *70157990195320
 description: Load configuration settings from ENV, dotfiles, and gems
 email:
 - james.a.rosen@gmail.com