shallow_attributes 0.9.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: eae949ec12824705349bf498a92b2f524bd912a0
-  data.tar.gz: 1d3a7b3754419370e910cd6b90978425ff12010b
+  metadata.gz: 266928421c7c866fce01375d6046ed426d55a26b
+  data.tar.gz: 6bb003cb52f7617a42b2ba881f01dab7f9feca41
 SHA512:
-  metadata.gz: 109b2b4f4e0f699c1d4ba567c988ddc6da547e7be22b10f063b347f1489fc1f1a6c81325822ca7427ce7bca7dc6f3a7b1c1ecafb2609ab0cf0099023eb4adf8b
-  data.tar.gz: 32b707b41127ab624d0566a6d0fbbb455326c0b36085daacf8a71d0d6d1685d5a3e63c9b9c8deafad65dbb5f01ef44a8305969f0bd513a57837fc5655bf91489
+  metadata.gz: 6bc35f1b034ed265bc43a7d6579a562966ed55a9533ae56fe02ce9a9253b902a8f4a145893265974ad341e4db01e7e83e18fb414c27cc8b52713a0c8cbe2d762
+  data.tar.gz: ef3fcde22033a7aedacc715473444c3bde6b0938f26446ddeb8f592cbb42fe773122c1bb70916d8f576b6e18e7bb4194620dda3bdb5bbfa9b46f9b77267611ff

data/.travis.yml

@@ -3,8 +3,6 @@ sudo: false
 cache: bundler
 before_install: gem install bundler -v 1.11.2
 rvm:
-  - 2.0.0
-  - 2.1.9
   - 2.2.5
   - 2.3.1
   - 2.4.0

data/Gemfile

@@ -8,3 +8,4 @@ if !ENV['TRAVIS']
 end
 
 gem 'coveralls', require: false
+gem 'json', '1.8.5'

data/README.md

@@ -1,4 +1,5 @@
 # ShallowAttributes
