dry-struct 0.6.0 → 1.4.0

data/lib/dry/struct/printer.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "dry/types/printer"
+
+module Dry
+  module Types
+    # @api private
+    class Printer
+      MAPPING[Struct::Sum] = :visit_struct_sum
+      MAPPING[Struct::Constructor] = :visit_struct_constructor
+
+      def visit_struct_sum(sum)
+        visit_sum_constructors(sum) do |constructors|
+          visit_options(EMPTY_HASH, sum.meta) do |opts|
+            yield "Struct::Sum<#{constructors}#{opts}>"
+          end
+        end
+      end
+
+      alias_method :visit_struct_constructor, :visit_constructor
+    end
+  end
+end

data/lib/dry/struct/struct_builder.rb

@@ -1,28 +1,42 @@
-require 'dry/types/compiler'
+# frozen_string_literal: true
+
+require "dry/struct/compiler"
 
 module Dry
   class Struct
     # @private
-    class StructBuilder < Dry::Types::Compiler
+    class StructBuilder < Compiler
       attr_reader :struct
 
       def initialize(struct)
-        super(Dry::Types)
+        super(Types)
         @struct = struct
       end
 
       # @param [Symbol|String] attr_name the name of the nested type
-      # @param [Dry::Struct,Dry::Types::Type::Array] type the superclass of the nested struct
+      # @param [Dry::Struct,Dry::Types::Type::Array,Undefined] type the superclass of the nested struct
       # @yield the body of the nested struct
       def call(attr_name, type, &block)
         const_name = const_name(type, attr_name)
         check_name(const_name)
 
-        new_type = Class.new(parent(type), &block)
+        builder = self
+        parent = parent(type)
+
+        new_type = ::Class.new(Undefined.default(parent, struct.abstract_class)) do
+          if Undefined.equal?(parent)
+            schema builder.struct.schema.clear
+          end
+
+          class_exec(&block)
+        end
+
         struct.const_set(const_name, new_type)
 
         if array?(type)
           type.of(new_type)
+        elsif optional?(type)
+          new_type.optional
         else
           new_type
         end
@@ -30,37 +44,46 @@ module Dry
 
       private
 
+      def type?(type)
+        type.is_a?(Types::Type)
+      end
+
       def array?(type)
-        type.is_a?(Types::Type) && type.primitive.equal?(Array)
+        type?(type) && !type.optional? && type.primitive.equal?(::Array)
+      end
+
+      def optional?(type)
+        type?(type) && type.optional?
       end
 
       def parent(type)
         if array?(type)
           visit(type.to_ast)
+        elsif optional?(type)
+          type.right
         else
-          type || default_superclass
+          type
         end
       end
 
-      def default_superclass
-        struct < Value ? Value : Struct
-      end
-
       def const_name(type, attr_name)
-        snake_name = if array?(type)
-                       Dry::Core::Inflector.singularize(attr_name)
-                     else
-                       attr_name
-                     end
-
-        Dry::Core::Inflector.camelize(snake_name)
+        snake_name =
+          if array?(type)
+            Core::Inflector.singularize(attr_name)
+          else
+            attr_name
+          end
+
+        Core::Inflector.camelize(snake_name)
       end
 
       def check_name(name)
-        raise(
-          Struct::Error,
-          "Can't create nested attribute - `#{struct}::#{name}` already defined"
-        ) if struct.const_defined?(name, false)
+        if struct.const_defined?(name, false)
+          raise(
+            Error,
+            "Can't create nested attribute - `#{struct}::#{name}` already defined"
+          )
+        end
       end
 
       def visit_constrained(node)
@@ -70,11 +93,11 @@ module Dry
 
       def visit_array(node)
         member, * = node
-        member
+        visit(member)
       end
 
-      def visit_definition(*)
-        default_superclass
+      def visit_nominal(*)
+        Undefined
       end
 
       def visit_constructor(node)

data/lib/dry/struct/sum.rb

@@ -1,4 +1,7 @@
-require 'dry/types/sum'
+# frozen_string_literal: true
+
+require "dry/types/sum"
+require "dry/types/printer"
 
 module Dry
   class Struct
