smart_initializer 0.7.0 → 0.8.0

data/lib/smart_core/initializer/attribute/finalizer.rb

@@ -14,6 +14,7 @@ module SmartCore::Initializer::Attribute::Finalizer
     #
     # @api private
     # @since 0.1.0
+    # @version 0.8.0
     def create(finalization_approach)
       case finalization_approach
       when String, Symbol
@@ -21,11 +22,10 @@ module SmartCore::Initializer::Attribute::Finalizer
       when Proc
         AnonymousBlock.new(finalization_approach)
       else
-        # :nocov:
-        raise(SmartCore::Initializer::ArgumentError, <<~ERROR_MESSAGE)
-          Finalization approach should be a type of Proc, Symbol or String'
-        ERROR_MESSAGE
-        # :nocov:
+        raise(
+          SmartCore::Initializer::ArgumentError,
+          'Finalization approach object should be a type of Proc, Symbol or String'
+        )
       end
     end
   end

data/lib/smart_core/initializer/attribute/list.rb

@@ -15,6 +15,26 @@ class SmartCore::Initializer::Attribute::List
     @lock = SmartCore::Engine::Lock.new
   end
 
+  # @param attribute_name [Symbol]
+  # @return [SmartCore::Initializer::Atribute]
+  #
+  # @raise [SmartCore::Initializer::UndefinedAttributeError]
+  #
+  # @api private
+  # @since 0.8.0
+  def fetch(attribute_name)
+    thread_safe do
+      attributes.fetch(attribute_name)
+    rescue ::KeyError
+      raise(
+        ::SmartCore::Initializer::UndefinedAttributeError,
+        "Attribute with `#{attribute_name}` name is not defined in your constructor. " \
+        "Please, check your attribute definitions inside your class."
+      )
+    end
+  end
+  alias_method :[], :fetch
+
   # @param attribute [SmartCore::Initializer::Attribute]
   # @return [void]
   #

data/lib/smart_core/initializer/attribute/{parameters.rb → value/base.rb}

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # @api private
-# @since 0.1.0
-class SmartCore::Initializer::Attribute::Parameters
+# @since 0.8.0
+class SmartCore::Initializer::Attribute::Value::Base
   # @return [Hash<Symbol,Symbol>]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   PRIVACY_MODES = {
     public:    :public,
     protected: :protected,
@@ -16,93 +16,76 @@ class SmartCore::Initializer::Attribute::Parameters
   # @return [Symbol]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   DEFAULT_PRIVACY_MODE = PRIVACY_MODES[:public]
 
-  # @return [Boolean]
-  #
-  # @api private
-  # @since 0.1.0
-  DEFAULT_CAST_BEHAVIOUR = false
-
   # @return [Proc]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   DEFAULT_FINALIZER = proc { |value| value }.freeze
 
-  # @return [Hash]
+  # @return [NilClass]
   #
   # @api private
-  # @since 0.1.0
-  DEFAULT_DYNAMIC_OPTIONS = {}.freeze
+  # @since 0.8.0
+  DEFAULT_AS = nil
 
   # @return [Boolean]
   #
   # @api private
-  # @since 0.4.0
-  DEFAULT_READ_ONLY = true
-
-  # @return [NilClass]
-  #
-  # @api private
-  # @since 0.4.0
-  DEFAULT_AS = nil
+  # @since 0.8.0
+  DEFAULT_MUTABLE = false
 
   # @return [Symbol]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   attr_reader :name
 
   # @return [SmartCore::Initializer::TypeSystem::Interop]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   attr_reader :type
 
   # @return [Class<SmartCore::Initilizer::TypeSystem::Interop>]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   attr_reader :type_system
 
   # @return [Symbol]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   attr_reader :privacy
 
   # @return [SmartCore::Initializer::Attribute::Finalizer::AnonymousBlock]
   # @return [SmartCore::Initializer::Attribute::Finalizer::InstanceMethod]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   attr_reader :finalizer
 
   # @return [Boolean]
   #
   # @api private
-  # @since 0.1.0
+  # @since 0.8.0
   attr_reader :cast
   alias_method :cast?, :cast
 
-  # @return [Hash<Symbol,Any>]
-  #
-  # @api private
-  # @since 0.1.0
-  attr_reader :dynamic_options
-
   # @return [Boolean]
   #
   # @api private
-  # @since 0.4.0
-  attr_reader :read_only
+  # @since 0.8.0
+  attr_reader :mutable
+  alias_method :mutable?, :mutable
 
   # @return [String, Symbol, NilClass]
   #
   # @api private
-  # @since 0.4.0
+  # @since 0.8.0
   attr_reader :as
 
   # @param name [Symbol]
@@ -111,48 +94,35 @@ class SmartCore::Initializer::Attribute::Parameters
   # @param privacy [Symbol]
   # @param finalizer [SmartCore::Initializer::Attribute::AnonymousBlock/InstanceMethod]
   # @param cast [Boolean]