+
 [![Build Status](https://travis-ci.org/davydovanton/shallow_attributes.svg?branch=master)](https://travis-ci.org/davydovanton/shallow_attributes)
 [![Code Climate](https://codeclimate.com/github/davydovanton/shallow_attributes/badges/gpa.svg)](https://codeclimate.com/github/davydovanton/shallow_attributes)
 [![Coverage Status](https://coveralls.io/repos/github/davydovanton/shallow_attributes/badge.svg?branch=master)](https://coveralls.io/github/davydovanton/shallow_attributes?branch=master)
@@ -14,13 +15,13 @@ or [attrio][attrio-link]. However, the disadvantage of these gems is performance
 of `ShallowAttributes` is to provide a simple solution which is similar to the `Virtus` API, simple, fast,
 understandable and extendable.
 
-This is [the performance benchmark][performance-benchmark] of ShallowAttributes compared to virtus gems.
+This is [the performance benchmark][performance-benchmark] of ShallowAttributes compared to Virtus gems.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-```ruby
+``` ruby
 gem 'shallow_attributes'
 ```
 
@@ -33,20 +34,25 @@ Or install it yourself as:
     $ gem install shallow_attributes
 
 ## Examples
+
 ### Table of contents
+
 * [Using ShallowAttributes with Classes](#using-shallowattributes-with-classes)
 * [Default Values](#default-values)
+* [Mandatory Attributes](#mandatory-attributes)
 * [Embedded Value](#embedded-value)
 * [Custom Coercions](#custom-coercions)
 * [Collection Member Coercions](#collection-member-coercions)
 * [Note about Member Coercions](#important-note-about-member-coercions)
 * [Overriding setters](#overriding-setters)
-* [ActiveModel validation](#activemodel-validation)
+* [ActiveModel compatibility](#activemodel-compatibility)
+* [Dry-types](#dry-types)
 
 ### Using ShallowAttributes with Classes
+
 You can create classes extended with Virtus and define attributes:
 
-```ruby
+``` ruby
 class User
   include ShallowAttributes
 
@@ -83,6 +89,31 @@ super_user = SuperUser.new
 user.age = nil  # => 0
 ```
 
+ShallowAttributes doesn't make any assumptions about base classes. There is no need to define
+default attributes, or even mix ShallowAttributes into the base class:
+
+``` ruby
+require 'active_model'
+
+class Form
+  extend ActiveModel::Naming
+  extend ActiveModel::Translation
+  include ActiveModel::Conversion
+  include ShallowAttributes
+
+  def persisted?
+    false
+  end
+end
+
+class SearchForm < Form
+  attribute :name, String
+end
+
+form = SearchForm.new(name: 'Anton')
+form.name # => "Anton"
+```
+
 ### Default Values
 
 ``` ruby
@@ -103,6 +134,8 @@ class Page
   # default from a method name as symbol
   attribute :editor_title, String,  default: :default_editor_title
 
+  private
+
   def default_editor_title
     published ? title : "UNPUBLISHED: #{title}"
   end
@@ -120,6 +153,22 @@ page.reset_attribute(:views)  # => 0
 page.views                    # => 0
 ```
 
+### Mandatory attributes
+You can provide `present: true` option for any attribute that will prevent class from initialization
+if this attribute was not provided:
+
+``` ruby
+class CreditCard
+  include ShallowAttributes
+  attribute :number, Integer, present: true
+  attribute :owner, String, present: true
+end
+
+card = CreditCard.new(number: 1239342)
+# => ShallowAttributes::MissingAttributeError: Mandatory attribute "owner" was not provided
+```
+
+
 ### Embedded Value
 
 ``` ruby
@@ -260,7 +309,8 @@ user.attributes
 
 ### IMPORTANT note about member coercions
 
-ShallowAttributes performs coercions only when a value is being assigned. If you mutate the value later on using its own interfaces then coercion won't be triggered.
+ShallowAttributes performs coercions only when a value is being assigned. If you mutate the value
+later on using its own interfaces then coercion won't be triggered.
 
 Here's an example:
 
@@ -310,7 +360,52 @@ user = User.new(name: "Godzilla")
 user.name # => 'Can't tell'
 ```
 
-### ActiveModel validation
+### ActiveModel compatibility
+
+ShallowAttributes is fully compatible with ActiveModel.
+
+#### Form object
+
+``` ruby
+require 'active_model'
+
+class SearchForm
+  extend ActiveModel::Naming
+  extend ActiveModel::Translation
+  include ActiveModel::Conversion
+  include ShallowAttributes
+
+  attribute :name, String
+  attribute :service_ids, Array, of: Integer
+  attribute :archived, 'Boolean', default: false
+
+  def persisted?
+    false
+  end
+
+  def results
+    # ...
+  end
+end
+
+class SearchesController < ApplicationController
+  def index
+    search_params = params.require(:search_form).permit(...)
+    @search_form = SearchForm.new(search_params)
+  end
+end
+```
+
+``` erb
+<h1>Search</h1>
+<%= form_for @search_form do |f| %>
+  <%= f.text_field :name %>
+  <%= f.collection_check_boxes :service_ids, Service.all, :id, :name %>
+  <%= f.select :archived, [['Archived', true], ['Not Archived', false]] %>
+<% end %>
+```
+
+#### Validations
 
 ``` ruby
 require 'active_model'
@@ -329,6 +424,26 @@ user.scream = 'hello world!'
 user.valid? # => true
 ```
 
+### Dry-types
+You can use dry-types objects as a type for your attribute:
+```ruby
+module Types
+  include Dry::Types.module
+end
+
+class User
+  include ShallowAttributes
+
+  attribute :name, Types::Coercible::String
+  attribute :age, Types::Coercible::Int
+  attribute :birthday, DateTime
+end
+
+user = User.new(name: nil, age: 0)
+user.name # => ''
+user.age # => 0
+```
+
 ## Ruby version support
 
 ShallowAttributes is [known to work correctly][travis-link] with the following rubies:
@@ -352,7 +467,6 @@ to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
-
 [doc-link]: http://www.rubydoc.info/github/davydovanton/shallow_attributes/master
 [virtus-link]: https://github.com/solnic/virtus
 [fast-attributes-link]: https://github.com/applift/fast_attributes

data/bench/allocation.rb

@@ -0,0 +1,56 @@
+require 'memory_profiler'
+require 'shallow_attributes'
+
+hash = { addresses: [ { street: 'Street 1/2', city: { name: 'NYC' } }, { street: 'Street 3/2', city: { name: 'Moscow' } } ] }
+class City
+  include ShallowAttributes
+  attribute :name, String
+  attribute :size, Integer, default: 9000
+end
+class Address
+  include ShallowAttributes
+  attribute :street,  String
+  attribute :zipcode, String, default: '111111'
+  attribute :city,    City
+end
+class Person
+  include ShallowAttributes
+  attribute :name,      String
+  attribute :address,   Address
+  attribute :addresses, Array, of: Address
+end
+report = MemoryProfiler.report { 1_000.times { Person.new(hash) } }
+
+puts report.pretty_print
+
+# allocated memory by gem
+# -----------------------------------
+#    6830520  shallow_attributes/lib
+#
+# allocated memory by gem
+# -----------------------------------
+#    6310752  shallow_attributes/lib
+#
+# allocated memory by gem
+# -----------------------------------
+#    5790752  shallow_attributes/lib
+#
+# allocated memory by gem
+# -----------------------------------
+#    5150752  shallow_attributes/lib
+#
+# allocated memory by gem
+# -----------------------------------
+#    4950752  shallow_attributes/lib
+#
+# allocated memory by gem
+# -----------------------------------
+#    4550752  shallow_attributes/lib
+#
+# allocated memory by gem
+# -----------------------------------
+#    4550520  shallow_attributes/lib
+#
+# allocated memory by gem
+# -----------------------------------
+#    4470752  shallow_attributes/lib

data/lib/shallow_attributes/class_methods.rb

@@ -19,7 +19,7 @@ module ShallowAttributes
       end
     end
 
-    # Returns hash which contain default values for each attribute
+    # Returns hash that contains default values for each attribute
     #
     # @private
     #
@@ -30,6 +30,17 @@ module ShallowAttributes
       @default_values ||= {}
     end
 
+    # Returns hash that contains mandatory attributes
+    #
+    # @private
+    #
+    # @return [Hash] hash with mandatory attributes
+    #
+    # @since 0.10.0
+    def mandatory_attributes
+      @mandatory_attributes ||= {}
+    end
+
     # Returns all class attributes.
     #
     # @example Create new User instance
@@ -58,6 +69,7 @@ module ShallowAttributes
     # @option options [Object] :default default value for attribute
     # @option options [Class] :of class of array elems
     # @option options [boolean] :allow_nil cast `nil` to integer or float
+    # @option options [boolean] :present raise error if attribute was not provided
     #
     # @example Create new User instance
     #   class User
@@ -75,6 +87,7 @@ module ShallowAttributes
       options[:default] ||= [] if type == Array
 
       default_values[name] = options.delete(:default)
+      mandatory_attributes[name] = options.delete(:present)
 
       initialize_setter(name, type, options)
       initialize_getter(name)
@@ -94,12 +107,14 @@ module ShallowAttributes
     #
     # @since 0.1.0
     def initialize_setter(name, type, options)
+      type_class = dry_type?(type) ? type.class : type
+
       module_eval <<-EOS, __FILE__, __LINE__ + 1
         def #{name}=(value)
-          @#{name} = if value.is_a?(#{type}) && !value.is_a?(Array)
+          @#{name} = if value.is_a?(#{type_class}) && !value.is_a?(Array)
             value
           else
-            ShallowAttributes::Type.coerce(#{type}, value, #{options})
+            #{type_casting(type, options)}
           end
 
           @attributes[:#{name}] = @#{name}
@@ -119,5 +134,42 @@ module ShallowAttributes
     def initialize_getter(name)
       attr_reader name
     end
+
+    private
+
+    DRY_TYPE_CLASS = 'Dry::Types'.freeze
+
+    # Check type with dry-type
+    #
+    # @private
+    #
+    # @param [Class] type the class of type
+    #
+    # @return [Bool]
+    #
+    # @since 0.2.0
+    def dry_type?(type)
+      type.class.name.match(DRY_TYPE_CLASS)
+    end
+
+    # Returns string for type casting
+    #
+    # @private
+    #
+    # @param [Class] type the class of type
+    # @param [Hash] options the options
+    #
+    # @return [String]
+    #
+    # @since 0.2.0
+    def type_casting(type, options)
+      if dry_type?(type)
+        # yep, I know that it's terrible line but it was the easily
+        # way to type cast data with dry-types from class method in instance method
+        "ObjectSpace._id2ref(#{type.object_id})[value]"
+      else
+        "ShallowAttributes::Type.coerce(#{type}, value, #{options})"
+      end
+    end
   end
 end

data/lib/shallow_attributes/instance_methods.rb

@@ -6,7 +6,7 @@ module ShallowAttributes
   #
   # @since 0.1.0
   module InstanceMethods
-    # Lambda object for gettring attributes hash for specific
+    # Lambda object for getting attributes hash for a specific
     # value object.
     #
     # @private
@@ -14,7 +14,7 @@ module ShallowAttributes
     # @since 0.1.0
     TO_H_PROC = ->(value) { value.respond_to?(:to_hash) ? value.to_hash : value }
 
-    # Initialize instance object with specific attributes
+    # Initialize an instance object with specific attributes
     #
     # @param [Hash] attrs the attributes contained in the class
     #
@@ -37,11 +37,12 @@ module ShallowAttributes
       end
       define_attributes
       define_default_attributes
+      define_mandatory_attributes
     end
 
     # Returns hash of object attributes
     #
-    # @example Returns all user attributs
+    # @example Returns all user attributes
     #   class User
     #     include ShallowAttributes
     #     attribute :name, String
@@ -68,7 +69,7 @@ module ShallowAttributes
     # @since 0.1.0
     alias_method :to_hash, :attributes
 
-    # Mass-assignment attribut values
+    # Attribute values mass-assignment
     #
     # @param [Hash] attributes the attributes which will be assignment
     #
@@ -82,22 +83,24 @@ module ShallowAttributes
     #   user.attributes = { name: "Ben" }
     #   user.attributes # => { name: "Ben" }
     #
-    # @return [Hash] attibutes hash
+    # @return [Hash] attributes hash
     #
     # @since 0.1.0
     def attributes=(attributes)
-      @attributes.merge!(attributes)
+      attributes.each_pair do |key, value|
+        @attributes[key.to_sym] = value
+      end
       define_attributes
     end
 
-    # Reser specific attribute to defaul value.
+    # Reset specific attribute to default value.
     #
-    # @param [Symbol] attribute the attribute which will be resete
+    # @param [Symbol] attribute the attribute which will be reset
     #
-    # @example Reset name valus
+    # @example Reset name value
     #   class User
     #     include ShallowAttributes
-    #     attribute :name, String, defauil: 'Ben'
+    #     attribute :name, String, default: 'Ben'
     #   end
     #
     #   user = User.new(name: 'Anton')
@@ -115,13 +118,13 @@ module ShallowAttributes
     #
     # @private
     #
-    # @param [Hash] values the new attributes for current object
-    # @param [Hash] options
+    # @param [Hash] value the new attributes for current object
+    # @param [Hash] _options
     #
     # @example Use embedded values
     #   class User
     #     include ShallowAttributes
-    #     attribute :name, String, defauil: 'Ben'
+    #     attribute :name, String, default: 'Ben'
     #   end
     #
     #   class Post
@@ -140,14 +143,14 @@ module ShallowAttributes
       self
     end
 
-    # Equalate two value objects
+    # Compare values of two objects
     #
     # @param [Object] object the other object
     #
-    # @example Equalate two value objects
+    # @example Compare two value objects
     #   class User
     #     include ShallowAttributes
-    #     attribute :name, String, defauil: 'Ben'
+    #     attribute :name, String, default: 'Ben'
     #   end
     #
     #   user1 = User.new(name: 'Anton')
@@ -163,10 +166,10 @@ module ShallowAttributes
 
     # Inspect instance object
     #
-    # @example Equalate two value objects
+    # @example Inspect the object
     #   class User
     #     include ShallowAttributes
-    #     attribute :name, String, defauil: 'Ben'
+    #     attribute :name, String, default: 'Ben'
     #   end
     #
     #   user = User.new(name: 'Anton')
@@ -179,9 +182,9 @@ module ShallowAttributes
       "#<#{self.class}#{attributes.map{ |k, v| " #{k}=#{v.inspect}" }.join}>"
     end
 
-  private
+    private
 
-    # Defene default value for attributes.
+    # Define default values for attributes.
     #
     # @private
     #
@@ -195,7 +198,24 @@ module ShallowAttributes
       end
     end
 
-    # Defene attributes from `@attributes` instance value.
+    # Define mandatory attributes for object and raise exception
+    # if they were not provided
+    #
+    # @private
+    #
+    # @raise [MissingAttributeError] if attribute was not provided
+    #
+    # @return the object
+    #
+    # @since 0.10.0
+    def define_mandatory_attributes
+      mandatory_attributes.each do |key, value|
+        next unless @attributes[key].nil? && value
+        raise ShallowAttributes::MissingAttributeError, %(Mandatory attribute "#{key}" was not provided)
+      end
+    end
+
+    # Define attributes from `@attributes` instance value.
     #
     # @private
     #
@@ -208,13 +228,13 @@ module ShallowAttributes
       end
     end
 
-    # Retrns default value for specific attribute. Defaul values hash
-    # takes from class getter `default_values`.
+    # Returns default value for specific attribute. Default values hash
+    # is taken from class getter `default_values`.
     #
     # @private
     #
     # @return [nil] if default value not defined
-    # @return [Object] if default value defined
+    # @return [Object] if default value is defined
     #
     # @since 0.1.0
     def default_value_for(attribute)
@@ -224,7 +244,7 @@ module ShallowAttributes
       when Proc
         value.call(self, attribute)
       when Symbol, String
-        self.class.method_defined?(value) ? send(value) : value
+        respond_to?(value, true) ? send(value) : value
       else
         value
       end
@@ -240,5 +260,16 @@ module ShallowAttributes
     def default_values
       @default_values ||= self.class.default_values
     end
+
+    # Returns hash of mandatory class attributes
+    #
+    # @private
+    #
+    # @return [Hash]
+    #
+    # @since 0.10.0
+    def mandatory_attributes
+      @mandatory_attributes ||= self.class.mandatory_attributes
+    end
   end
 end

data/lib/shallow_attributes/type/array.rb

@@ -18,7 +18,7 @@ module ShallowAttributes
       #   ShallowAttributes::Type::Array.new.coerce([1, 2], String)
       #     # => ['1', '2']
       #
-      # @raise [InvalidValueError] if values is not Array
+      # @raise [InvalidValueError] if value is not an Array
       #
       # @return [Array]
       #
@@ -27,8 +27,16 @@ module ShallowAttributes
         unless values.is_a? ::Array
           raise ShallowAttributes::Type::InvalidValueError, %(Invalid value "#{values}" for type "Array")
         end
+        values.map! do |value|
+          ShallowAttributes::Type.coerce(item_klass(options[:of]), value)
+        end
+      end
+
+      private
 
-        values.map! { |value| ShallowAttributes::Type.coerce(options[:of], value) }
+      def item_klass(klass)
+        return klass unless klass.is_a? ::String
+        Object.const_get(klass)
       end
     end
   end

data/lib/shallow_attributes/type/boolean.rb

@@ -25,7 +25,7 @@ module ShallowAttributes
       # @private
       #
       # @param [Object] value
-      # @param [Hash] option
+      # @param [Hash] _options
       #
       # @example Convert integer to boolean value
       #   ShallowAttributes::Type::Boolean.new.coerce(1)
@@ -34,7 +34,7 @@ module ShallowAttributes
       #   ShallowAttributes::Type::Boolean.new.coerce(0)
       #     # => false
       #
-      # @raise [InvalidValueError] if values is not included in true and false arrays
+      # @raise [InvalidValueError] if value is not included in true and false arrays
       #
       # @return [boolean]
       #

data/lib/shallow_attributes/type/date_time.rb

@@ -1,3 +1,5 @@
+require 'date'
+
 module ShallowAttributes
   module Type
     # Abstract class for typecast object to DateTime type.
@@ -11,13 +13,13 @@ module ShallowAttributes
       # @private
       #
       # @param [Object] value
-      # @param [Hash] option
+      # @param [Hash] _options
       #
       # @example Convert integer to datetime value
       #   ShallowAttributes::Type::DateTime.new.coerce('Thu Nov 29 14:33:20 GMT 2001')
       #     # => '2001-11-29T14:33:20+00:00'
       #
-      # @raise [InvalidValueError] if values is not a sting
+      # @raise [InvalidValueError] if value is not a string
       #
       # @return [DateTime]
       #

data/lib/shallow_attributes/type/float.rb

@@ -1,6 +1,6 @@
 module ShallowAttributes
   module Type
-    # This class needs for cange object type to Float.
+    # This class is needed to change object type to Float.
     #
     # @abstract
     #
@@ -11,14 +11,14 @@ module ShallowAttributes
       # @private
       #
       # @param [Object] value
-      # @param [Hash] option
+      # @param [Hash] options
       # @option options [boolean] :allow_nil cast `nil` to integer or float
       #
       # @example Convert string to float value
       #   ShallowAttributes::Type::Float.new.coerce('2001')
       #     # => 2001.0
       #
-      # @raise [InvalidValueError] if values is invalid
+      # @raise [InvalidValueError] if value is invalid
       #
       # @return [Float]
       #

data/lib/shallow_attributes/type/integer.rb

@@ -1,6 +1,6 @@
 module ShallowAttributes
   module Type
-    # This class cange object to Integer.
+    # This class changes object to Integer.
     #
     # @abstract
     #
@@ -11,14 +11,14 @@ module ShallowAttributes
       # @private
       #
       # @param [Object] value
-      # @param [Hash] option
+      # @param [Hash] options
       # @option options [boolean] :allow_nil cast `nil` to integer or float
       #
       # @example Convert sting to integer value
       #   ShallowAttributes::Type::Integer.new.coerce('2001')
       #     # => 2001
       #
-      # @raise [InvalidValueError] if values is invalid
+      # @raise [InvalidValueError] if value is invalid
       #
       # @return [Integer]
       #

data/lib/shallow_attributes/type/string.rb

@@ -11,9 +11,9 @@ module ShallowAttributes
       # @private
       #
       # @param [Object] value
-      # @param [Hash] option
+      # @param [Hash] _options
       #
-      # @example Convert intger to string value
+      # @example Convert integer to string value
       #   ShallowAttributes::Type::String.new.coerce(2001)
       #     # => '2001'
       #

data/lib/shallow_attributes/type/time.rb

@@ -11,13 +11,13 @@ module ShallowAttributes
       # @private
       #
       # @param [Object] value
-      # @param [Hash] option
+      # @param [Hash] _options
       #
       # @example Convert string to Time value
       #   ShallowAttributes::Type::Time.new.coerce('Thu Nov 29 14:33:20 GMT 2001')
       #     # => '2001-11-29 14:33:20 +0000'
       #
-      # @raise [InvalidValueError] if values is not a sting or integer
+      # @raise [InvalidValueError] if value is not a sting or an integer
       #
       # @return [Time]
       #

data/lib/shallow_attributes/type.rb

@@ -7,11 +7,11 @@ require 'shallow_attributes/type/string'
 require 'shallow_attributes/type/time'
 
 module ShallowAttributes
-  # Namespace for standart type classes
+  # Namespace for standard type classes
   #
   # @since 0.1.0
   module Type
-    # Error class for ivalid value types
+    # Error class for invalid value types
     #
     # @since 0.1.0
     class InvalidValueError < TypeError
@@ -37,7 +37,7 @@ module ShallowAttributes
       # @private
       #
       # @param [Class] type the type class object
-      # @param [Object] value the value that should be submit to the necessary type
+      # @param [Object] value the value that should be coerced to the necessary type
       # @param [Hash] options the options to create a message with.
       # @option options [String] :of The type of array
       # @option options [boolean] :allow_nil cast `nil` to integer or float
@@ -63,7 +63,7 @@ module ShallowAttributes
       #
       # @private
       #
-      # @param [Class] type the type class object
+      # @param [Class] klass the type class object
       #
       # @example Returns Sting type class
       #   ShallowAttributes::Type.instance_for(String)

data/lib/shallow_attributes/version.rb

@@ -2,5 +2,5 @@ module ShallowAttributes
   # Defines the full version
   #
   # @since 0.1.0
-  VERSION = "0.9.2".freeze
+  VERSION = "0.9.3".freeze
 end

data/lib/shallow_attributes.rb

@@ -9,13 +9,18 @@ require 'shallow_attributes/version'
 module ShallowAttributes
   include InstanceMethods
 
+  # Error class for mandatory arguments that were not provided
+  #
+  # @since 0.10.0
+  class MissingAttributeError < TypeError; end
+
   # Including ShallowAttributes class methods to specific class
   #
   # @private
   #
   # @param [Class] base the class containing class methods
   #
-  # @return [Class] class for incluting ShallowAttributes gem
+  # @return [Class] class for including ShallowAttributes gem
   #
   # @since 0.1.0
   def self.included(base)

data/shallow_attributes.gemspec

@@ -22,4 +22,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 1.11"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "dry-types", "~> 0.11"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shallow_attributes
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.9.3
 platform: ruby
 authors:
 - Anton Davydov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-03-19 00:00:00.000000000 Z
+date: 2017-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: dry-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
 description: Attributes for Plain Old Ruby Objects
 email:
 - antondavydov.o@gmail.com
@@ -67,6 +81,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- bench/allocation.rb
 - lib/shallow_attributes.rb
 - lib/shallow_attributes/class_methods.rb
 - lib/shallow_attributes/instance_methods.rb
@@ -100,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.13
 signing_key: 
 specification_version: 4
 summary: Attributes for Plain Old Ruby Objects