acts_as_hashable 1.0.3 → 1.2.0.pre.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: aeda82e04843a1f805a0e056f3a1a988cf3fa624
-  data.tar.gz: 129e4222c77d0527b9932d36761a354b7e237f3f
+SHA256:
+  metadata.gz: efc9586f91e07aee23e59bc2f3fbe3d0d5c1f8e7586ee2a172dcfec3b3c36ca0
+  data.tar.gz: 1f1e8850279c8a82cbad3ed60d23415a1e1a012526ec6854113d2dc714e6e781
 SHA512:
-  metadata.gz: 70e823f2d22dc978bdc537c6bf3f74163daa796db9035f6dd3afb49d30868974f475626d14d0e046d121428efb2acca4889771f03532bb73354c20391e23feb2
-  data.tar.gz: c5520831734e879970e1abea57eead97a92794345d8d0ac6c1fc40990ba9e641fef2b983b16aa7e438d1e43fb24bac2751dd8b9d29f4fad7f2f553b29500766e
+  metadata.gz: 67c2547b85e3f13b68ad0f6085cf9bbb1e914fe99138a5f324cbd4e1c962dc2c8285f4fc65c2a67d2ac17ab4b0ac92542407311eca33cdf3082e8c457ab59de8
+  data.tar.gz: 52e1dfc7fe3ae98932ce7040e79961134ec8d783e7d909e98378f87f3cdf888622d5667a1c468471de03e5d7eaeddd43658aee421b25eeced0b1606f0894a07f

data/.gitignore

@@ -1,2 +1,6 @@
 .DS_Store
 *.gem
+/tmp
+/coverage
+/pkg
+Gemfile.lock

data/.rubocop.yml

@@ -1,4 +1,13 @@
-inherit_from: .rubocop_todo.yml
-
 Metrics/LineLength:
   Max: 100
+
+Metrics/BlockLength:
+  ExcludedMethods: ['it', 'describe', 'context', 'let', 'specify']
+  Exclude:
+    - acts_as_hashable.gemspec
+
+AllCops:
+  TargetRubyVersion: 2.5
+
+Style/RescueModifier:
+  Enabled: false

data/.ruby-version

@@ -1 +1 @@
-2.3.7
+2.6.6

data/.travis.yml

@@ -1,8 +1,24 @@
+env:
+  global:
+    - CC_TEST_REPORTER_ID=830db02445429888fcdd7d1406dd82e9b32535e863ac54a538a162c0c4acd4d1
 language: ruby
 rvm:
-  - 2.3.1
-  - 2.3.7
+  # Build on the latest stable of all supported Rubies (https://www.ruby-lang.org/en/downloads/):
+  - 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
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
 script:
   - bundle exec rubocop
   - 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

@@ -0,0 +1,23 @@
+# 1.2.0 (une 8th, 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.
+
+# 1.0.5 (February 5th, 2019)
+
+* Fixed equality bug in array reject block.
+
+# 1.0.4 (January 30th, 2019)
+
+Maintenance Release
+
+* Added bin/console script
+* Added CHANGELOG
+* Updated README with publication steps, additional testing steps
+* Bumped minimum Ruby to 2.3.8
+* Added Guard

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at oss@bluemarblepayroll.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Guardfile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+guard :rspec, cmd: 'DISABLE_SIMPLECOV=true bundle exec rspec --format=documentation' do
+  require 'guard/rspec/dsl'
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end

data/README.md

@@ -1,8 +1,8 @@
 # Acts as Hashable
 