-  # @param read_only [Boolean]
+  # @param mutable [Boolean]
   # @param as [NilClass, Symbol, String]
-  # @param dynamic_options [Hash<Symbol,Any>]
-  #   - :default - default value (Proc value will be called)
   # @return [void]
   #
   # @api private
-  # @since 0.1.0
-  # @version 0.4.0
-  def initialize(name, type, type_system, privacy, finalizer, cast, read_only, as, dynamic_options)
+  # @since 0.8.0
+  def initialize(name, type, type_system, privacy, finalizer, cast, mutable, as)
     @name = name
     @type = type
     @type_system = type_system
     @privacy = privacy
     @finalizer = finalizer
     @cast = cast
-    @read_only = read_only
+    @mutable = mutable
     @as = as
-    @dynamic_options = dynamic_options
   end
 
-  # @return [Boolean]
-  #
-  # @api private
-  # @since 0.1.0
-  def has_default?
-    dynamic_options.key?(:default)
-  end
-
-  # @return [Any]
-  #
-  # @raise [SmartCore::Initializer::NoDefaultValueError]
+  # @param value [Any]
+  # @return [void]
   #
   # @api private
-  # @since 0.1.0
-  def default
-    default_value = dynamic_options.fetch(:default) do
-      raise(SmartCore::Initializer::NoDefaultValueError, <<~ERROR_MESSAGE)
-        Attribute #{name} has no default value
-      ERROR_MESSAGE
-    end
-
-    default_value.is_a?(Proc) ? default_value.call : default_value
+  # @since 0.8.0
+  def validate!(value)
+    type.validate!(value)
+  rescue => error # TODO: move to typesystem interop
+    raise(
+      SmartCore::Initializer::IncorrectTypeError,
+      "Validation of attribute `#{name}` failed:" \
+      "(expected: #{type.identifier}, got: #{value.class}) \"#{error.message}\""
+    )
   end
 end

data/lib/smart_core/initializer/attribute/value/option.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::Attribute::Value
+  # @api private
+  # @since 0.8.0
+  class Option < Base
+    # @return [Object]
+    #
+    # @api private
+    # @since 0.8.0
+    UNDEFINED_DEFAULT = ::Object.new.tap(&:freeze)
+
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.8.0
+    DEFAULT_OPTIONAL = false
+
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.8.0
+    attr_reader :optional
+    alias_method :optional?, :optional
+
+    # @param name [Symbol]
+    # @param type [SmartCore::Initializer::TypeSystem::Interop]
+    # @param type_system [Class<SmartCore::Initializer::TypeSystem::Interop>]
+    # @param privacy [Symbol]
+    # @param finalizer [SmartCore::Initializer::Attribute::AnonymousBlock/InstanceMethod]
+    # @param cast [Boolean]
+    # @param mutable [Boolean]
+    # @param as [NilClass, Symbol, String]
+    # @param default [Proc, Any]
+    # @param optional [Boolean]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.8.0
+    def initialize(
+      name,
+      type,
+      type_system,
+      privacy,
+      finalizer,
+      cast,
+      mutable,
+      as,
+      default,
+      optional
+    )
+      super(name, type, type_system, privacy, finalizer, cast, mutable, as)
+      @default = default
+      @optional = optional
+    end
+
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.8.0
+    def has_default?
+      !@default.equal?(UNDEFINED_DEFAULT)
+    end
+
+    # @return [Any]
+    #
+    # @raise [SmartCore::Initializer::NoDefaultValueError]
+    #
+    # @api private
+    # @since 0.8.0
+    def default
+      raise(
+        SmartCore::Initializer::NoDefaultValueError,
+        "Attribute #{name} has no default value"
+      ) if @default.equal?(UNDEFINED_DEFAULT)
+
+      @default.is_a?(Proc) ? @default.call : @default.dup
+    end
+
+    # @return [SmartCore::Initializer::Attribute::Value::Option]
+    #
+    # @api private
+    # @since 0.8.0
+    def dup
+      default = @default.equal?(UNDEFINED_DEFAULT) ? @default : @default.dup
+
+      self.class.new(
+        name.dup,
+        type,
+        type_system,
+        privacy,
+        finalizer.dup,
+        cast,
+        mutable,
+        as,
+        default,
+        optional
+      )
+    end
+  end
+end

data/lib/smart_core/initializer/attribute/value/param.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::Attribute::Value
+  # @api private
+  # @since 0.8.0
+  class Param < Base
+    # @return [SmartCore::Initializer::Attribute::Value::Param]
+    #
+    # @api private
+    # @since 0.8.0
+    def dup
+      self.class.new(
+        name.dup,
+        type,
+        type_system,
+        privacy,
+        finalizer.dup,
+        cast,
+        mutable,
+        as
+      )
+    end
+  end
+end

data/lib/smart_core/initializer/attribute/value.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.8.0
+module SmartCore::Initializer::Attribute::Value
+  require_relative 'value/base'
+  require_relative 'value/param'
+  require_relative 'value/option'
+end

