smart_initializer 0.1.0.alpha3 → 0.3.1

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

@@ -43,12 +43,18 @@ class SmartCore::Initializer::Attribute::Parameters
   # @since 0.1.0
   attr_reader :name
 
-  # @return [SmartCore::Types::Primitive]
+  # @return [SmartCore::Initializer::TypeSystem::Interop]
   #
   # @api private
   # @since 0.1.0
   attr_reader :type
 
+  # @return [Class<SmartCore::Initilizer::TypeSystem::Interop>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :type_system
+
   # @return [Symbol]
   #
   # @api private
@@ -76,7 +82,8 @@ class SmartCore::Initializer::Attribute::Parameters
   attr_reader :dynamic_options
 
   # @param name [Symbol]
-  # @param type [SmartCore::Types::Primitive]
+  # @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]
@@ -86,9 +93,10 @@ class SmartCore::Initializer::Attribute::Parameters
   #
   # @api private
   # @since 0.1.0
-  def initialize(name, type, privacy, finalizer, cast, dynamic_options)
+  def initialize(name, type, type_system, privacy, finalizer, cast, dynamic_options)
     @name = name
     @type = type
+    @type_system = type_system
     @privacy = privacy
     @finalizer = finalizer
     @cast = cast
@@ -116,6 +124,6 @@ class SmartCore::Initializer::Attribute::Parameters
       ERROR_MESSAGE
     end
 
-    defalut_value.is_a?(Proc) ? default_value.call : default_value
+    default_value.is_a?(Proc) ? default_value.call : default_value
   end
 end

data/lib/smart_core/initializer/configuration.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'qonfig'
+
+# @api public
+# @since 0.1.0
+module SmartCore::Initializer::Configuration
+  # @since 0.1.0
+  include Qonfig::Configurable
+
+  # @api public
+  # @since 0.1.0
+  extend SmartCore::Initializer::Plugins::AccessMixin
+
+  class << self
+    # @param setting_key [String, Symbol]
+    # @return [Qonfig::Settings, Any]
+    #
+    # @api private
+    # @since 0.1.0
+    def [](setting_key)
+      config[setting_key]
+    end
+  end
+
+  # @since 0.1.0
+  configuration do
+    setting :default_type_system, :smart_types
+    validate :default_type_system do |value|
+      SmartCore::Initializer::TypeSystem.resolve(value) rescue false
+    end
+  end
+end

data/lib/smart_core/initializer/constructor.rb

@@ -3,6 +3,8 @@
 # @api private
 # @since 0.1.0
 class SmartCore::Initializer::Constructor
+  require_relative 'constructor/definer'
+
   # @param klass [Class<SmartCore::Initializer>]
   # @param arguments [Array<Any>]
   # @param block [Proc, NilClass]
@@ -27,6 +29,7 @@ class SmartCore::Initializer::Constructor
       initialize_parameters(instance)
       initialize_options(instance)
       process_original_initializer(instance)
+      process_init_extensions(instance)
     end
   end
 
@@ -69,8 +72,8 @@ class SmartCore::Initializer::Constructor
   #
   # @api private
   # @since 0.1.0
+  # rubocop:disable Metrics/AbcSize
   def prevent_attribute_insufficiency
-    required_options = klass.__options__.reject(&:has_default?).map(&:name)
     required_parameter_count = klass.__params__.size
 
     raise(
@@ -79,13 +82,23 @@ class SmartCore::Initializer::Constructor
       "(given #{parameters.size}, expected #{required_parameter_count})"
     ) unless parameters.size == required_parameter_count
 
-    missing_options = required_options.reject { |option| options.key?(option) }
+    required_options = klass.__options__.reject(&:has_default?).map(&:name)
+    missing_options  = required_options.reject { |option| options.key?(option) }
 
     raise(
       SmartCore::Initializer::OptionArgumentError,
       "Missing options: #{missing_options.join(', ')}"
     ) if missing_options.any?
+
+    possible_options = klass.__options__.map(&:name)
+    unknown_options  = options.keys - possible_options
+
+    raise(
+      SmartCore::Initializer::OptionArgumentError,
+      "Unknown options: #{unknown_options.join(', ')}"
+    ) if unknown_options.any?
   end
+  # rubocop:enable Metrics/AbcSize
 
   # @return [Any]
   #