@@ -6,6 +9,12 @@ module Dry
     # As opposed to Dry::Types::Sum::Constrained
     # this type tries no to coerce data first.
     class Sum < Dry::Types::Sum::Constrained
+      def call(input)
+        left.try_struct(input) do
+          right.try_struct(input) { super }
+        end
+      end
+
       # @param [Hash{Symbol => Object},Dry::Struct] input
       # @yieldparam [Dry::Types::Result::Failure] failure
       # @yieldreturn [Dry::Types::ResultResult]
@@ -23,12 +32,17 @@ module Dry
       # @return [Dry::Types::Sum]
       def |(type)
         if type.is_a?(Class) && type <= Struct || type.is_a?(Sum)
-          self.class.new(self, type)
+          Sum.new(self, type)
         else
           super
         end
       end
 
+      # @return [boolean]
+      def ===(value)
+        left === value || right === value
+      end
+
       protected
 
       # @private

data/lib/dry/struct/value.rb

@@ -1,14 +1,19 @@
-require 'ice_nine'
+# frozen_string_literal: true
+
+require "ice_nine"
+require "dry/core/deprecations"
 
 module Dry
   class Struct
+    extend Core::Deprecations[:'dry-struct']
+
     # {Value} objects behave like {Struct}s but *deeply frozen*
     # using [`ice_nine`](https://github.com/dkubb/ice_nine)
     #
     # @example
     #   class Location < Dry::Struct::Value
-    #     attribute :lat, Types::Strict::Float
-    #     attribute :lng, Types::Strict::Float
+    #     attribute :lat, Types::Float
+    #     attribute :lng, Types::Float
     #   end
     #
     #   loc1 = Location.new(lat: 1.23, lng: 4.56)
@@ -20,12 +25,16 @@ module Dry
     #
     # @see https://github.com/dkubb/ice_nine
     class Value < self
+      abstract
+
       # @param (see ClassInterface#new)
       # @return [Value]
       # @see https://github.com/dkubb/ice_nine
       def self.new(*)
-        IceNine.deep_freeze(super)
+        ::IceNine.deep_freeze(super)
       end
     end
+
+    deprecate_constant :Value
   end
 end

data/lib/dry/struct/version.rb

@@ -1,6 +1,8 @@
+# frozen_string_literal: true
+
 module Dry
   class Struct
     # @private
-    VERSION = '0.6.0'.freeze
+    VERSION = "1.4.0"
   end
 end

data/lib/dry/struct.rb

@@ -1,13 +1,16 @@
-require 'dry-types'
-require 'dry-equalizer'
-require 'dry/core/extensions'
-require 'dry/core/constants'
+# frozen_string_literal: true
 
-require 'dry/struct/version'
-require 'dry/struct/errors'
-require 'dry/struct/class_interface'
-require 'dry/struct/hashify'
-require 'dry/struct/struct_builder'
+require "dry/types"
+require "dry/core/equalizer"
+require "dry/core/extensions"
+require "dry/core/constants"
+require "dry/core/deprecations"
+
+require "dry/struct/version"
+require "dry/struct/errors"
+require "dry/struct/class_interface"
+require "dry/struct/hashify"
+require "dry/struct/struct_builder"
 
 module Dry
   # Constructor method for easily creating a {Dry::Struct}.
@@ -16,21 +19,21 @@ module Dry
   #   require 'dry-struct'
   #
   #   module Types
-  #     include Dry::Types.module
+  #     include Dry.Types()
   #   end
   #
-  #   Person = Dry.Struct(name: Types::Strict::String, age: Types::Strict::Int)
+  #   Person = Dry.Struct(name: Types::String, age: Types::Integer)
   #   matz = Person.new(name: "Matz", age: 52)
   #   matz.name #=> "Matz"
   #   matz.age #=> 52
   #
-  #   Test = Dry.Struct(expected: Types::Strict::String) { input(input.strict) }
+  #   Test = Dry.Struct(expected: Types::String) { schema(schema.strict) }
   #   Test[expected: "foo", unexpected: "bar"]
   #   #=> Dry::Struct::Error: [Test.new] unexpected keys [:unexpected] in Hash input
   def self.Struct(attributes = Dry::Core::Constants::EMPTY_HASH, &block)
     Class.new(Dry::Struct) do
       attributes.each { |a, type| attribute a, type }
