acts_as_hashable 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9fd301ccb4d740406de4faa658a77fece8ff4e492569882355227a35276bfd1
-  data.tar.gz: d6e3e8c2bbd3a95c5d438da03188d84ee2941409b13c45e536df8a462b0a1195
+  metadata.gz: 512a071f89b95030d2e3669230a444aeb2c84bfa3eba507e922364f92d00d484
+  data.tar.gz: a6a796fbbcbae31bcd528bf1300e1ef74c61b3db1a104898320569a68c48e378
 SHA512:
-  metadata.gz: e484913fe20a7b5d7fd4afde3778e92b5986d5fae952dfe3b7b32c51a38f1f9e12ca8533c18e6fab1a0d9fad2c191f361a7e38634f92fdeccbc8d3eb604b5e11
-  data.tar.gz: bf7ba60f5e6435cf4094ed9199bf3115e58cdbaeb03b24e4ee0aa4778bb510b0b40f7d3f825de11d7852b10fe058d790fb8cb2d2990e2a432225c06c4691246c
+  metadata.gz: 3cdcb125699f45bf9165bf92008eb42eede26e983d4ed82335116c72640b8a1356a1202b366c294e75966312d9b02e1bd0703fbf9dfea74318c459b78a73efe6
+  data.tar.gz: b7b0e7304fec6cf66c4a034a0575244b06ee3c7f5381274df3fbbe5bcc33b12982d67f6ad9271f8ab196acf77bd37e42a90c6f068038e9890eafd6997d5b22bc

data/.gitignore

@@ -3,3 +3,4 @@
 /tmp
 /coverage
 /pkg
+Gemfile.lock

data/.rubocop.yml

@@ -3,9 +3,11 @@ Metrics/LineLength:
 
 Metrics/BlockLength:
   ExcludedMethods: ['it', 'describe', 'context', 'let', 'specify']
+  Exclude:
+    - acts_as_hashable.gemspec
 
 AllCops:
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.5
 
 Style/RescueModifier:
   Enabled: false

data/.ruby-version

@@ -1 +1 @@
-2.6.0
+2.6.6

data/.travis.yml

@@ -4,10 +4,9 @@ env:
 language: ruby
 rvm:
   # Build on the latest stable of all supported Rubies (https://www.ruby-lang.org/en/downloads/):
-  - 2.3.8
-  - 2.4.5
-  - 2.5.3
-  - 2.6.0
+  - 2.5.8
+  - 2.6.6
+  - 2.7.1
 cache: bundler
 before_script:
   - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
@@ -18,3 +17,8 @@ script:
   - bundle exec rspec
 after_script:
   - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT
+addons:
+  # https://docs.travis-ci.com/user/uploading-artifacts/
+  artifacts:
+    paths:
+      - Gemfile.lock

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# 1.3.0 (September 5th, 2020)
+
+Additions:
+
+* Added dynamic class constantization when a string is registered for a Factory.
+
+# 1.2.0 (June 9th, 2020)
+
+* Bumped minimum Ruby version to >= 2.5
+* Do not pass in any constructor arguments unless we have at least one key.
+* Add more detail to construction errors.
+
 # 1.1.0 (May 3rd, 2019)
 
 * Added acts_as_hashable_factory to dynamically create objects.

data/README.md

@@ -19,7 +19,7 @@ The two class-level factory methods are just meant to create a syntactic hash-li
 To install through Rubygems:
 
 ````
-gem install install acts_as_hashable
+gem install acts_as_hashable
 ````
 
 You can also add this to your Gemfile:
@@ -197,6 +197,21 @@ end
 
 In case you need full control of the registry you can also choose to simply override the class-level `registry` method which will simply return a hash of keys (names) and values (class constants).
 
