value_semantics 3.5.0 → 3.6.0

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,44 @@
+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)
+        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.5.0"
+  VERSION = "3.6.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: value_semantics
 version: !ruby/object:Gem::Version
-  version: 3.5.0
+  version: 3.6.0
 platform: ruby
 authors:
 - Tom Dalling
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-17 00:00:00.000000000 Z
+date: 2020-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -122,6 +122,34 @@ dependencies:
     - - ">="
       - !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  "
@@ -135,7 +163,22 @@ files:
 - LICENSE.txt
 - README.md
 - 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
 homepage: https://github.com/tomdalling/value_semantics
 licenses:
@@ -143,7 +186,7 @@ licenses:
 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.5.0/README.md
+  documentation_uri: https://github.com/tomdalling/value_semantics/blob/v3.6.0/README.md
   source_code_uri: https://github.com/tomdalling/value_semantics
 post_install_message: 
 rdoc_options: []