value_semantics 3.2.1 → 3.6.1

data/lib/value_semantics/monkey_patched.rb

@@ -0,0 +1,3 @@
+require 'value_semantics'
+
+ValueSemantics.monkey_patch!

data/lib/value_semantics/range_of.rb

@@ -0,0 +1,18 @@
+module ValueSemantics
+  class RangeOf
+    attr_reader :subvalidator
+
+    def initialize(subvalidator)
+      @subvalidator = subvalidator
+    end
+
+    def ===(obj)
+      return false unless Range === obj
+
+      # begin or end can be nil, if the range is beginless or endless
+      [obj.begin, obj.end].compact.all? do |element|
+        subvalidator === element
+      end
+    end
+  end
+end

data/lib/value_semantics/recipe.rb

@@ -0,0 +1,17 @@
+module ValueSemantics
+  #
+  # Contains all the configuration necessary to bake a ValueSemantics module
+  #
+  # @see ValueSemantics.bake_module
+  # @see ClassMethods#value_semantics
+  # @see DSL.run
+  #
+  class Recipe
+    attr_reader :attributes
+
+    def initialize(attributes:)
+      @attributes = attributes
+      freeze
+    end
+  end
+end

data/lib/value_semantics/struct.rb

@@ -0,0 +1,19 @@
+module ValueSemantics
+  #
+  # ValueSemantics equivalent of the Struct class from the Ruby standard
+  # library
+  #
+  class Struct
+    #
+    # Creates a new Class with ValueSemantics mixed in
+    #
+    # @yield a block containing ValueSemantics DSL
+    # @return [Class] the newly created class
+    #
+    def self.new(&block)
+      klass = Class.new
+      klass.include(ValueSemantics.for_attributes(&block))
+      klass
+    end
+  end
+end

data/lib/value_semantics/value_object_coercer.rb

@@ -0,0 +1,48 @@
+module ValueSemantics
+  #
+  # A coercer for converting hashes into instances of value classes
+  #
+  # The coercer will coerce hash-like values into an instance of the value
+  # class, using the hash for attribute values. It will return non-hash-like
+  # values unchanged. It will also return hash-like values unchanged if they do
+  # not contain all required attributes of the value class.
+  #
+  class ValueObjectCoercer
+    attr_reader :value_class
+
+    def initialize(value_class)
+      @value_class = value_class
+    end
+
+    def call(obj)
+      attrs = coerce_to_attr_hash(obj)
+      if attrs
+        value_class.new(attrs)
+      else
+        obj
+      end
+    end
+
+    private
+      NOT_FOUND = Object.new.freeze
+
+      def coerce_to_attr_hash(obj)
+        # TODO: this coerces nil to an empty hash, which is probably not ideal.
+        # It should not coerce nil so that Either(X, nil) validator works as
+        # expected. This is a backwards-incomptible change, so save it for a
+        # major version bump
+        return nil unless obj.respond_to?(:to_h)
+        obj_hash = obj.to_h
+
+        {}.tap do |attrs|
+          value_class.value_semantics.attributes.each do |attr_def|
+            name = attr_def.name
+            value = obj_hash.fetch(name) do
+              obj_hash.fetch(name.to_s, NOT_FOUND)
+            end
+            attrs[name] = value unless value.equal?(NOT_FOUND)
+          end
+        end
+      end
+  end
+end

data/lib/value_semantics/version.rb

@@ -1,3 +1,3 @@
 module ValueSemantics
-  VERSION = "3.2.1"
+  VERSION = "3.6.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: value_semantics
 version: !ruby/object:Gem::Version
-  version: 3.2.1
+  version: 3.6.1
 platform: ruby
 authors:
 - Tom Dalling
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2020-07-11 00:00:00.000000000 Z
+date: 2021-06-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: super_diff
+  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: mutant-rspec
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +108,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: eceval
+  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: benchmark-ips
+  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: allocation_tracer
+  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'
 description: "\n    Generates modules that provide conventional value semantics for
   a given set of attributes.\n    The behaviour is similar to an immutable `Struct`
   class,\n    plus extensible, lightweight validation and coercion.\n  "
@@ -103,23 +159,35 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
 - CHANGELOG.md
-- Gemfile
 - LICENSE.txt
 - README.md
-- bin/console
-- bin/setup
-- bin/test
 - lib/value_semantics.rb
+- lib/value_semantics/anything.rb
+- lib/value_semantics/array_coercer.rb
+- lib/value_semantics/array_of.rb
+- lib/value_semantics/attribute.rb
+- lib/value_semantics/bool.rb
+- lib/value_semantics/class_methods.rb
+- lib/value_semantics/dsl.rb
+- lib/value_semantics/either.rb
+- lib/value_semantics/hash_coercer.rb
+- lib/value_semantics/hash_of.rb
+- lib/value_semantics/instance_methods.rb
+- lib/value_semantics/monkey_patched.rb
+- lib/value_semantics/range_of.rb
+- lib/value_semantics/recipe.rb
+- lib/value_semantics/struct.rb
+- lib/value_semantics/value_object_coercer.rb
 - lib/value_semantics/version.rb
