smart_initializer 0.5.0 → 0.9.0

data/lib/smart_core/initializer/errors.rb

@@ -9,6 +9,14 @@ module SmartCore::Initializer
   # @since 0.1.0
   ArgumentError = Class.new(SmartCore::ArgumentError)
 
+  # @api public
+  # @since 0.8.0
+  AttributeError = Class.new(Error)
+
+  # @api public
+  # @since 0.8.0
+  UndefinedAttributeError = Class.new(AttributeError)
+
   # @api public
   # @since 0.1.0
   ParameterArgumentError = Class.new(ArgumentError)
@@ -17,6 +25,14 @@ module SmartCore::Initializer
   # @since 0.1.0
   OptionArgumentError = Class.new(ArgumentError)
 
+  # @api public
+  # @since 0.8.0
+  AliasArgumentError = Class.new(ArgumentError)
+
+  # @api public
+  # @since 0.8.0
+  SettingArgumentError = Class.new(ArgumentError)
+
   # @api public
   # @since 0.1.0
   NoDefaultValueError = Class.new(Error)
@@ -53,6 +69,10 @@ module SmartCore::Initializer
   # @since 0.1.0
   TypeSystemError = Class.new(Error)
 
+  # @api public
+  # @since 0.5.1
+  IncorrectTypeError = Class.new(TypeSystemError)
+
   # @api public
   # @since 0.1.0
   TypeAliasNotFoundError = Class.new(TypeSystemError)

data/lib/smart_core/initializer/functionality.rb

@@ -3,23 +3,22 @@
 # @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]
+    # @option type_system [String, Symbol]
+    # @option strict_option [Boolean]
+    # @option auto_cast [Boolean]
     # @return [Module]
     #
     # @api private
     # @since 0.3.0
-    def includable_module(type_system: INITIAL_TYPE_SYSTEM)
+    # @version 0.8.0
+    def includable_module(type_system:, strict_options:, auto_cast:)
       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
+          base_klass.__initializer_settings__.strict_options = strict_options
+          base_klass.__initializer_settings__.auto_cast = auto_cast
         end
       end
     end

data/lib/smart_core/initializer/plugins/thy_types/thy_types/abstract_factory.rb

@@ -28,6 +28,15 @@ module SmartCore::Initializer::TypeSystem
         end
       end
 
+      # @param type [Any]
+      # @return [String]
+      #
+      # @api private
+      # @since 0.5.1
+      def build_identifier(type)
+        type.name
+      end
+
       # @param type [Thy::Type, #check]
       # @return [SmartCore::Initializer::TypeSystem::ThyTypes::Operation::Valid]
       #
@@ -63,6 +72,7 @@ module SmartCore::Initializer::TypeSystem
         ThyTypes::Operation::Cast.new(type)
       end
 
+      # @param identifier [String]
       # @param valid_op [SmartCore::Initializer::TypeSystem::ThyTypes::Operation::Valid]
       # @param valid_op [SmartCore::Initializer::TypeSystem::ThyTypes::Operation::Validate]
       # @param valid_op [SmartCore::Initializer::TypeSystem::ThyTypes::Operation::Cast]
@@ -70,8 +80,9 @@ module SmartCore::Initializer::TypeSystem
       #
       # @api private
       # @since 0.1.0
-      def build_interop(valid_op, validate_op, cast_op)
-        ThyTypes.new(valid_op, validate_op, cast_op)
+      # @version 0.5.1
+      def build_interop(identifier, valid_op, validate_op, cast_op)
+        ThyTypes.new(identifier, valid_op, validate_op, cast_op)
       end
     end
   end

data/lib/smart_core/initializer/settings/auto_cast.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.8.0
+class SmartCore::Initializer::Settings::AutoCast < SmartCore::Initializer::Settings::Base
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def initialize
+    @value = nil
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.8.0
+  def resolve
+    thread_safe do
+      @value == nil ? SmartCore::Initializer::Configuration[:auto_cast] : @value
+    end
+  end
+
+  # @param value [Boolean]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def assign(value)
+    thread_safe do
+      raise(
+        SmartCore::Initializer::SettingArgumentError,
+        ":auto_cast setting should be a type of boolean (got: `#{value.class}`)"
+      ) unless value.is_a?(::TrueClass) || value.is_a?(::FalseClass)
+
+      @value = value
+    end
+  end
+end