-      instance_eval(&block) if block
+      module_eval(&block) if block
     end
   end
 
@@ -60,12 +63,12 @@ module Dry
   #   require 'dry-struct'
   #
   #   module Types
-  #     include Dry::Types.module
+  #     include Dry.Types()
   #   end
   #
   #   class Book < Dry::Struct
-  #     attribute :title, Types::Strict::String
-  #     attribute :subtitle, Types::Strict::String.optional
+  #     attribute :title, Types::String
+  #     attribute :subtitle, Types::String.optional
   #   end
   #
   #   rom_n_roda = Book.new(
@@ -82,18 +85,27 @@ module Dry
   #   refactoring.title #=> 'Refactoring'
   #   refactoring.subtitle #=> 'Improving the Design of Existing Code'
   class Struct
-    extend Dry::Core::Extensions
-    include Dry::Core::Constants
+    extend Core::Extensions
+    include Core::Constants
     extend ClassInterface
+    extend Core::Deprecations[:'dry-struct']
+
+    class << self
+      # override `Dry::Types::Builder#prepend`
+      define_method(:prepend, ::Module.method(:prepend))
+    end
+
+    autoload :Value, "dry/struct/value"
 
-    include Dry::Equalizer(:__attributes__)
+    include ::Dry::Equalizer(:__attributes__, inspect: false, immutable: true)
 
     # {Dry::Types::Hash::Schema} subclass with specific behaviour defined for
     # @return [Dry::Types::Hash::Schema]
-    defines :input
-    input Types['coercible.hash'].schema(EMPTY_HASH)
+    defines :schema
+    schema Types["coercible.hash"].schema(EMPTY_HASH)
 
-    @meta = EMPTY_HASH
+    defines :abstract_class
+    abstract
 
     # @!attribute [Hash{Symbol => Object}] attributes
     attr_reader :attributes
@@ -111,8 +123,8 @@ module Dry
     #
     # @example
     #   class Book < Dry::Struct
-    #     attribute :title, Types::Strict::String
-    #     attribute :subtitle, Types::Strict::String.optional
+    #     attribute :title, Types::String
+    #     attribute :subtitle, Types::String.optional
     #   end
     #
     #   rom_n_roda = Book.new(
@@ -122,7 +134,7 @@ module Dry
     #   rom_n_roda[:title] #=> 'Web Development with ROM and Roda'
     #   rom_n_roda[:subtitle] #=> nil
     def [](name)
-      @attributes.fetch(name) { raise MissingAttributeError.new(name) }
+      @attributes.fetch(name) { raise MissingAttributeError, name }
     end
 
     # Converts the {Dry::Struct} to a hash with keys representing
@@ -132,8 +144,8 @@ module Dry
     #
     # @example
     #   class Book < Dry::Struct
-    #     attribute :title, Types::Strict::String
-    #     attribute :subtitle, Types::Strict::String.optional
+    #     attribute :title, Types::String
+    #     attribute :subtitle, Types::String.optional
     #   end
     #
     #   rom_n_roda = Book.new(
@@ -142,12 +154,13 @@ module Dry
     #   )
     #   rom_n_roda.to_hash
     #     #=> {title: 'Web Development with ROM and Roda', subtitle: nil}
-    def to_hash
-      self.class.schema.keys.each_with_object({}) do |key, result|
-        result[key] = Hashify[self[key]] if attributes.key?(key)
+    def to_h
+      self.class.schema.each_with_object({}) do |key, result|
+        result[key.name] = Hashify[self[key.name]] if attributes.key?(key.name)
       end
     end
-    alias_method :to_h, :to_hash
+    alias_method :to_hash, :to_h
+    # deprecate :to_hash, :to_h, message: "Implicit convertion structs to hashes is deprecated. Use .to_h"
 
     # Create a copy of {Dry::Struct} with overriden attributes
     #