-- value_semantics.gemspec
 homepage: https://github.com/tomdalling/value_semantics
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/tomdalling/value_semantics/issues
+  changelog_uri: https://github.com/tomdalling/value_semantics/blob/master/CHANGELOG.md
+  documentation_uri: https://github.com/tomdalling/value_semantics/blob/v3.6.1/README.md
+  source_code_uri: https://github.com/tomdalling/value_semantics
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -135,8 +203,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: Makes value classes, with lightweight validation and coercion.

data/.gitignore

@@ -1,12 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status

data/.rspec

@@ -1,2 +0,0 @@
---format documentation
---color

data/.travis.yml

@@ -1,25 +0,0 @@
-language: ruby
-script: bin/test
-
-# test old Ruby versions WITHOUT mutation testing
-rvm:
-  - 2.3.8
-  - 2.4.10
-  - 2.5.8
-  - 2.6.6
-env: MUTATION_TEST=false
-
-# test the latest Ruby version WITH mutation testing
-matrix:
-  include:
-  - rvm: 2.7.1
-    env: MUTATION_TEST=true
-
-# deploy gem on tagged commits, on the latest Ruby version only
-deploy:
-  provider: rubygems
-  on:
-    tags: true
-    env: MUTATION_TEST=true
-  api_key:
-    secure: nL74QuUczEpA0qbhSBN2zjGdviWgKB3wR6vFvwervv1MZNWmwOQUYe99Oq9kPeyc8/x2MR/H6PQm5qbrk/WAfRede01WxlZ/EBUW+9CYGrxcBsGONx9IULO8A0I8/yN/YJHW2vjo3dfR66EwVsXTVWq8U63PRRcwJIyTqnIiUm2sxauMQoPRBbXG+pD9v/EJSn3ugpdtxp0lVYDn8LDKk5Ho4/wbpY4ML11XUJa9mz9CyR/GsAzdy5FTXaDMOwuWOVEx9cab7m4qPOBhmlJY4TrmooFpxTxRwChcvByjq1IboEd2M3RT5on7Q/xDTlHSOuT0OS8mnS2AocGT4a1gC+W/xOlghgEcN+xs2V5mfucR6+iUYlCy32uz1w3ey7T2X5xN4ubut09r1xLi7eu1NisAoAc+GOJ4TIxQNqkeRhY4X/fs8j7SMfOEMDr6pPxSLKZxgSvExt+IbdcZD/uQ7rTBQkadYCbc9MX5dHazBievmar3ZsFffbIf+n13FVDXsaPgRt7DlFM5dqGrEwVwt1jFRhdFuDCjkj4QWOLn7E1uY3XqgrqGvgUBlF8Znwc6qicW8zxV4SIWhqIzCOH6L9WIZGLHNq0remoCd9sq9Ter9av3jL+6UmZRRAr+JceeZfZmsYIXKomECzleM9FXMx7FXlpjJKOlf3JnrfeCTwI=

data/Gemfile

@@ -1,8 +0,0 @@
-source "https://rubygems.org"
-
-source 'https://oss:fLUos7k6c7Ak7zjhwbYphPJbwBk1Uuew@gem.mutant.dev' do
-  gem 'mutant-license'
-end
-
-# Specify your gem's dependencies in the gemspec
-gemspec

data/bin/console

@@ -1,14 +0,0 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "value_semantics"
-
-# 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.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start(__FILE__)

data/bin/setup

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here

data/bin/test

@@ -1,15 +0,0 @@
-#!/bin/bash
-set -ue
-
-MUTANT_PATTERN=${1:-ValueSemantics*}
-
-# if $MUTATION_TEST is false, just run RSpec
-if [[ "${MUTATION_TEST:-true}" == "false" ]] ; then
-    bundle exec rspec
-else
-    bundle exec mutant \
-        --include lib \
-        --require value_semantics \
-        --use rspec "$MUTANT_PATTERN" \
-        --ignore-subject "ValueSemantics::Struct.new" # causes unfixable failure I don't want to deal with
-fi

data/value_semantics.gemspec

@@ -1,34 +0,0 @@
-# coding: utf-8
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "value_semantics/version"
-
-Gem::Specification.new do |spec|
-  spec.name          = "value_semantics"
-  spec.version       = ValueSemantics::VERSION
-  spec.authors       = ["Tom Dalling"]
-  spec.email         = [["tom", "@", "tomdalling.com"].join]
-
-  spec.summary       = %q{Makes value classes, with lightweight validation and coercion.}
-  spec.description   = %q{
-    Generates modules that provide conventional value semantics for a given set of attributes.
-    The behaviour is similar to an immutable `Struct` class,
-    plus extensible, lightweight validation and coercion.
-  }
-  spec.homepage      = "https://github.com/tomdalling/value_semantics"
-  spec.license       = "MIT"
-
-  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features)/})
-  end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "bundler", ">= 1.15"
-  spec.add_development_dependency "rspec", "~> 3.7"
-  spec.add_development_dependency "mutant-rspec"
-  spec.add_development_dependency "yard"
-  spec.add_development_dependency "byebug"
-  spec.add_development_dependency "gem-release"
-end