@@ -104,10 +117,10 @@ class SmartCore::Initializer::Constructor
     parameter_definitions = Hash[klass.__params__.zip(parameters)]
 
     parameter_definitions.each_pair do |attribute, parameter_value|
-      parameter_value = attribute.type.cast(parameter_value) if attribute.cast?
+      if !attribute.type.valid?(parameter_value) && attribute.cast?
+        parameter_value = attribute.type.cast(parameter_value)
+      end
 
-      # TODO: fail with SmartCore::Initializer::ArgumentError
-      #   (isntead of SmartCore::Types::TypeError)
       attribute.type.validate!(parameter_value)
 
       final_value = attribute.finalizer.call(parameter_value, instance)
@@ -120,19 +133,22 @@ class SmartCore::Initializer::Constructor
   #
   # @api private
   # @since 0.1.0
+  # rubocop:disable Metrics/AbcSize
   def initialize_options(instance)
     klass.__options__.each do |attribute|
       option_value = options.fetch(attribute.name) { attribute.default }
-      option_value = attribute.type.cast(option_value) if attribute.cast?
 
-      # TODO: fail with SmartCore::Initializer::ArgumentError
-      #   (isntead of SmartCore::Types::TypeError)
+      if !attribute.type.valid?(option_value) && attribute.cast?
+        option_value = attribute.type.cast(option_value)
+      end
+
       attribute.type.validate!(option_value)
 
       final_value = attribute.finalizer.call(option_value, instance)
       instance.instance_variable_set("@#{attribute.name}", final_value)
     end
   end
+  # rubocop:enable Metrics/AbcSize
 
   # @param instance [Any]
   # @return [void]
@@ -143,6 +159,17 @@ class SmartCore::Initializer::Constructor
     instance.send(:initialize, *arguments, &block)
   end
 
+  # @param instance [Any]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def process_init_extensions(instance)
+    klass.__init_extensions__.each do |extension|
+      extension.call(instance)
+    end
+  end
+
   # @param arguments [Array<Any>]
   # @return [Array<Array<Any>,Hash<Symbol,Any>>]
   #

data/lib/smart_core/initializer/{attribute → constructor}/definer.rb

@@ -2,7 +2,8 @@
 
 # @api private
 # @since 0.1.0
-class SmartCore::Initializer::Attribute::Definer
+# rubocop:disable Metrics/ClassLength
+class SmartCore::Initializer::Constructor::Definer
   # @param klass [Class]
   # @return [void]
   #
@@ -13,8 +14,20 @@ class SmartCore::Initializer::Attribute::Definer
     @lock = SmartCore::Engine::Lock.new
   end
 
+  # @param block [Proc]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def define_init_extension(block)
+    thread_safe do
+      add_init_extension(build_init_extension(block))
+    end
+  end
+
   # @param name [String, Symbol]
-  # @param type [String, Symbol, SmartCore::Types::Primitive]
+  # @param type [String, Symbol, Any]
+  # @param type_system [String, Symbol]
   # @param privacy [String, Symbol]
   # @param finalize [String, Symbol, Proc]
   # @param cast [Boolean]
@@ -23,9 +36,17 @@ class SmartCore::Initializer::Attribute::Definer
   #
   # @api private
   # @since 0.1.0
-  def define_parameter(name, type, privacy, finalize, cast, dynamic_options)
+  def define_parameter(name, type, type_system, privacy, finalize, cast, dynamic_options)
     thread_safe do
-      attribute = build_attribute(name, type, privacy, finalize, cast, dynamic_options)
+      attribute = build_attribute(
+        name,
+        type,
+        type_system,
+        privacy,
+        finalize,
+        cast,
+        dynamic_options
+      )
       prevent_option_overlap(attribute)
       add_parameter(attribute)
     end