-[![Build Status](https://travis-ci.org/bluemarblepayroll/acts_as_hashable.svg?branch=master)](https://travis-ci.org/bluemarblepayroll/acts_as_hashable)
+[![Gem Version](https://badge.fury.io/rb/acts_as_hashable.svg)](https://badge.fury.io/rb/acts_as_hashable) [![Build Status](https://travis-ci.org/bluemarblepayroll/acts_as_hashable.svg?branch=master)](https://travis-ci.org/bluemarblepayroll/acts_as_hashable) [![Maintainability](https://api.codeclimate.com/v1/badges/647dac37b9a8177f3d84/maintainability)](https://codeclimate.com/github/bluemarblepayroll/acts_as_hashable/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/647dac37b9a8177f3d84/test_coverage)](https://codeclimate.com/github/bluemarblepayroll/acts_as_hashable/test_coverage) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-This is a small library that helps increase the pliability of object constructor signatures.  
+This is a small library that helps increase the pliability of object constructor signatures.
 Instead of instantiating via the constructor, this library can install helper factory
 class-level methods that you can use with hashes:
 
@@ -10,7 +10,7 @@ class-level methods that you can use with hashes:
 * array(): create an array of instances of a class
 
 One caveat to this library is that it is not meant to be a complete modeling solution but rather
-just a tool that helps model a domain or complete a modeling framework.  
+just a tool that helps model a domain or complete a modeling framework.
 The main missing element to this library is that you still have to manage and implement constructors.
 The two class-level factory methods are just meant to create a syntactic hash-like interface.
 
@@ -30,6 +30,8 @@ bundle add acts_as_hashable
 
 ## Examples
 
+### Utilizing Classes on Hashabled Classes
+
 Consider the following example:
 
 ````
@@ -125,6 +127,76 @@ class Pet
 end
 ````
 
+### Dynamic Factory Building
+
+More complex relationships may contain objects with disparate types.  In this case we can use the included factory
+pattern to help us build these.  Based on our examples above:
+
+```ruby
+class ExampleFactory
+  acts_as_hashable_factory
+
+  register 'Pet', Pet
+
+  register 'HeadOfHousehold', HeadOfHousehold
+end
+```
+
+Now we can dynamically build these using:
+
+```ruby
+objects = [
+  {
+    type: 'Pet',
+    name: 'Doug the dog',
+    toy: { squishy: true }
+  },
+  {
+    type: 'HeadOfHousehold',
+    person: {
+      name: 'Matt',
+      age: 109
+    },
+    partner: {
+      name: 'Katie',
+      age: 110
+    }
+  }
+]
+
+hydrated_objects = ExampleFactory.array(objects)
+```
+
+If the type key does not happen to be `type` then you can explicitly set this as:
+
+```ruby
+class ExampleFactory
+  acts_as_hashable_factory
+
+  type_key 'object_type'
+
+  register 'Pet', Pet
+
+  register 'HeadOfHousehold', HeadOfHousehold
+end
+```
+
+You can also choose to pass in a proc/lambda instead of a class constant:
+
+```ruby
+class ExampleFactory
+  acts_as_hashable_factory
+
+  type_key 'object_type'
+
+  register 'Pet', Pet
+
+  register 'HeadOfHousehold', ->(_key) { HeadOfHousehold }
+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).
+
 ## Contributing
 
 ### Development Environment Configuration
@@ -142,9 +214,38 @@ Basic steps to take to get this repository compiling:
 To execute the test suite run:
 
 ````
-rspec spec --format documentation
+bundle exec rspec spec --format documentation
+````
+
+Alternatively, you can have Guard watch for changes:
+
+````
+bundle exec guard
+````
+
+Also, do not forget to run Rubocop:
+
+````
+bundle exec rubocop
 ````
 
+### Publishing
+
+Note: ensure you have proper authorization before trying to publish new versions.
+
+After code changes have successfully gone through the Pull Request review process then the following steps should be followed for publishing new versions:
+
+1. Merge Pull Request into master
+2. Update ```lib/acts_as_hashable/version.rb``` using [semantic versioning](https://semver.org/)
+3. Install dependencies: ```bundle```
+4. Update ```CHANGELOG.md``` with release notes
+5. Commit & push master to remote and ensure CI builds master successfully
+6. Run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Code of Conduct
+
+Everyone interacting in this codebase, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/bluemarblepayroll/acts_as_hashable/blob/master/CODE_OF_CONDUCT.md).
+
 ## License
 
 This project is MIT Licensed.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/acts_as_hashable.gemspec

@@ -14,15 +14,30 @@ 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.1'
+  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', '~> 13.0')
   s.add_development_dependency('rspec')
-  s.add_development_dependency('rubocop', '~> 0.59.2')
+  s.add_development_dependency('rubocop', '~> 0.63.1')
+  s.add_development_dependency('simplecov', '~>0.16.1')
+  s.add_development_dependency('simplecov-console', '~>0.4.2')
 end

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'acts_as_hashable'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require 'pry'
+Pry.start

data/lib/acts_as_hashable.rb

@@ -7,4 +7,27 @@
 # LICENSE file in the root directory of this source tree.
 #
 
-require_relative 'acts_as_hashable/acts_as_hashable'
+require 'caution'
+require 'forwardable'
+
+require_relative 'acts_as_hashable/factory'
+require_relative 'acts_as_hashable/hash_refinements'
+require_relative 'acts_as_hashable/type_factory'
+require_relative 'acts_as_hashable/hashable'
+
+module ActsAsHashable
+  # This module adds the class-level method that marks a class as hashable.
+  module DslHook
+    def acts_as_hashable
+      extend ::ActsAsHashable::Hashable
+    end
+
+    def acts_as_hashable_factory
+      extend ActsAsHashable::Factory
+    end
+  end
+end
+
+Object.class_eval do
+  extend ::ActsAsHashable::DslHook
+end

data/lib/acts_as_hashable/factory.rb

@@ -0,0 +1,66 @@
+# 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 serves as a singleton that can make mapped acts_as_hashable components.
+  # It is important to note that these components *must* be acts_as_hashable objects.
+  # In order to use you just have to subclass this class and implement
+  # a method called 'registry', such as:
+  #   def registry
+  #     {
+  #       'Table': Table,
+  #       'Text': Text
+  #     }
+  #   end
+  # You can also use the 'register' DSL:
+  #   register 'some_class_name', SomeClassName
+  #   register 'some_class_name', '', SomeClassName
+  # or:
+  #   register 'some_class_name', ->(_key) { SomeClassName }
+  module Factory
+    extend Forwardable
+
+    def_delegators :factory, :array, :make
+
+    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
+      @registry ||= {}
+    end
+
+    def materialize_registry
+      @registry.map do |k, v|
+        value = v.is_a?(Proc) ? v.call(k) : v
+        [k, value]
+      end.to_h
+    end
+
+    def type_key(key)
+      @typed_with = key
+    end
+
+    def typed_with
+      @typed_with || TypeFactory::DEFAULT_TYPE_KEY
+    end
+
+    private
+
+    def factory
+      @factory ||= TypeFactory.new(materialize_registry, typed_with)
+    end
+  end
+end

data/lib/acts_as_hashable/hash_refinements.rb

@@ -0,0 +1,20 @@
+# 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
+  # 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
+    refine Hash do
+      def symbolize_keys
+        map { |k, v| [k.to_sym, v] }.to_h
+      end
+    end
+  end
+end

data/lib/acts_as_hashable/hashable.rb

@@ -11,24 +11,62 @@ module ActsAsHashable
   # This class contains the main set of class-level methods that can be used by
   # hashable classes.
   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|
+          args = (object || {}).symbolize_keys
+
+          if args.keys.any?
+            context.new(**args)
+          else
+            context.new
+          end
+        end
+      },
+      {
+        condition: ->(context, object, _nullable) { object.is_a?(context) },
+        converter: ->(_context, object, _nullable) { object }
+      },
+      {
+        condition: ->(_context, object, nullable) { object.nil? && nullable },
+        converter: ->(_context, _object, _nullable) { nil }
+      },
+      {
+        condition: ->(_context, object, nullable) { object.nil? && !nullable },
+        converter: ->(context, _object, _nullable) { context.new }
+      }
+    ].freeze
+
+    private_constant :HASHABLE_HYDRATORS
+
     def array(object, nullable: true)
       objects = object.is_a?(Hash) ? [object] : Array(object)
 
-      objects.select { |o| !!o }.map { |o| make(o, nullable: nullable) }
+      objects.reject { |o| o.is_a?(FalseClass) || o.nil? }
+             .map { |o| make(o, nullable: nullable) }
     end
 
     def make(object, nullable: true)
-      if object.is_a?(Hash)
-        new(**::ActsAsHashable::Utilities.symbolize_keys(object))
-      elsif object.is_a?(self)
-        object
-      elsif object.nil? && nullable
-        nil
-      elsif object.nil? && !nullable
-        new
-      else
-        raise "Cannot create hashable object with class name: #{object.class.name}"
+      HASHABLE_HYDRATORS.each do |hydrator|
+        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

@@ -0,0 +1,46 @@
+# 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
+  # A TypeFactory object understands how to build objects using a special designated 'type' key.
+  class TypeFactory
+    using HashRefinements
+
+    DEFAULT_TYPE_KEY = :type
+
+    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
+
+      freeze
+    end
+
+    def array(objects = [])
+      objects = objects.is_a?(Hash) ? [objects] : Array(objects)
+
+      objects.map do |object|
+        object.is_a?(Hash) ? make(object) : object
+      end
+    end
+
+    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
+
+      config_without_type = config.reject { |k| k == type_key }
+
+      object_class.new(config_without_type)
+    end
+  end
+end

data/lib/acts_as_hashable/version.rb

@@ -8,5 +8,5 @@
 #
 
 module ActsAsHashable
-  VERSION = '1.0.3'
+  VERSION = '1.2.0-alpha'
 end

metadata

@@ -1,15 +1,85 @@
 --- !ruby/object:Gem::Specification
 name: acts_as_hashable
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.2.0.pre.alpha
 platform: ruby
 authors:
 - Matthew Ruggio
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2018-09-28 00:00:00.000000000 Z
+date: 2020-06-09 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
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -30,14 +100,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.59.2
+        version: 0.63.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.59.2
+        version: 0.63.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
 description: |2
       This is a small library that helps increase the pliability of object constructor signatures.
       Instead of instantiating via the constructor, this library can install helper factory
@@ -51,25 +149,33 @@ files:
 - ".editorconfig"
 - ".gitignore"
 - ".rubocop.yml"
-- ".rubocop_todo.yml"
 - ".ruby-version"
 - ".travis.yml"
+- 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/acts_as_hashable.rb
+- lib/acts_as_hashable/factory.rb
+- lib/acts_as_hashable/hash_refinements.rb
 - lib/acts_as_hashable/hashable.rb
-- lib/acts_as_hashable/utilities.rb
+- lib/acts_as_hashable/type_factory.rb
 - lib/acts_as_hashable/version.rb
-- spec/acts_as_hashable_spec.rb
-- spec/examples.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:
@@ -78,18 +184,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.1
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.3
+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
+test_files: []

data/.rubocop_todo.yml

@@ -1,50 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2018-09-27 15:44:50 -0500 using RuboCop version 0.59.2.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 5
-# Configuration parameters: CountComments, ExcludedMethods.
-# ExcludedMethods: refine
-Metrics/BlockLength:
-  Max: 128
-
-# Offense count: 1
-Metrics/CyclomaticComplexity:
-  Max: 7
-
-# Offense count: 1
-# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
-# URISchemes: http, https
-Metrics/LineLength:
-  Max: 105
-
-# Offense count: 1
-# Configuration parameters: CountComments, ExcludedMethods.
-Metrics/MethodLength:
-  Max: 11
-
-# Offense count: 1
-Metrics/PerceivedComplexity:
-  Max: 8
-
-# Offense count: 1
-Style/DoubleNegation:
-  Exclude:
-    - 'lib/acts_as_hashable/hashable.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: InverseMethods, InverseBlocks.
-Style/InverseMethods:
-  Exclude:
-    - 'lib/acts_as_hashable/hashable.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/RescueModifier:
-  Exclude:
-    - 'lib/acts_as_hashable/utilities.rb'

data/Gemfile.lock

@@ -1,50 +0,0 @@
-PATH
-  remote: .
-  specs:
-    acts_as_hashable (1.0.3)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    ast (2.4.0)
-    diff-lcs (1.3)
-    jaro_winkler (1.5.1)
-    parallel (1.12.1)
-    parser (2.5.1.2)
-      ast (~> 2.4.0)
-    powerpack (0.1.2)
-    rainbow (3.0.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.59.2)
-      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.0, >= 1.0.1)
-    ruby-progressbar (1.10.0)
-    unicode-display_width (1.4.0)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  acts_as_hashable!
-  rspec
-  rubocop (~> 0.59.2)
-
-BUNDLED WITH
-   1.16.3

data/lib/acts_as_hashable/acts_as_hashable.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_relative 'utilities'
-require_relative 'hashable'
-
-module ActsAsHashable
-  # This module adds the class-level method that marks a class as hashable.
-  module DslHook
-    def acts_as_hashable
-      extend ::ActsAsHashable::Hashable
-    end
-  end
-end
-
-Object.class_eval do
-  extend ::ActsAsHashable::DslHook
-end

data/lib/acts_as_hashable/utilities.rb

@@ -1,34 +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.
-#
-
-module ActsAsHashable
-  # Some extra functions that are either ancillary to the main domain or polyfill other
-  # mainstream imnplementations.
-  class Utilities
-    class << self
-      # https://apidock.com/rails/Hash/symbolize_keys
-      def symbolize_keys(hash)
-        transform_keys(hash) { |key| key.to_sym rescue key }
-      end
-
-      # https://apidock.com/rails/v4.2.7/Hash/transform_keys
-      def transform_keys(hash)
-        return enum_for(:transform_keys) unless block_given?
-
-        result = {}
-
-        hash.keys.each do |key|
-          result[yield(key)] = hash[key]
-        end
-
-        result
-      end
-    end
-  end
-end

data/spec/acts_as_hashable_spec.rb

@@ -1,163 +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 './lib/acts_as_hashable'
-require './spec/examples'
-
-describe ActsAsHashable do
-  context '#make' do
-    context 'with a hash constructor interface' do
-      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 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 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,62 +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