+### Resolving Constants at Runtime
+
+Factories can also be resolved using Ruby's Object#const_get and Object#const_missing.  Simply register a string  representing the class in order to use these mechanics, such as:
+
+```ruby
+class ExampleFactory
+  acts_as_hashable_factory
+
+  type_key 'object_type'
+
+  register 'Pet', 'Pet'
+
+  register 'HeadOfHousehold', ->(_key) { HeadOfHousehold }
+end
+
 ## Contributing
 
 ### Development Environment Configuration

data/Rakefile

@@ -2,7 +2,9 @@
 
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
 
-task default: :spec
+task default: %i[rubocop spec]

data/acts_as_hashable.gemspec

@@ -14,19 +14,28 @@ Gem::Specification.new do |s|
   DESCRIPTION
 
   s.authors     = ['Matthew Ruggio']
+  s.bindir      = 'exe'
   s.email       = ['mruggio@bluemarblepayroll.com']
-  s.files       = `git ls-files`.split("\n")
-  s.test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.executables = []
+  s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   s.homepage    = 'https://github.com/bluemarblepayroll/acts_as_hashable'
   s.license     = 'MIT'
+  s.metadata    = {
+    'bug_tracker_uri' => 'https://github.com/bluemarblepayroll/acts_as_hashable/issues',
+    'changelog_uri' => 'https://github.com/bluemarblepayroll/acts_as_hashable/blob/master/CHANGELOG.md',
+    'documentation_uri' => 'https://www.rubydoc.info/gems/acts_as_hashable',
+    'homepage_uri' => s.homepage,
+    'source_code_uri' => s.homepage
+  }
 
-  s.required_ruby_version = '>= 2.3.8'
+  s.required_ruby_version = '>= 2.5'
+
+  s.add_dependency('caution', '~>1')
 
   s.add_development_dependency('guard-rspec', '~>4.7')
   s.add_development_dependency('pry')
   s.add_development_dependency('pry-byebug', '~> 3')
-  s.add_development_dependency 'rake', '~> 10.0'
+  s.add_development_dependency('rake', '~> 13.0')
   s.add_development_dependency('rspec')
   s.add_development_dependency('rubocop', '~> 0.63.1')
   s.add_development_dependency('simplecov', '~>0.16.1')

data/lib/acts_as_hashable.rb

@@ -7,6 +7,7 @@
 # LICENSE file in the root directory of this source tree.
 #
 
+require 'caution'
 require 'forwardable'
 
 require_relative 'acts_as_hashable/factory'

data/lib/acts_as_hashable/constant_resolver.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+#
+# Copyright (c) 2019-present, Blue Marble Payroll, LLC
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+
+module ActsAsHashable
+  # This class is responsible for turning strings and symbols into constants.
+  # It does not deal with inflection, simply just constant resolution.
+  class ConstantResolver # :nodoc: all
+    # Only use Module constant resolution if a string or symbol was passed in.
+    # Any other type is defined as an acceptable constant and is simply returned.
+    def constantize(value)
+      value.is_a?(String) || value.is_a?(Symbol) ? object_constant(value) : value
+    end
+
+    private
+
+    # If the constant has been loaded, we can safely use it through const_get.
+    # If the constant has not been loaded, we need to defer to const_missing to resolve it.
+    # If we blindly call const_get, it may return false positives for namespaced constants
+    # or anything nested.
+    def object_constant(value)
+      if Object.const_defined?(value, false)
+        Object.const_get(value, false)
+      else
+        Object.const_missing(value)
+      end
+    end
+  end
+end

data/lib/acts_as_hashable/factory.rb

@@ -19,34 +19,41 @@ module ActsAsHashable
   #     }
   #   end
   # You can also use the 'register' DSL:
-  # register 'some_class_name', SomeClassName
+  #   register 'some_class_name', SomeClassName
+  #   register 'some_class_name', '', SomeClassName
   # or:
-  # register 'some_class_name', ->(_key) { SomeClassName }
+  #   register 'some_class_name', ->(_key) { SomeClassName }
   module Factory
     extend Forwardable
 
     def_delegators :factory, :array, :make
 
-    def register(key, value)
-      registry[key] = value
+    def register(*args)
+      raise ArgumentError, "missing at least one key and value: #{args}" if args.length < 2
+
+      value = args.last
+
+      args[0..-2].each do |key|
+        registry[key] = value
+      end
     end
 
-    def registry
+    def registry # :nodoc:
       @registry ||= {}
     end
 
-    def materialize_registry
+    def materialize_registry # :nodoc:
       @registry.map do |k, v|
         value = v.is_a?(Proc) ? v.call(k) : v
         [k, value]
       end.to_h
     end
 
-    def type_key(key)
+    def type_key(key) # :nodoc:
       @typed_with = key
     end
 
-    def typed_with
+    def typed_with # :nodoc:
       @typed_with || TypeFactory::DEFAULT_TYPE_KEY
     end
 

data/lib/acts_as_hashable/hash_refinements.rb

@@ -10,7 +10,7 @@
 module ActsAsHashable
   # Let's provide a refinenment instead of monkey-patching Hash.  That way we can stop
   # polluting other libraries and internalize our specific needs.
-  module HashRefinements
+  module HashRefinements # :nodoc: all
     refine Hash do
       def symbolize_keys
         map { |k, v| [k.to_sym, v] }.to_h

data/lib/acts_as_hashable/hashable.rb

@@ -13,11 +13,19 @@ module ActsAsHashable
   module Hashable
     using HashRefinements
 
+    class HydrationError < Caution::CauseInjectingError; end
+
     HASHABLE_HYDRATORS = [
       {
         condition: ->(_context, object, _nullable) { object.is_a?(Hash) },
         converter: lambda do |context, object, _nullable|
-          context.new(**(object || {}).symbolize_keys)
+          args = (object || {}).symbolize_keys
+
+          if args.keys.any?
+            context.new(**args)
+          else
+            context.new
+          end
         end
       },
       {
@@ -45,12 +53,20 @@ module ActsAsHashable
 
     def make(object, nullable: true)
       HASHABLE_HYDRATORS.each do |hydrator|
-        if hydrator[:condition].call(self, object, nullable)
-          return hydrator[:converter].call(self, object, nullable)
-        end
+        next unless hydrator[:condition].call(self, object, nullable)
+
+        return hydrate(hydrator, object, nullable)
       end
 
       raise ArgumentError, "Cannot create hashable object with class name: #{object.class.name}"
     end
+
+    private
+
+    def hydrate(hydrator, object, nullable)
+      hydrator[:converter].call(self, object, nullable)
+    rescue ArgumentError
+      raise HydrationError, "#{name} cannot be hydrated using arguments: #{object}"
+    end
   end
 end

data/lib/acts_as_hashable/type_factory.rb

@@ -7,6 +7,8 @@
 # LICENSE file in the root directory of this source tree.
 #
 
+require_relative 'constant_resolver'
+
 module ActsAsHashable
   # A TypeFactory object understands how to build objects using a special designated 'type' key.
   class TypeFactory
@@ -17,8 +19,9 @@ module ActsAsHashable
     attr_reader :registry, :type_key
 
     def initialize(registry = {}, type_key = DEFAULT_TYPE_KEY)
-      @registry = registry.symbolize_keys
-      @type_key = type_key.to_s.to_sym
+      @constant_resolver = ConstantResolver.new
+      @registry          = registry.symbolize_keys
+      @type_key          = type_key.to_s.to_sym
 
       freeze
     end
@@ -34,13 +37,30 @@ module ActsAsHashable
     def make(config = {})
       config        = (config || {}).symbolize_keys
       type          = config[type_key].to_s.to_sym
-      object_class  = registry[type]
-
-      raise ArgumentError, "cannot find section from type: #{type}" unless object_class
+      object_class  = resolve_object_class(type)
 
       config_without_type = config.reject { |k| k == type_key }
 
-      object_class.new(config_without_type)
+      # We want to defer to the classes proper maker if it exists.
+      # Technically, this factory should only make classes that include Hashable, but just to be
+      # sure we do not break any existing compatibility, lets make it work for both.
+      method_name = object_class.respond_to?(:make) ? :make : :new
+
+      object_class.send(method_name, config_without_type)
+    end
+
+    private
+
+    attr_reader :constant_resolver
+
+    def resolve_object_class(type)
+      object_class = registry[type]
+
+      raise ArgumentError, "cannot find registration for: '#{type}'" unless object_class
+
+      return object_class unless object_class.is_a?(String)
+
+      constant_resolver.constantize(object_class)
     end
   end
 end

data/lib/acts_as_hashable/version.rb

@@ -8,5 +8,5 @@
 #
 
 module ActsAsHashable
-  VERSION = '1.1.0'
+  VERSION = '1.3.0'
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: acts_as_hashable
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Matthew Ruggio
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2019-05-03 00:00:00.000000000 Z
+date: 2020-09-05 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: caution
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
@@ -58,14 +72,14 @@ dependencies:
     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
@@ -128,8 +142,7 @@ description: |2
       class-level methods that you can use with hashes.
 email:
 - mruggio@bluemarblepayroll.com
-executables:
-- console
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
@@ -141,27 +154,29 @@ files:
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
 - Guardfile
 - LICENSE
 - README.md
 - Rakefile
 - acts_as_hashable.gemspec
 - bin/console
+- exe/.gitkeep
 - lib/acts_as_hashable.rb
+- lib/acts_as_hashable/constant_resolver.rb
 - lib/acts_as_hashable/factory.rb
 - lib/acts_as_hashable/hash_refinements.rb
 - lib/acts_as_hashable/hashable.rb
 - lib/acts_as_hashable/type_factory.rb
 - lib/acts_as_hashable/version.rb
-- spec/acts_as_hashable_spec.rb
-- spec/examples.rb
-- spec/factory_spec.rb
-- spec/spec_helper.rb
 homepage: https://github.com/bluemarblepayroll/acts_as_hashable
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/bluemarblepayroll/acts_as_hashable/issues
+  changelog_uri: https://github.com/bluemarblepayroll/acts_as_hashable/blob/master/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/acts_as_hashable
+  homepage_uri: https://github.com/bluemarblepayroll/acts_as_hashable
+  source_code_uri: https://github.com/bluemarblepayroll/acts_as_hashable
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -170,19 +185,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.8
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Simple hash-based factory methods for objects.
-test_files:
-- spec/acts_as_hashable_spec.rb
-- spec/examples.rb
-- spec/factory_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/Gemfile.lock

@@ -1,110 +0,0 @@
-PATH
-  remote: .
-  specs:
-    acts_as_hashable (1.1.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    ansi (1.5.0)
-    ast (2.4.0)
-    byebug (11.0.1)
-    coderay (1.1.2)
-    diff-lcs (1.3)
-    docile (1.3.1)
-    ffi (1.10.0)
-    formatador (0.2.5)
-    guard (2.15.0)
-      formatador (>= 0.2.4)
-      listen (>= 2.7, < 4.0)
-      lumberjack (>= 1.0.12, < 2.0)
-      nenv (~> 0.1)
-      notiffany (~> 0.0)
-      pry (>= 0.9.12)
-      shellany (~> 0.0)
-      thor (>= 0.18.1)
-    guard-compat (1.2.1)
-    guard-rspec (4.7.3)
-      guard (~> 2.1)
-      guard-compat (~> 1.1)
-      rspec (>= 2.99.0, < 4.0)
-    hirb (0.7.3)
-    jaro_winkler (1.5.2)
-    json (2.1.0)
-    listen (3.1.5)
-      rb-fsevent (~> 0.9, >= 0.9.4)
-      rb-inotify (~> 0.9, >= 0.9.7)
-      ruby_dep (~> 1.2)
-    lumberjack (1.0.13)
-    method_source (0.9.2)
-    nenv (0.3.0)
-    notiffany (0.1.1)
-      nenv (~> 0.1)
-      shellany (~> 0.0)
-    parallel (1.13.0)
-    parser (2.6.0.0)
-      ast (~> 2.4.0)
-    powerpack (0.1.2)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-byebug (3.7.0)
-      byebug (~> 11.0)
-      pry (~> 0.10)
-    rainbow (3.0.0)
-    rake (10.5.0)
-    rb-fsevent (0.10.3)
-    rb-inotify (0.10.0)
-      ffi (~> 1.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
-    rubocop (0.63.1)
-      jaro_winkler (~> 1.5.1)
-      parallel (~> 1.10)
-      parser (>= 2.5, != 2.5.1.1)
-      powerpack (~> 0.1)
-      rainbow (>= 2.2.2, < 4.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (~> 1.4.0)
-    ruby-progressbar (1.10.0)
-    ruby_dep (1.5.0)
-    shellany (0.0.1)
-    simplecov (0.16.1)
-      docile (~> 1.1)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-console (0.4.2)
-      ansi
-      hirb
-      simplecov
-    simplecov-html (0.10.2)
-    thor (0.20.3)
-    unicode-display_width (1.4.1)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  acts_as_hashable!
-  guard-rspec (~> 4.7)
-  pry
-  pry-byebug (~> 3)
-  rake (~> 10.0)
-  rspec
-  rubocop (~> 0.63.1)
-  simplecov (~> 0.16.1)
-  simplecov-console (~> 0.4.2)
-
-BUNDLED WITH
-   1.17.3

data/spec/acts_as_hashable_spec.rb

@@ -1,203 +0,0 @@
-# frozen_string_literal: true
-
-#
-# Copyright (c) 2018-present, Blue Marble Payroll, LLC
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-#
-
-require './spec/spec_helper'
-
-describe ActsAsHashable do
-  context '#make' do
-    context 'when passing in unacceptable input' do
-      it 'should raise ArgumentError for number' do
-        expect { Pet.make(1) }.to raise_error(ArgumentError)
-      end
-
-      it 'should raise ArgumentError for string' do
-        expect { Pet.make('') }.to raise_error(ArgumentError)
-      end
-
-      it 'should raise ArgumentError for true' do
-        expect { Pet.make(true) }.to raise_error(ArgumentError)
-      end
-
-      it 'should raise ArgumentError for array' do
-        expect { Pet.make([]) }.to raise_error(ArgumentError)
-      end
-    end
-
-    context 'with a hash constructor interface' do
-      it 'should properly return object if object is already the same type' do
-        original_pet_obj = Pet.new
-        pet_obj = Pet.make(original_pet_obj)
-
-        expect(pet_obj.hash).to eq(original_pet_obj.hash)
-        expect(pet_obj.name).to be nil
-        expect(pet_obj.toy).to be nil
-      end
-
-      it 'should properly return hydrated object if nil is passed in and is not nullable' do
-        pet_obj = Pet.make(nil, nullable: false)
-
-        expect(pet_obj.name).to be nil
-        expect(pet_obj.toy).to be nil
-      end
-
-      it 'should properly return nil if nil is passed in and is nullable' do
-        pet_obj = Pet.make(nil, nullable: false)
-
-        expect(pet_obj.name).to be nil
-        expect(pet_obj.toy).to be nil
-      end
-
-      it 'should properly instantiate objects from a symbol-keyed hash' do
-        pet = {
-          name: 'Doug the dog',
-          toy: { squishy: true }
-        }
-
-        pet_obj = Pet.make(pet)
-
-        expect(pet_obj.name).to eq('Doug the dog')
-        expect(pet_obj.toy.squishy).to be true
-      end
-    end
-
-    context 'with keyword arguments interface' do
-      it 'should properly instantiate objects from symbol-keyed hash' do
-        head_of_household = {
-          person: {
-            name: 'Matt',
-            age: 109
-          },
-          partner: {
-            name: 'Katie',
-            age: 110
-          }
-        }
-
-        head_of_household_obj = HeadOfHousehold.make(head_of_household)
-
-        expect(head_of_household_obj.person.name).to eq('Matt')
-        expect(head_of_household_obj.person.age).to eq(109)
-        expect(head_of_household_obj.partner.name).to eq('Katie')
-        expect(head_of_household_obj.partner.age).to eq(110)
-      end
-
-      it 'should properly instantiate objects from string-keyed hash' do
-        head_of_household = {
-          'person' => {
-            'name' => 'Matt',
-            'age' => 109
-          },
-          'partner' => {
-            'name' => 'Katie',
-            'age' => 110
-          }
-        }
-
-        head_of_household_obj = HeadOfHousehold.make(head_of_household)
-
-        expect(head_of_household_obj.person.name).to eq('Matt')
-        expect(head_of_household_obj.person.age).to eq(109)
-        expect(head_of_household_obj.partner.name).to eq('Katie')
-        expect(head_of_household_obj.partner.age).to eq(110)
-      end
-
-      it 'should raise an ArgumentError for missing required keyword' do
-        head_of_household = {
-          person: {
-            # name: 'Matt',
-            age: 109
-          },
-          partner: {
-            name: 'Katie',
-            age: 110
-          }
-        }
-
-        expect { HeadOfHousehold.make(head_of_household) }.to raise_error(ArgumentError)
-      end
-
-      it 'should raise an ArgumentError for unknown required keyword' do
-        head_of_household = {
-          person: {
-            name: 'Matt',
-            age: 109,
-            height_in_inches: 700
-          },
-          partner: {
-            name: 'Katie',
-            age: 110
-          }
-        }
-
-        expect { HeadOfHousehold.make(head_of_household) }.to raise_error(ArgumentError)
-      end
-    end
-
-    context '#array' do
-      it 'should properly create objects and arrays of objects from symbol-keyed hash and arrays' do
-        family = {
-          head_of_household: {
-            person: {
-              name: 'Matt',
-              age: 109
-            },
-            partner: {
-              name: 'Katie',
-              age: 110
-            }
-          },
-          children: [
-            { name: 'Martin', age: 29 },
-            { name: 'Short',  age: 99 }
-          ]
-        }
-
-        family_obj = Family.make(family)
-
-        expect(family_obj.head_of_household.person.name).to   eq('Matt')
-        expect(family_obj.head_of_household.person.age).to    eq(109)
-        expect(family_obj.head_of_household.partner.name).to  eq('Katie')
-        expect(family_obj.head_of_household.partner.age).to   eq(110)
-
-        expect(family_obj.children.length).to  eq(2)
-        expect(family_obj.children[0].name).to eq('Martin')
-        expect(family_obj.children[0].age).to  eq(29)
-        expect(family_obj.children[1].name).to eq('Short')
-        expect(family_obj.children[1].age).to  eq(99)
-      end
-
-      it 'should properly instantiate arrays of objects when only a single hash is passed in' do
-        family = {
-          head_of_household: {
-            person: {
-              name: 'Matt',
-              age: 109
-            },
-            partner: {
-              name: 'Katie',
-              age: 110
-            }
-          },
-          children: { name: 'Martin', age: 29 }
-        }
-
-        family_obj = Family.make(family)
-
-        expect(family_obj.head_of_household.person.name).to   eq('Matt')
-        expect(family_obj.head_of_household.person.age).to    eq(109)
-        expect(family_obj.head_of_household.partner.name).to  eq('Katie')
-        expect(family_obj.head_of_household.partner.age).to   eq(110)
-
-        expect(family_obj.children.length).to  eq(1)
-        expect(family_obj.children[0].name).to eq('Martin')
-        expect(family_obj.children[0].age).to  eq(29)
-      end
-    end
-  end
-end

data/spec/examples.rb

@@ -1,80 +0,0 @@
-# frozen_string_literal: true
-
-#
-# Copyright (c) 2018-present, Blue Marble Payroll, LLC
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-#
-
-class Toy
-  acts_as_hashable
-
-  attr_reader :squishy
-
-  def initialize(opts = {})
-    @squishy = opts[:squishy] || false
-  end
-end
-
-class Pet
-  acts_as_hashable
-
-  attr_reader :name, :toy
-
-  def initialize(opts = {})
-    @name = opts[:name]
-    @toy  = Toy.make(opts[:toy])
-  end
-end
-
-class Person
-  acts_as_hashable
-
-  attr_reader :name, :age
-
-  def initialize(name:, age:)
-    @name = name
-    @age  = age
-  end
-end
-
-class HeadOfHousehold
-  acts_as_hashable
-
-  attr_reader :person, :partner
-
-  def initialize(person:, partner: nil)
-    @person   = Person.make(person)
-    @partner  = Person.make(partner)
-  end
-end
-
-class Family
-  acts_as_hashable
-
-  attr_reader :head_of_household, :children
-
-  def initialize(head_of_household:, children: [])
-    @head_of_household  = HeadOfHousehold.make(head_of_household)
-    @children           = Person.array(children)
-  end
-end
-
-class ExampleFactory
-  acts_as_hashable_factory
-
-  type_key :object_type
-
-  register 'Person', Person
-
-  register 'Pet', Pet
-
-  register 'Toy', Toy
-
-  # These are examples of registering a proc instead of a class constant.  It
-  # will send the key through the argument if you need
-  register 'Familiy', ->(_key) { Family }
-
-  register 'HeadOfHousehold', ->(_key) { HeadOfHousehold }
-end

data/spec/factory_spec.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-#
-# Copyright (c) 2018-present, Blue Marble Payroll, LLC
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-#
-
-require './spec/spec_helper'
-
-describe ActsAsHashable::Factory do
-  subject { ExampleFactory }
-
-  it 'should hydrate example objects' do
-    objects = [
-      {
-        object_type: 'Pet',
-        name: 'Doug the dog',
-        toy: { squishy: true }
-      },
-      {
-        object_type: 'HeadOfHousehold',
-        person: {
-          name: 'Matt',
-          age: 109
-        },
-        partner: {
-          name: 'Katie',
-          age: 110
-        }
-      }
-    ]
-
-    hydrated_objects = subject.array(objects)
-
-    pet_obj = hydrated_objects.first
-
-    expect(pet_obj.name).to eq('Doug the dog')
-    expect(pet_obj.toy.squishy).to be true
-
-    head_of_household_obj = hydrated_objects.last
-
-    expect(head_of_household_obj.person.name).to eq('Matt')
-    expect(head_of_household_obj.person.age).to eq(109)
-    expect(head_of_household_obj.partner.name).to eq('Katie')
-    expect(head_of_household_obj.partner.age).to eq(110)
-  end
-end

data/spec/spec_helper.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-#
-# Copyright (c) 2018-present, Blue Marble Payroll, LLC
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-#
-
-require 'pry'
-require 'pry-byebug'
-
-unless ENV['DISABLE_SIMPLECOV'] == 'true'
-  require 'simplecov'
-  require 'simplecov-console'
-
-  SimpleCov.formatter = SimpleCov::Formatter::Console
-  SimpleCov.start do
-    add_filter %r{\A/spec/}
-  end
-end
-
-require './lib/acts_as_hashable'
-require './spec/examples'