@@ -41,7 +62,8 @@ class SmartCore::Initializer::Attribute::Definer
       names.map do |name|
         build_attribute(
           name,
-          SmartCore::Types::Value::Any,
+          klass.__initializer_settings__.generic_type_object,
+          klass.__initializer_settings__.type_system,
           SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
           SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
           SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
@@ -56,7 +78,8 @@ class SmartCore::Initializer::Attribute::Definer
   end
 
   # @param name [String, Symbol]
-  # @param type [String, Symbol, SmartCore::Types::Primitive]
+  # @param type [String, Symbol, Any]
+  # @param type_system [String, Symbol]
   # @param privacy [String, Symbol]
   # @param finalize [String, Symbol, Proc]
   # @param cast [Boolean]
@@ -65,9 +88,17 @@ class SmartCore::Initializer::Attribute::Definer
   #
   # @api private
   # @since 0.1.0
-  def define_option(name, type, privacy, finalize, cast, dynamic_options)
+  def define_option(name, type, type_system, privacy, finalize, cast, dynamic_options)
     thread_safe do
-      attribute = build_attribute(name, type, privacy, finalize, cast, dynamic_options)
+      attribute = build_attribute(
+        name,
+        type,
+        type_system,
+        privacy,
+        finalize,
+        cast,
+        dynamic_options
+      )
       prevent_parameter_overlap(attribute)
       add_option(attribute)
     end
@@ -83,7 +114,8 @@ class SmartCore::Initializer::Attribute::Definer
       names.map do |name|
         build_attribute(
           name,
-          SmartCore::Types::Value::Any,
+          klass.__initializer_settings__.generic_type_object,
+          klass.__initializer_settings__.type_system,
           SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
           SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
           SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
@@ -106,7 +138,8 @@ class SmartCore::Initializer::Attribute::Definer
   attr_reader :klass
 
   # @param name [String, Symbol]
-  # @param type [String, Symbol, SmartCore::Types::Primitive]
+  # @param type [String, Symbol, Any]
+  # @param type_system [String, Symbol]
   # @param privacy [String, Symbol]
   # @param finalize [String, Symbol, Proc]
   # @param cast [Boolean]
@@ -115,12 +148,21 @@ class SmartCore::Initializer::Attribute::Definer
   #
   # @api private
   # @since 0.1.0
-  def build_attribute(name, type, privacy, finalize, cast, dynamic_options)
+  def build_attribute(name, type, type_system, privacy, finalize, cast, dynamic_options)
     SmartCore::Initializer::Attribute::Factory.create(
-      name, type, privacy, finalize, cast, dynamic_options
+      name, type, type_system, privacy, finalize, cast, dynamic_options
     )
   end
 
+  # @param block [Proc]
+  # @return [SmartCore::Initializer::Extensions::ExtInit]
+  #
+  # @api private
+  # @since 0.1.0
+  def build_init_extension(block)
+    SmartCore::Initializer::Extensions::ExtInit.new(block)
+  end
+
   # @param parameter [SmartCore::Initializer::Attribute]
   # @return [void]
   #
@@ -143,6 +185,15 @@ class SmartCore::Initializer::Attribute::Definer
     klass.send(option.privacy, option.name)
   end
 
+  # @param extension [SmartCore::Initializer::Extensions::ExtInit]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def add_init_extension(extension)
+    klass.__init_extensions__ << extension
+  end
+
   # @param parameter [SmartCore::Initializer::Attribute]
   # @return [void]
   #
@@ -178,3 +229,4 @@ class SmartCore::Initializer::Attribute::Definer
     @lock.synchronize(&block)
   end
 end
+# rubocop:enable Metrics/ClassLength

data/lib/smart_core/initializer/dsl.rb

@@ -13,10 +13,12 @@ module SmartCore::Initializer::DSL
     # @since 0.1.0
     def extended(base_klass)
       base_klass.instance_eval do
-        instance_variable_set(:@__params__,  SmartCore::Initializer::Attribute::List.new)
+        instance_variable_set(:@__params__, SmartCore::Initializer::Attribute::List.new)
         instance_variable_set(:@__options__, SmartCore::Initializer::Attribute::List.new)
-        instance_variable_set(:@__definer__, SmartCore::Initializer::Attribute::Definer.new(self))
+        instance_variable_set(:@__init_extensions__, SmartCore::Initializer::Extensions::List.new)
+        instance_variable_set(:@__definer__, SmartCore::Initializer::Constructor::Definer.new(self))
         instance_variable_set(:@__deflock__, SmartCore::Engine::Lock.new)
+        instance_variable_set(:@__initializer_settings__, SmartCore::Initializer::Settings.new)
       end
       base_klass.extend(ClassMethods)
       base_klass.singleton_class.prepend(ClassInheritance)
@@ -31,15 +33,19 @@ module SmartCore::Initializer::DSL
     #
     # @api private
     # @since 0.1.0
+    # @version 0.3.1
     def inherited(child_klass)
       child_klass.instance_eval do
-        instance_variable_set(:@__params__,  SmartCore::Initializer::Attribute::List.new)
+        instance_variable_set(:@__params__, SmartCore::Initializer::Attribute::List.new)
         instance_variable_set(:@__options__, SmartCore::Initializer::Attribute::List.new)
-        instance_variable_set(:@__definer__, SmartCore::Initializer::Attribute::Definer.new(self))
+        instance_variable_set(:@__init_extensions__, SmartCore::Initializer::Extensions::List.new)
+        instance_variable_set(:@__definer__, SmartCore::Initializer::Constructor::Definer.new(self))
         instance_variable_set(:@__deflock__, SmartCore::Engine::Lock.new)
+        instance_variable_set(:@__initializer_settings__, __initializer_settings__.dup)
       end
       child_klass.extend(ClassMethods)
       SmartCore::Initializer::DSL::Inheritance.inherit(base: self, child: child_klass)
+      child_klass.singleton_class.prepend(ClassInheritance)
       super
     end
   end
@@ -63,6 +69,14 @@ module SmartCore::Initializer::DSL
       @__options__
     end
 
+    # @return [SmartCore::Initializer::Extentions::List]
+    #
+    # @api private
+    # @since 0.1.0
+    def __init_extensions__
+      @__init_extensions__
+    end
+
     # @return [SmartCore::Initializer::Attribute::Definer]
     #
     # @api private
@@ -71,6 +85,14 @@ module SmartCore::Initializer::DSL
       @__definer__
     end
 
+    # @return [SmartCore::Initializer::Settings]
+    #
+    # @api private
+    # @since 0.1.0
+    def __initializer_settings__
+      @__initializer_settings__
+    end
+
     # @param arguments [Array]
     # @param block [Block]
     # @return [Any]
@@ -82,7 +104,7 @@ module SmartCore::Initializer::DSL
     end
 
     # @param name [String, Symbol]
-    # @param type [String, Symbol, SmartCore::Types::Primitive]
+    # @param type [String, Symbol, Any]
     # @option cast [Boolean]
     # @option privacy [String, Symbol]
     # @option finalize [String, Symbol, Proc]
@@ -93,13 +115,16 @@ module SmartCore::Initializer::DSL
     # @since 0.1.0
     def param(
       name,
-      type = SmartCore::Types::Value::Any,
+      type = __initializer_settings__.generic_type_object,
       privacy: SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
       finalize: SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
       cast: SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
+      type_system: __initializer_settings__.type_system,
       **dynamic_options
     )
-      __definer__.define_parameter(name, type, privacy, finalize, cast, dynamic_options)
+      __definer__.define_parameter(
+        name, type, type_system, privacy, finalize, cast, dynamic_options
+      )
     end
 
     # @param names [Array<String, Symbol>]
@@ -112,10 +137,11 @@ module SmartCore::Initializer::DSL
     end
 
     # @param name [String, Symbol]
-    # @param type [String, Symbol, SmartCore::Types::Primitive]
+    # @param type [String, Symbol, Any]
     # @option cast [Boolean]
     # @option privacy [String, Symbol]
     # @option finalize [String, Symbol, Proc]
+    # @option type_system [String, Symbol]
     # @param dynamic_options [Hash<Symbol,Any>]
     # @return [void]
     #
@@ -123,13 +149,16 @@ module SmartCore::Initializer::DSL
     # @since 0.1.0
     def option(
       name,
-      type = SmartCore::Types::Value::Any,
+      type = __initializer_settings__.generic_type_object,
       privacy: SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
       finalize: SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
       cast: SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
+      type_system: __initializer_settings__.type_system,
       **dynamic_options
     )
-      __definer__.define_option(name, type, privacy, finalize, cast, dynamic_options)
+      __definer__.define_option(
+        name, type, type_system, privacy, finalize, cast, dynamic_options
+      )
     end
 
     # @param names [Array<String, Symbol>]
@@ -140,5 +169,15 @@ module SmartCore::Initializer::DSL
     def options(*names)
       __definer__.define_options(*names)
     end
+
+    # @param block [Block]
+    # @return [void]
+    #
+    # @api public
+    # @since 0.1.0
+    def ext_init(&block)
+      __definer__.define_init_extension(block)
+    end
+    alias_method :extend_initialization_flow, :ext_init
   end
 end