config_mapper 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 071bbe40a32e09004ef7e5a12ddc9eb909b7e06a
-  data.tar.gz: c49eff8eda1e383a3e02f72aa6c7baca0f8810c6
+  metadata.gz: cad2a71b7850554a0a981b18d91bb1198cd16f8a
+  data.tar.gz: 305d415a5243d35b97d4a9b881fe51fad55217c5
 SHA512:
-  metadata.gz: 8f8f2fdbf001b744b04c2ceb39c64c5df448568ea4b4e915d12060f0571c6bc2a8ad0581b27a545403066881f79a98f3f1633de2239959d90558967e2392089e
-  data.tar.gz: 51f1cffdbbccc557e8a13b7c0882b5cdaefef07d167971a79c22ffe20fc5153c37ae77c8381045c04681715514dabb8ef24e0c9b2334fef454b55a5fc3a67c89
+  metadata.gz: 91509bfa9e31c03bb8093c434942980cbd8616fffb22b7d0b4bf21f64edd01b750b7e9dd270c2d491452ae191455dcdf9c49724feb1d9f5076c3421c54d16c6d
+  data.tar.gz: 423dcae0bc0c14b13979fbf1a10980b43c5e669a23fa521ad8b864fba965f83f3e5ee5bab1c569a8b6c2c47de017570964bd08ae7ef3b0cd36f37cb20c3da6b1

data/README.md

@@ -246,6 +246,12 @@ state.configure_with(data)
 #=> }
 ```
 
+`ConfigStruct.from_data` instantiates an object from data, raising an exception if errors are encountered:
+
+```ruby
+state = State.from_data(data)
+```
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/config_mapper/config_struct.rb

@@ -1,6 +1,7 @@
 require "config_mapper"
 require "config_mapper/config_dict"
 require "config_mapper/factory"
+require "config_mapper/mapping_error"
 require "config_mapper/validator"
 
 module ConfigMapper
@@ -11,6 +12,18 @@ module ConfigMapper
 
     class << self
 
+      # Instantiate from data.
+      #
+      # @param attribute_values [Hash] attribute values
+      # @raise [ConfigMapper::MappingError] on error
+      #
+      def from_data(attribute_values)
+        new.tap do |instance|
+          errors = instance.configure_with(attribute_values)
+          raise MappingError, errors if errors.any?
+        end
+      end
+
       # Defines reader and writer methods for the specified attribute.
       #
       # A `:default` value may be specified; otherwise, the attribute is

data/lib/config_mapper/mapping_error.rb

@@ -0,0 +1,26 @@
+module ConfigMapper
+
+  # Thrown to indicate a problem parsing config.
+  #
+  class MappingError < StandardError
+
+    def initialize(errors_by_field)
+      @errors_by_field = errors_by_field
+      super(generate_message)
+    end
+
+    attr_reader :errors_by_field
+
+    private
+
+    def generate_message
+      result = "configuration error"
+      errors_by_field.each do |field, error|
+        result << "\n  #{field[1..-1]} - #{error}"
+      end
+      result
+    end
+
+  end
+
+end

data/lib/config_mapper/version.rb

@@ -1,5 +1,5 @@
 module ConfigMapper
 
-  VERSION = "1.5.0".freeze
+  VERSION = "1.6.0".freeze
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: config_mapper
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Mike Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-08-01 00:00:00.000000000 Z
+date: 2017-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -67,6 +67,7 @@ files:
 - lib/config_mapper/config_struct.rb
 - lib/config_mapper/factory.rb
 - lib/config_mapper/mapper.rb
+- lib/config_mapper/mapping_error.rb
 - lib/config_mapper/object_mapper.rb
 - lib/config_mapper/validator.rb
 - lib/config_mapper/version.rb
@@ -90,7 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.12
+rubygems_version: 2.6.13
 signing_key: 
 specification_version: 4
 summary: Maps config data onto plain old objects