config_mapper 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: c439738a98e1865c82d286061ea400b181ff9899
-  data.tar.gz: 9a850ec8e62445f822838cb388dee7b1f3fae69f
+SHA256:
+  metadata.gz: 893366e1a4af52a813c5b92b4053ce74266f04ff2ae5714d901567cd2cc6e82e
+  data.tar.gz: b0b1583750a6b2a5951d87dda67e7a919e82ae4eac49af820b2841140a24b459
 SHA512:
-  metadata.gz: cfe874d019e5d3f0195b42a0945d6d5f335c660e6a45bfc6b93f7a32b1af1bb193aa5088c3f2ae0dcb543b49fca33394813158bd167b90988643af7cd5d9d128
-  data.tar.gz: 10de84239f89b4bd1a83a62ed172537684a28add36cf5e52e87c76b109f9ae6267f52d9ee030d8612c402f662b8c70e07028f5592147589ac64612d627d5280f
+  metadata.gz: ec06636f7a51b8c0a8843f3fdaeb538f5b1fad50db5f990b1e2f34d4e1af6c131ef29a78921af31c6d72b9ecec3abde5fa7f96b620ecdc702d54e71803b5d6a3
+  data.tar.gz: c69ea2e26bd80e145179afd3800d6bf2efde4ecb8701d47e6c27e83149619006388df4ccd629ff4105aa09d5d90c403c114f89d16acc0ad563c10a945ae4a8fd

data/README.md