data/lib/smart_core/initializer/settings/base.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.8.0
+class SmartCore::Initializer::Settings::Base
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def initialize
+    @value = nil
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @!method resolve
+  #   @return [Any]
+  #   @api private
+  #   @since 0.8.0
+
+  # @!method assign(value)
+  #   @param value [Any]
+  #   @return [void]
+  #   @raise [SmartCore::Initializer::SettingArgumentError]
+  #   @api private
+  #   @since 0.8.0
+
+  # @return [SmartCore::Initializer::Settings::Base]
+  #
+  # @api private
+  # @since 0.8.0
+  def dup
+    thread_safe do
+      self.class.new.tap do |duplicate|
+        duplicate.instance_variable_set(:@value, @value)
+      end
+    end
+  end
+
+  private
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.8.0
+  def thread_safe(&block)
+    @lock.synchronize(&block)
+  end
+end

data/lib/smart_core/initializer/settings/duplicator.rb

@@ -9,11 +9,16 @@ module SmartCore::Initializer::Settings::Duplicator
     #
     # @api private
     # @since 0.1.0
+    # @version 0.8.0
     def duplicate(settings)
       SmartCore::Initializer::Settings.new.tap do |new_instance|
         type_system = settings.instance_variable_get(:@type_system).dup
+        strict_options = settings.instance_variable_get(:@strict_options).dup
+        auto_cast = settings.instance_variable_get(:@auto_cast).dup
 
         new_instance.instance_variable_set(:@type_system, type_system)
+        new_instance.instance_variable_set(:@strict_options, strict_options)
+        new_instance.instance_variable_set(:@auto_cast, auto_cast)
       end
     end
   end

data/lib/smart_core/initializer/settings/strict_options.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.8.0
+class SmartCore::Initializer::Settings::StrictOptions < SmartCore::Initializer::Settings::Base
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def initialize
+    @value = nil
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.8.0
+  def resolve
+    thread_safe do
+      @value == nil ? SmartCore::Initializer::Configuration[:strict_options] : @value
+    end
+  end
+
+  # @param value [Boolean]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def assign(value)
+    thread_safe do
+      raise(
+        SmartCore::Initializer::SettingArgumentError,
+        ":strict_options setting should be a type of boolean (got: `#{value.class}`)"
+      ) unless value.is_a?(::TrueClass) || value.is_a?(::FalseClass)
+
+      @value = value
+    end
+  end
+end

data/lib/smart_core/initializer/settings/type_system.rb

@@ -2,13 +2,15 @@
 
 # @api private
 # @since 0.1.0
-class SmartCore::Initializer::Settings::TypeSystem
+# @version 0.8.0
+class SmartCore::Initializer::Settings::TypeSystem < SmartCore::Initializer::Settings::Base
   # @return [void]
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
   def initialize
-    @type_system = nil
+    @value = nil
     @lock = SmartCore::Engine::Lock.new
   end
 
@@ -26,9 +28,10 @@ class SmartCore::Initializer::Settings::TypeSystem
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
   def resolve
     thread_safe do
-      @type_system || SmartCore::Initializer::Configuration.config[:default_type_system]
+      @value == nil ? SmartCore::Initializer::Configuration[:default_type_system] : @value
     end
   end
 
@@ -37,33 +40,12 @@ class SmartCore::Initializer::Settings::TypeSystem
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
   def assign(value)
     thread_safe do
-      SmartCore::Initializer::TypeSystem.resolve(value) # NOTE: type system existence validation
-      @type_system = value
+      # NOTE: type system existence validation
+      SmartCore::Initializer::TypeSystem.resolve(value)
+      @value = value
     end
   end
-
-  # @return [SmartCore::Initializer::Settings::TypeSystem]
-  #
-  # @api private
-  # @since 0.1.0
-  def dup
-    thread_safe do
-      self.class.new.tap do |duplicate|
-        duplicate.instance_variable_set(:@type_system, @type_system)
-      end
-    end
-  end
-
-  private
-
-  # @param block [Block]
-  # @return [Any]
-  #
-  # @api private
-  # @since 0.1.0
-  def thread_safe(&block)
-    @lock.synchronize(&block)
-  end
 end

data/lib/smart_core/initializer/settings.rb

@@ -3,15 +3,21 @@
 # @api private
 # @since 0.1.0
 class SmartCore::Initializer::Settings
+  require_relative 'settings/base'
   require_relative 'settings/type_system'
+  require_relative 'settings/strict_options'
+  require_relative 'settings/auto_cast'
   require_relative 'settings/duplicator'
 
   # @return [void]
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
   def initialize
     @type_system = TypeSystem.new
+    @strict_options = StrictOptions.new
+    @auto_cast = AutoCast.new
   end
 
   # @return [Any]
@@ -30,6 +36,22 @@ class SmartCore::Initializer::Settings
     @type_system.resolve
   end
 
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.8.0
+  def strict_options
+    @strict_options.resolve
+  end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.8.0
+  def auto_cast
+    @auto_cast.resolve
+  end
+
   # @param value [String, System]
   # @return [void]
   #
