smart_initializer 0.1.0.alpha4 → 0.3.2

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

@@ -72,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(
@@ -82,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]
   #
@@ -107,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)
@@ -123,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]

data/lib/smart_core/initializer/constructor/definer.rb

@@ -2,6 +2,7 @@
 
 # @api private
 # @since 0.1.0
+# rubocop:disable Metrics/ClassLength
 class SmartCore::Initializer::Constructor::Definer
   # @param klass [Class]
   # @return [void]
@@ -25,7 +26,8 @@ class SmartCore::Initializer::Constructor::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]
@@ -34,9 +36,17 @@ class SmartCore::Initializer::Constructor::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
@@ -52,7 +62,8 @@ class SmartCore::Initializer::Constructor::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,
@@ -67,7 +78,8 @@ class SmartCore::Initializer::Constructor::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]
@@ -76,9 +88,17 @@ class SmartCore::Initializer::Constructor::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
@@ -94,7 +114,8 @@ class SmartCore::Initializer::Constructor::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,
@@ -117,7 +138,8 @@ class SmartCore::Initializer::Constructor::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]
@@ -126,9 +148,9 @@ class SmartCore::Initializer::Constructor::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
 
@@ -207,3 +229,4 @@ class SmartCore::Initializer::Constructor::Definer
     @lock.synchronize(&block)
   end
 end
+# rubocop:enable Metrics/ClassLength

data/lib/smart_core/initializer/dsl.rb

@@ -18,6 +18,7 @@ module SmartCore::Initializer::DSL
         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)
@@ -32,16 +33,19 @@ module SmartCore::Initializer::DSL
     #
     # @api private
     # @since 0.1.0
+    # @version 0.3.2
     def inherited(child_klass)
-      child_klass.instance_eval do
+      child_klass.instance_exec(__initializer_settings__) do |init_settings|
         instance_variable_set(:@__params__, SmartCore::Initializer::Attribute::List.new)
         instance_variable_set(:@__options__, SmartCore::Initializer::Attribute::List.new)
         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__, init_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
@@ -81,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]
@@ -92,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]
@@ -103,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>]
@@ -122,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]
     #
@@ -133,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>]
@@ -159,5 +178,6 @@ module SmartCore::Initializer::DSL
     def ext_init(&block)
       __definer__.define_init_extension(block)
     end
+    alias_method :extend_initialization_flow, :ext_init
   end
 end

data/lib/smart_core/initializer/errors.rb

@@ -32,4 +32,48 @@ module SmartCore::Initializer
   # @api public
   # @since 0.1.0
   NoTypeAliasError = Class.new(Error)
+
+  # @api public
+  # @since 0.1.0
+  PluginError = Class.new(Error)
+
+  # @api public
+  # @since 0.1.0
+  UnresolvedPluginDependencyError = Class.new(PluginError)
+
+  # @api public
+  # @since 0.1.0
+  AlreadyRegisteredPluginError = Class.new(PluginError)
+
+  # @api public
+  # @since 0.1.0
+  UnregisteredPluginError = Class.new(PluginError)
+
+  # @api public
+  # @since 0.1.0
+  TypeSystemError = Class.new(Error)
+
+  # @api public
+  # @since 0.1.0
+  TypeAliasNotFoundError = Class.new(TypeSystemError)
+
+  # @api public
+  # @since 0.1.0
+  IncorrectTypeSystemInteropError = Class.new(TypeSystemError)
+
+  # @api public
+  # @since 0.1.0
+  IncorrectTypeObjectError = Class.new(TypeSystemError)
+
+  # @api public
+  # @since 0.1.0
+  UnsupportedTypeSystemError = Class.new(TypeSystemError)
+
+  # @api public
+  # @since 0.1.0
+  UnsupportedTypeOperationError = Class.new(TypeSystemError)
+
+  # @api public
+  # @since 0.1.0
+  TypeCastingUnsupportedError = Class.new(UnsupportedTypeOperationError)
 end

data/lib/smart_core/initializer/functionality.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.3.0
+module SmartCore::Initializer::Functionality
+  # @return [NilClass]
+  #
+  # @api private
+  # @since 0.3.0
+  INITIAL_TYPE_SYSTEM = nil
+
+  class << self
+    # @option type_system [String, Symbol, NilClass]
+    # @return [Module]
+    #
+    # @api private
+    # @since 0.3.0
+    def includable_module(type_system: INITIAL_TYPE_SYSTEM)
+      Module.new.tap do |extension|
+        extension.singleton_class.define_method(:included) do |base_klass|
+          base_klass.include(::SmartCore::Initializer)
+          base_klass.__initializer_settings__.type_system = type_system
+        end
+      end
+    end
+
+    # @param base_klass [Class]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def seed_to(base_klass)
+      base_klass.extend(SmartCore::Initializer::DSL)
+      base_klass.include(SmartCore::Initializer::InstanceAttributeAccessing)
+    end
+  end
+end