@@ -157,8 +170,8 @@ module Dry
     #
     # @example
     #   class Book < Dry::Struct
-    #     attribute :title, Types::Strict::String
-    #     attribute :subtitle, Types::Strict::String.optional
+    #     attribute :title, Types::String
+    #     attribute :subtitle, Types::String.optional
     #   end
     #
     #   rom_n_roda = Book.new(
@@ -170,7 +183,10 @@ module Dry
     #   rom_n_roda.new(subtitle: '3rd edition')
     #     #=> #<Book title="Web Development with ROM and Roda" subtitle="3rd edition">
     def new(changeset)
-      self.class[__attributes__.merge(changeset)]
+      new_attributes = self.class.schema.apply(changeset, skip_missing: true, resolve_defaults: false)
+      self.class.load(__attributes__.merge(new_attributes))
+    rescue Types::SchemaError, Types::MissingKeyError, Types::UnknownKeysError => e
+      raise Error, "[#{self}.new] #{e}"
     end
     alias_method :__new__, :new
 
@@ -178,10 +194,19 @@ module Dry
     def inspect
       klass = self.class
       attrs = klass.attribute_names.map { |key| " #{key}=#{@attributes[key].inspect}" }.join
-      "#<#{ klass.name || klass.inspect }#{ attrs }>"
+      "#<#{klass.name || klass.inspect}#{attrs}>"
+    end
+
+    if RUBY_VERSION >= "2.7"
+      # Pattern matching support
+      #
+      # @api private
+      def deconstruct_keys(_keys)
+        attributes
+      end
     end
   end
 end
 
-require 'dry/struct/value'
-require 'dry/struct/extensions'
+require "dry/struct/extensions"
+require "dry/struct/printer"

data/lib/dry-struct.rb

@@ -1 +1,3 @@
-require 'dry/struct'
+# frozen_string_literal: true
+
+require "dry/struct"

metadata

@@ -1,63 +1,49 @@
 --- !ruby/object:Gem::Specification
 name: dry-struct
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Piotr Solnica
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2018-10-24 00:00:00.000000000 Z
+date: 2021-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: dry-equalizer
+  name: dry-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: dry-types
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '0.5'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
 - !ruby/object:Gem::Dependency
-  name: dry-core
+  name: dry-types
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: ice_nine
   requirement: !ruby/object:Gem::Requirement
@@ -76,100 +62,91 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.5
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.5
-description: Typed structs and value objects.
+        version: '0'
+description: Typed structs and value objects
 email:
 - piotr.solnica@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- ".yardopts"
 - CHANGELOG.md
-- CONTRIBUTING.md
-- Gemfile
 - LICENSE
 - README.md
-- Rakefile
-- benchmarks/basic.rb
-- benchmarks/constrained.rb
-- bin/console
-- bin/setup
 - dry-struct.gemspec
 - lib/dry-struct.rb
 - lib/dry/struct.rb
 - lib/dry/struct/class_interface.rb
+- lib/dry/struct/compiler.rb
 - lib/dry/struct/constructor.rb
 - lib/dry/struct/errors.rb
 - lib/dry/struct/extensions.rb
 - lib/dry/struct/extensions/pretty_print.rb
 - lib/dry/struct/hashify.rb
+- lib/dry/struct/printer.rb
 - lib/dry/struct/struct_builder.rb
 - lib/dry/struct/sum.rb
 - lib/dry/struct/value.rb
 - lib/dry/struct/version.rb
-- log/.gitkeep
-homepage: https://github.com/dry-rb/dry-struct
+homepage: https://dry-rb.org/gems/dry-struct
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
   changelog_uri: https://github.com/dry-rb/dry-struct/blob/master/CHANGELOG.md
   source_code_uri: https://github.com/dry-rb/dry-struct
+  bug_tracker_uri: https://github.com/dry-rb/dry-struct/issues
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -178,16 +155,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
-summary: Typed structs and value objects.
+summary: Typed structs and value objects
 test_files: []

data/.gitignore

@@ -1,12 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.log
-
-.DS_Store

data/.rspec

@@ -1,2 +0,0 @@
---color
---require ./spec/spec_helper