@@ -39,6 +61,24 @@ class SmartCore::Initializer::Settings
     @type_system.assign(value)
   end
 
+  # @param value [Boolean]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def strict_options=(value)
+    @strict_options.assign(value)
+  end
+
+  # @param value [Boolean]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def auto_cast=(value)
+    @auto_cast.assign(value)
+  end
+
   # @return [SmartCore::Initializer::Settings]
   #
   # @api private

data/lib/smart_core/initializer/type_system/interop/abstract_factory.rb

@@ -13,11 +13,12 @@ class SmartCore::Initializer::TypeSystem::Interop::AbstractFactory
     def create(type)
       prevent_incompatible_type!(type)
 
+      identifier = build_identifier(type)
       valid_op = build_valid_operation(type)
       validate_op = build_validate_operation(type)
       cast_op = build_cast_operation(type)
 
-      build_interop(valid_op, validate_op, cast_op)
+      build_interop(identifier, valid_op, validate_op, cast_op)
     end
 
     # @return [Any]
@@ -26,6 +27,13 @@ class SmartCore::Initializer::TypeSystem::Interop::AbstractFactory
     # @since 0.1.0
     def generic_type_object; end
 
+    # @param type [Any]
+    # @return [String]
+    #
+    # @api private
+    # @since 0.5.1
+    def build_identifier(type); end
+
     # @param type [Any]
     # @return [void]
     #
@@ -58,6 +66,7 @@ class SmartCore::Initializer::TypeSystem::Interop::AbstractFactory
     # @since 0.1.0
     def build_cast_operation(type); end
 
+    # @param identifier [String]
     # @param valid_op [SmartCore::Initializer::TypeSystem::Interop::Operation]
     # @param validate_op [SmartCore::Initializer::TypeSystem::Interop::Operation]
     # @param cast_op [SmartCore::Initializer::TypeSystem::Interop::Operation]
@@ -65,6 +74,7 @@ class SmartCore::Initializer::TypeSystem::Interop::AbstractFactory
     #
     # @api private
     # @since 0.1.0
-    def build_interop(valid_op, validate_op, cast_op); end
+    # @version 0.5.1
+    def build_interop(identifier, valid_op, validate_op, cast_op); end
   end
 end

data/lib/smart_core/initializer/type_system/interop.rb

@@ -41,6 +41,13 @@ class SmartCore::Initializer::TypeSystem::Interop
     end
   end
 
+  # @return [String]
+  #
+  # @api private
+  # @since 0.5.1
+  attr_reader :identifier
+
+  # @param identifier [String]
   # @param valid_op [SmartCore::Initializer::TypeSystem::Interop::Operation]
   # @param validate_op [SmartCore::Initializer::TypeSystem::Interop::Operation]
   # @param cast_op [SmartCore::Initializer::TypeSystem::Interop::Operation]
@@ -48,7 +55,9 @@ class SmartCore::Initializer::TypeSystem::Interop
   #
   # @api private
   # @since 0.1.0
-  def initialize(valid_op, validate_op, cast_op)
+  # @version 0.5.1
+  def initialize(identifier, valid_op, validate_op, cast_op)
+    @identifier = identifier
     @valid_op = valid_op
     @validate_op = validate_op
     @cast_op = cast_op

data/lib/smart_core/initializer/type_system/registry.rb

@@ -126,6 +126,7 @@ class SmartCore::Initializer::TypeSystem::Registry
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
   def fetch(system_identifier)
     identifier = indifferently_accessible_identifier(system_identifier)
 
@@ -133,7 +134,7 @@ class SmartCore::Initializer::TypeSystem::Registry
       systems.fetch(identifier)
     rescue ::KeyError
       raise(SmartCore::Initializer::UnsupportedTypeSystemError, <<~ERROR_MESSAGE)
-        "#{identifier}" type system is not supported.
+        `#{identifier}` type system is not supported.
       ERROR_MESSAGE
     end
   end

data/lib/smart_core/initializer/type_system/smart_types/abstract_factory.rb

@@ -22,6 +22,15 @@ module SmartCore::Initializer::TypeSystem
         end
       end
 
+      # @param type [Any]
+      # @return [String]
+      #
+      # @api private
+      # @since 0.5.1
+      def build_identifier(type)
+        type.name
+      end
+
       # @param type [SmartCore::Types::Primitive]
       # @return [SmartCore::Initializer::TypeSystem::SmartTypes::Operation::Valid]
       #
@@ -57,6 +66,7 @@ module SmartCore::Initializer::TypeSystem
         SmartTypes::Operation::Cast.new(type)
       end
 