@@ -1,7 +1,7 @@
 # ConfigMapper
 
 [![Gem Version](https://badge.fury.io/rb/config_mapper.svg)](https://badge.fury.io/rb/config_mapper)
-[![Build Status](https://travis-ci.org/mdub/config_mapper.svg?branch=master)](https://travis-ci.org/mdub/config_mapper)
+[![Build Status](https://github.com/mdub/config_mapper/actions/workflows/test.yaml/badge.svg?branch=master)](https://github.com/mdub/config_mapper/actions/workflows/test.yaml)
 
 ConfigMapper maps configuration data onto Ruby objects.
 
@@ -72,21 +72,6 @@ state.orientation              #=> "North"
 state.position.x               #=> 2
 ```
 
-It can even populate Hashes of objects, e.g.
-
-```ruby
-positions = Hash.new { |h,k| h[k] = Position.new }
-
-config_data = {
-  "fred" => { "x" => 2, "y" => 4 },
-  "mary" => { "x" => 3, "y" => 5 }
-}
-
-ConfigMapper.configure_with(config_data, positions)
-positions["fred"].x            #=> 2
-positions["mary"].y            #=> 5
-```
-
 ### Target object
 
 Given
@@ -134,7 +119,7 @@ makes it even easier to declare configuration data-structures.
 
 ### Attributes
 
-The `attribute` method is similar to `attr_accessor`, defining both reader and writer methods for the named attribute.   
+The `attribute` method is similar to `attr_accessor`, defining both reader and writer methods for the named attribute.
 
 ```ruby
 require "config_mapper/config_struct"
@@ -204,7 +189,7 @@ Specify a default value of `nil` to mark an attribute as optional. Attributes wi
 
 ### Sub-components
 
-The `component` method defines a nested component object, itself a `ConfigStruct`.  
+The `component` method defines a nested component object, itself a `ConfigStruct`.
 
 ```ruby
 class State < ConfigMapper::ConfigStruct
@@ -217,7 +202,7 @@ class State < ConfigMapper::ConfigStruct
 end
 ```
 
-`component_list` declares a nested list of configurable objects, indexed by position, and `component_dict` declares a dictionary (map) of configurable objects, indexed by an arbitrary key.
+`component_list` declares a nested list of configurable objects, indexed by position.
 
 ```ruby
 class Polygon < ConfigMapper::ConfigStruct
@@ -229,6 +214,11 @@ class Polygon < ConfigMapper::ConfigStruct
 
 end
 
+```
+
+`component_dict` declares a dictionary (map) of configurable objects, indexed by an arbitrary key.
+
+```ruby
 class Cargo < ConfigMapper::ConfigStruct
 
   component_dict :packages do

data/lib/config_mapper/collection_mapper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "config_mapper/mapper"
 
 module ConfigMapper
@@ -22,7 +24,7 @@ module ConfigMapper
       @hash[key] = value
     end
 
-    def can_set?(key)
+    def can_set?(_key)
       @hash.respond_to?("[]=")
     end
 

data/lib/config_mapper/config_dict.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "config_mapper/factory"
 require "config_mapper/validator"
 require "forwardable"
@@ -22,6 +24,7 @@ module ConfigMapper
 
       def config_doc
         return {} unless entry_factory.respond_to?(:config_doc)
+
         {}.tap do |result|
           entry_factory.config_doc.each do |path, doc|
             result["[X]#{path}"] = doc
@@ -55,6 +58,7 @@ module ConfigMapper
         each do |key, value|
           prefix = "[#{key.inspect}]"
           next unless value.respond_to?(:config_errors)
+
           value.config_errors.each do |path, path_errors|
             errors["#{prefix}#{path}"] = path_errors
           end

data/lib/config_mapper/config_list.rb

@@ -1,5 +1,7 @@
-require 'config_mapper'
-require 'config_mapper/config_struct'
+# frozen_string_literal: true
+
+require "config_mapper"
+require "config_mapper/config_struct"
 require "config_mapper/factory"
 require "config_mapper/validator"
 require "forwardable"
@@ -21,6 +23,7 @@ module ConfigMapper
 
       def config_doc
         return {} unless entry_factory.respond_to?(:config_doc)
+
         {}.tap do |result|
           entry_factory.config_doc.each do |path, doc|
             result["[N]#{path}"] = doc
@@ -41,10 +44,9 @@ module ConfigMapper
 
     def to_a
       map do |element|
-        case
-          when element.respond_to?(:to_h); element.to_h
-          when element.respond_to?(:to_a); element.to_a
-          else element
+        if element.respond_to?(:to_h) then element.to_h
+        elsif element.respond_to?(:to_a) then element.to_a
+        else element
         end
       end
     end
@@ -53,6 +55,7 @@ module ConfigMapper
       {}.tap do |errors|
         each_with_index do |element, index|
           next unless element.respond_to?(:config_errors)
+
           prefix = "[#{index}]"
           element.config_errors.each do |path, path_errors|
             errors["#{prefix}#{path}"] = path_errors
@@ -69,4 +72,3 @@ module ConfigMapper
 
   end
 end
-

data/lib/config_mapper/config_struct.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "config_mapper"
 require "config_mapper/config_dict"
 require "config_mapper/factory"
@@ -36,8 +38,7 @@ module ConfigMapper
       # @param default default value
       # @yield type-coercion block
       #
-      def attribute(name, type = nil, default: :no_default, description: nil, &type_block)
-
+      def attribute(name, type = nil, default: :no_default, description: nil, &type_block) # rubocop:disable Metrics/PerceivedComplexity
         attribute = attribute!(name)
         attribute.description = description
 
@@ -52,12 +53,11 @@ module ConfigMapper
         define_method("#{attribute.name}=") do |value|
           if value.nil?
             raise NoValueProvided if attribute.required
-          else
-            value = attribute.validator.call(value) if attribute.validator
+          elsif attribute.validator
+            value = attribute.validator.call(value)
           end
           instance_variable_set("@#{attribute.name}", value)
         end
-
       end
 
       # Defines a sub-component.
@@ -86,7 +86,7 @@ module ConfigMapper
       #
       def component_dict(name, type: ConfigStruct, key_type: nil, description: nil, &block)
         type = Class.new(type, &block) if block
-        component(name, type: ConfigDict::Factory.new(type, key_type), description: description)
+        component(name, :type => ConfigDict::Factory.new(type, key_type), :description => description)
       end
 
       # Defines an array of sub-components.
@@ -99,7 +99,7 @@ module ConfigMapper
       #
       def component_list(name, type: ConfigStruct, description: nil, &block)
         type = Class.new(type, &block) if block
-        component(name, type: ConfigList::Factory.new(type), description: description)
+        component(name, :type => ConfigList::Factory.new(type), :description => description)
       end
 
       # Generate documentation, as Ruby data.
@@ -119,8 +119,10 @@ module ConfigMapper
 
       def each_attribute(&action)
         return enum_for(:each_attribute) unless action
+
         ancestors.each do |klass|
           next unless klass.respond_to?(:attributes)
+
           klass.attributes.each(&action)
         end
       end
@@ -170,9 +172,9 @@ module ConfigMapper
       {}.tap do |result|
         self.class.each_attribute do |attribute|
           value = send(attribute.name)
-          if value && value.respond_to?(:to_h) && !value.is_a?(Array)
+          if value&.respond_to?(:to_h) && !value.is_a?(Array) && !value.is_a?(ConfigList)
             value = value.to_h
-          elsif value && value.respond_to?(:to_a)
+          elsif value&.respond_to?(:to_a)
             value = value.to_a
           end
           result[attribute.name.to_s] = value
@@ -186,6 +188,7 @@ module ConfigMapper
       {}.tap do |result|
         self.class.each_attribute do |a|
           next unless a.factory
+
           result[".#{a.name}"] = instance_variable_get("@#{a.name}")
         end
       end
@@ -202,9 +205,7 @@ module ConfigMapper
     def missing_required_attribute_errors
       {}.tap do |errors|
         self.class.each_attribute do |a|
-          if a.required && instance_variable_get("@#{a.name}").nil?
-            errors[".#{a.name}"] = NoValueProvided.new
-          end
+          errors[".#{a.name}"] = NoValueProvided.new if a.required && instance_variable_get("@#{a.name}").nil?
         end
       end
     end
@@ -213,6 +214,7 @@ module ConfigMapper
       {}.tap do |errors|
         components.each do |component_path, component_value|
           next unless component_value.respond_to?(:config_errors)
+
           component_value.config_errors.each do |path, value|
             errors["#{component_path}#{path}"] = value
           end
@@ -227,15 +229,16 @@ module ConfigMapper
       end
 
       attr_reader :name
+      attr_reader :factory
 
       attr_accessor :description
-      attr_accessor :factory
       attr_accessor :validator
       attr_accessor :default
       attr_accessor :required
 
       def initial_value
         return factory.new if factory
+
         default
       end
 
@@ -261,6 +264,7 @@ module ConfigMapper
 
       def type_doc
         return {} unless factory.respond_to?(:config_doc)
+
         factory.config_doc.each_with_object({}) do |(path, doc), result|
           result[".#{name}#{path}"] = doc
         end

data/lib/config_mapper/factory.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ConfigMapper
 
   module Factory
@@ -5,6 +7,7 @@ module ConfigMapper
     def self.resolve(arg)
       return arg if arg.respond_to?(:new)
       return ProcFactory.new(arg) if arg.respond_to?(:call)
+
       raise ArgumentError, "invalid factory"
     end
 
@@ -12,7 +15,7 @@ module ConfigMapper
 
   class ProcFactory
 
-    def initialize(f)
+    def initialize(f) # rubocop:disable Naming/MethodParameterName
       @f = f
     end
 

data/lib/config_mapper/mapper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ConfigMapper
 
   # Something that accepts configuration.

data/lib/config_mapper/mapping_error.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ConfigMapper
 
   # Thrown to indicate a problem parsing config.
@@ -16,7 +18,7 @@ module ConfigMapper
     def generate_message
       result = "configuration error"
       errors_by_field.each do |field, error|
-        result << "\n  #{field[1..-1]} - #{error}"
+        result += "\n  #{field[1..-1]} - #{error}"
       end
       result
     end

data/lib/config_mapper/object_mapper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "config_mapper/mapper"
 
 module ConfigMapper

data/lib/config_mapper/validator.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ConfigMapper
 
   module Validator
@@ -8,6 +10,7 @@ module ConfigMapper
         # looks like a primitive class -- find the corresponding coercion method
         return Kernel.method(arg.name)
       end
+
       arg
     end
 

data/lib/config_mapper/version.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 module ConfigMapper
 
-  VERSION = "1.7.0".freeze
+  VERSION = "1.8.0"
 
 end

data/lib/config_mapper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "config_mapper/collection_mapper"
 require "config_mapper/config_dict"
 require "config_mapper/config_list"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: config_mapper
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Mike Williams
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-02-01 00:00:00.000000000 Z
+date: 2023-02-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,43 +16,57 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.12.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.12.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.46.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: 
+        version: 1.46.0
+description:
 email:
 - mdub@dogbiscuit.org
 executables: []
@@ -76,7 +90,7 @@ homepage: https://github.com/mdub/config_mapper
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -84,16 +98,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.13
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Maps config data onto plain old objects
 test_files: []