data/lib/smart_core/initializer/attribute.rb

@@ -2,132 +2,10 @@
 
 # @api private
 # @since 0.1.0
-class SmartCore::Initializer::Attribute
-  require_relative 'attribute/parameters'
+# @version 0.8.0
+module SmartCore::Initializer::Attribute
+  require_relative 'attribute/value'
   require_relative 'attribute/list'
   require_relative 'attribute/finalizer'
   require_relative 'attribute/factory'
-
-  # @since 0.1.0
-  extend ::Forwardable
-
-  # @return [Symbol]
-  #
-  # @pai private
-  # @since 0.1.0
-  def_delegator :parameters, :name
-
-  # @return [SmartCore::Initializer::TypeSystem::Interop]
-  #
-  # @pai private
-  # @since 0.1.0
-  def_delegator :parameters, :type
-
-  # @return [Class<SmartCore::Initializer::TypeSystem::Interop>]
-  #
-  # @api private
-  # @since 0.1.0
-  def_delegator :parameters, :type_system
-
-  # @return [Symbol]
-  #
-  # @pai private
-  # @since 0.1.0
-  def_delegator :parameters, :privacy
-
-  # @return [SmartCore::Initializer::Attribute::Finalizer::AnonymousBlock/InstanceMethod]
-  #
-  # @pai private
-  # @since 0.1.0
-  def_delegator :parameters, :finalizer
-
-  # @return [Boolean]
-  #
-  # @pai private
-  # @since 0.1.0
-  def_delegators :parameters, :cast, :cast?
-
-  # @return [Any]
-  #
-  # @api private
-  # @since 0.1.0
-  def_delegator :parameters, :default
-
-  # @return [Boolean]
-  #
-  # @api private
-  # @since 0.1.0
-  def_delegator :parameters, :has_default?
-
-  # @return [Boolean]
-  #
-  # @api private
-  # @since 0.4.0
-  def_delegator :parameters, :read_only
-
-  # @return [String, Symbol, NilClass]
-  #
-  # @api private
-  # @since 0.4.0
-  def_delegator :parameters, :as
-
-  # @param name [Symbol]
-  # @param type [SmartCore::Initializer::TypeSystem::Interop]
-  # @param type_system [Class<SmartCore::Initializer::TypeSystem::Interop>]
-  # @param privacy [Symbol]
-  # @param finalizer [SmartCore::Initializer::Attribute::Finalizer::AnonymousBlock/InstanceMethod]
-  # @param cast [Boolean]
-  # @param read_only [Boolean]
-  # @param as [String, Symbol, NilClass]
-  # @param dynamic_options [Hash<Symbol,Any>]
-  # @return [void]
-  #
-  # @api private
-  # @since 0.1.0
-  def initialize(name, type, type_system, privacy, finalizer, cast, read_only, as, dynamic_options)
-    @parameters = SmartCore::Initializer::Attribute::Parameters.new(
-      name, type, type_system, privacy, finalizer, cast, read_only, as, dynamic_options
-    )
-  end
-
-  # @param value [Any]
-  # @return [void]
-  #
-  # @api private
-  # @since 0.5.1
-  def validate!(value)
-    type.validate!(value)
-  rescue => error
-    raise SmartCore::Initializer::IncorrectTypeError,
-          "Validation of attribute '#{name}' (#{type.identifier}, got #{value.class}) failed: " \
-          "#{error.message}"
-  end
-
-  # @return [SmartCore::Initializer::Attribute]
-  #
-  # @api private
-  # @since 0.1.0
-  # rubocop:disable Metrics/AbcSize
-  def dup
-    self.class.new(
-      parameters.name.dup,
-      parameters.type,
-      parameters.type_system,
-      parameters.privacy,
-      parameters.finalizer.dup,
-      parameters.cast,
-      parameters.read_only,
-      parameters.as,
-      parameters.dynamic_options.dup
-    )
-  end
-  # rubocop:enable Metrics/AbcSize
-
-  private
-
-  # @return [SmartCore::Initializer::Attribute::Parameters]
-  #
-  # @api private
-  # @since 0.1.0
-  attr_reader :parameters
 end

data/lib/smart_core/initializer/configuration.rb

@@ -25,14 +25,18 @@ module SmartCore::Initializer::Configuration
 
   # @since 0.1.0
   configuration do
+    # @since 0.?.0
     setting :default_type_system, :smart_types
     validate :default_type_system do |value|
       SmartCore::Initializer::TypeSystem.resolve(value) rescue false
     end
 
+    # @since 0.?.0
     setting :strict_options, true
-    validate :strict_options do |value|
-      !!value == value # check if it's a boolean value
-    end
+    validate :strict_options, :boolean
+
+    # @since 0.8.0
+    setting :auto_cast, false
+    validate :auto_cast, :boolean
   end
 end