+      # @param identifier [String]
       # @param valid_op [SmartCore::Initializer::TypeSystem::SmartTypes::Operation::Valid]
       # @param valid_op [SmartCore::Initializer::TypeSystem::SmartTypes::Operation::Validate]
       # @param valid_op [SmartCore::Initializer::TypeSystem::SmartTypes::Operation::Cast]
@@ -64,8 +74,9 @@ module SmartCore::Initializer::TypeSystem
       #
       # @api private
       # @since 0.1.0
-      def build_interop(valid_op, validate_op, cast_op)
-        SmartTypes.new(valid_op, validate_op, cast_op)
+      # @version 0.5.1
+      def build_interop(identifier, valid_op, validate_op, cast_op)
+        SmartTypes.new(identifier, valid_op, validate_op, cast_op)
       end
     end
   end

data/lib/smart_core/initializer/type_system/smart_types.rb

@@ -21,7 +21,7 @@ class SmartCore::Initializer::TypeSystem::SmartTypes < SmartCore::Initializer::T
   type_alias('value.proc',        SmartCore::Types::Value::Proc)
   type_alias('value.class',       SmartCore::Types::Value::Class)
   type_alias('value.module',      SmartCore::Types::Value::Module)
-  type_alias('value.tme',         SmartCore::Types::Value::Time)
+  type_alias('value.time',        SmartCore::Types::Value::Time)
   type_alias('value.date_time',   SmartCore::Types::Value::DateTime)
   type_alias('value.date',        SmartCore::Types::Value::Date)
   type_alias('value.time_based',  SmartCore::Types::Value::TimeBased)
@@ -41,7 +41,7 @@ class SmartCore::Initializer::TypeSystem::SmartTypes < SmartCore::Initializer::T
   type_alias(:proc,        SmartCore::Types::Value::Proc)
   type_alias(:class,       SmartCore::Types::Value::Class)
   type_alias(:module,      SmartCore::Types::Value::Module)
-  type_alias(:tme,         SmartCore::Types::Value::Time)
+  type_alias(:time,        SmartCore::Types::Value::Time)
   type_alias(:date_time,   SmartCore::Types::Value::DateTime)
   type_alias(:date,        SmartCore::Types::Value::Date)
   type_alias(:time_based,  SmartCore::Types::Value::TimeBased)

data/lib/smart_core/initializer/version.rb

@@ -6,7 +6,7 @@ module SmartCore
     #
     # @api public
     # @since 0.1.0
-    # @version 0.5.0
-    VERSION = '0.5.0'
+    # @version 0.9.0
+    VERSION = '0.9.0'
   end
 end

data/lib/smart_core/initializer.rb

@@ -43,15 +43,25 @@ module SmartCore
   end
 
   class << self
-    # @option type_system [String, Symbol, NilSymbol]
+    # @option type_system [String, Symbol]
+    # @option strict_options [Boolean]
+    # @option auto_cast [Boolean]
     # @return [Module]
     #
     # @api public
     # @since 0.1.0
-    # @version 0.3.0
+    # @version 0.8.0
     # rubocop:disable Naming/MethodName
-    def Initializer(type_system: SmartCore::Initializer::Functionality::INITIAL_TYPE_SYSTEM)
-      SmartCore::Initializer::Functionality.includable_module(type_system: type_system)
+    def Initializer(
+      type_system: SmartCore::Initializer::Configuration[:default_type_system],
+      strict_options: SmartCore::Initializer::Configuration[:strict_options],
+      auto_cast: SmartCore::Initializer::Configuration[:auto_cast]
+    )
+      SmartCore::Initializer::Functionality.includable_module(
+        type_system: type_system,
+        strict_options: strict_options,
+        auto_cast: auto_cast
+      )
     end
     # rubocop:enable Naming/MethodName
   end

data/smart_initializer.gemspec

@@ -3,7 +3,7 @@
 require_relative 'lib/smart_core/initializer/version'
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.4.10')
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.5')
 
   spec.name    = 'smart_initializer'
   spec.version = SmartCore::Initializer::VERSION
@@ -37,7 +37,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler',          '~> 2.2'
   spec.add_development_dependency 'rake',             '~> 13.0'
   spec.add_development_dependency 'rspec',            '~> 3.10'
-  spec.add_development_dependency 'armitage-rubocop', '~> 1.7'
+  spec.add_development_dependency 'armitage-rubocop', '~> 1.23'
   spec.add_development_dependency 'simplecov',        '~> 0.21'
-  spec.add_development_dependency 'pry',              '~> 0.13'
+  spec.add_development_dependency 'pry',              '~> 0.14'
 end