smart_initializer 0.1.0.alpha2 → 0.3.0

data/lib/smart_core/initializer/plugins/registry_interface.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+module SmartCore::Initializer::Plugins::RegistryInterface
+  class << self
+    # @param base_module [Class, Module]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def extended(base_module)
+      base_module.instance_variable_set(
+        :@plugin_registry, SmartCore::Initializer::Plugins::Registry.new
+      )
+      base_module.instance_variable_set(
+        :@access_lock, SmartCore::Engine::Lock.new
+      )
+    end
+  end
+
+  # @param plugin_name [Symbol, String]
+  # @return [void]
+  #
+  # @api public
+  # @since 0.1.0
+  def load(plugin_name)
+    thread_safe { plugin_registry[plugin_name].load! }
+  end
+
+  # @return [Array<String>]
+  #
+  # @api public
+  # @since 0.1.0
+  def loaded_plugins
+    thread_safe { plugin_registry.loaded.keys }
+  end
+
+  # @return [Array<String>]
+  #
+  # @api public
+  # @since 0.1.0
+  def names
+    thread_safe { plugin_registry.names }
+  end
+
+  # @param plugin_name [Symbol, String]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def register_plugin(plugin_name, plugin_module)
+    thread_safe { plugin_registry[plugin_name] = plugin_module }
+  end
+
+  private
+
+  # @return [SmartCore::Initializer::Plugins::Registry]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :plugin_registry
+
+  # @return [SmartCore::Engine::Lock]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :access_lock
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def thread_safe
+    access_lock.synchronize { yield if block_given? }
+  end
+end

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::Plugins::ThyTypes < SmartCore::Initializer::Plugins::Abstract
+  class << self
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def install!
+      raise(
+        SmartCore::Initializer::UnresolvedPluginDependencyError,
+        '::Thy does not exist or "thy" gem is not loaded'
+      ) unless const_defined?('::Thy')
+
+      # NOTE: require necessary dependencies
+      require 'date'
+
+      # NOTE: add thy-types type system implementation
+      require_relative 'thy_types/errors'
+      require_relative 'thy_types/thy_types'
+
+      # NOTE: register thy-types type system
+      SmartCore::Initializer::TypeSystem.register(
+        :thy_types, SmartCore::Initializer::TypeSystem::ThyTypes
+      )
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer
+  # @api public
+  # @since 0.1.0
+  ThyTypesError = Class.new(SmartCore::Initializer::Error)
+
+  # @api public
+  # @since 0.1.0
+  ThyTypeValidationError = Class.new(ThyTypesError)
+end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::TypeSystem
+  # @api public
+  # @since 0.1.0
+  class ThyTypes < Interop
+    require_relative 'thy_types/abstract_factory'
+    require_relative 'thy_types/operation'
+
+    type_alias(:any, AbstractFactory.generic_type_object)
+    type_alias(:nil, ::Thy::Types::Nil)
+    type_alias(:string, ::Thy::Types::String)
+    type_alias(:symbol, ::Thy::Types::Symbol)
+    type_alias(:integer, ::Thy::Types::Integer)
+    type_alias(:float, ::Thy::Types::Float)
+    type_alias(:numeric, ::Thy::Types::Numeric)
+    type_alias(:boolean, ::Thy::Types::Boolean)
+    type_alias(:time, ::Thy::Types::Time)
+    type_alias(:date_time, ::Thy::Types::DateTime)
+    type_alias(:untyped_array, ::Thy::Types::UntypedArray)
+    type_alias(:untyped_hash, ::Thy::Types::UntypedHash)
+  end
+end

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

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::TypeSystem
+  # @api private
+  # @since 0.1.0
+  class ThyTypes::AbstractFactory < Interop::AbstractFactory
+    # @return [Thy::Type]
+    #
+    # @api private
+    # @since 0.1.0
+    GENERIC_TYPE = ::Thy::Type.new { true }
+
+    class << self
+      # @param type [Thy::Type, #check]
+      # @return [void]
+      #
+      # @raise [SmartCore::Initializer::IncorrectTypeObjectError]
+      #
+      # @api private
+      # @since 0.1.0
+      def prevent_incompatible_type!(type)
+        unless type.respond_to?(:check) || type.is_a?(::Thy::Type)
+          raise(
+            SmartCore::Initializer::IncorrectTypeObjectError,
+            'Incorrect Thy::Type primitive ' \
+            '(type object should respond to :check method)'
+          )
+        end
+      end
+
+      # @param type [Thy::Type, #check]
+      # @return [SmartCore::Initializer::TypeSystem::ThyTypes::Operation::Valid]
+      #
+      # @api private
+      # @since 0.1.0
+      def build_valid_operation(type)
+        ThyTypes::Operation::Valid.new(type)
+      end
+
+      # @return [Thy::Type, #check]
+      #
+      # @api private
+      # @since 0.1.0
+      def generic_type_object
+        GENERIC_TYPE
+      end
+
+      # @param type [Thy::Type, #check]
+      # @return [SmartCore::Initializer::TypeSystem::ThyTypes::Operation::Validate]
+      #
+      # @api private
+      # @since 0.1.0
+      def build_validate_operation(type)
+        ThyTypes::Operation::Validate.new(type)
+      end
+
+      # @param type [Thy::Type, #check]
+      # @return [SmartCore::Initializer::TypeSystem::ThyTypes::Operation::Cast]
+      #
+      # @api private
+      # @since 0.1.0
+      def build_cast_operation(type)
+        ThyTypes::Operation::Cast.new(type)
+      end
+
+      # @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]
+      # @return [SmartCore::Initializer::TypeSystem::ThyTypes]
+      #
+      # @api private
+      # @since 0.1.0
+      def build_interop(valid_op, validate_op, cast_op)
+        ThyTypes.new(valid_op, validate_op, cast_op)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::TypeSystem
+  # @api private
+  # @since 0.1.0
+  module ThyTypes::Operation
+    require_relative 'operation/base'
+    require_relative 'operation/valid'
+    require_relative 'operation/validate'
+    require_relative 'operation/cast'
+  end
+end

data/lib/smart_core/initializer/plugins/thy_types/thy_types/operation/base.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::TypeSystem
+  # @abstract
+  # @api private
+  # @since 0.1.0
+  class ThyTypes::Operation::Base < Interop::Operation
+  end
+end

data/lib/smart_core/initializer/plugins/thy_types/thy_types/operation/cast.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::TypeSystem::ThyTypes::Operation
+  # @api private
+  # @since 0.1.0
+  class Cast < Base
+    # @param value [Any]
+    # @return [void]
+    #
+    # @raise [SmartCore::Initializer::TypeCastingUnsupportedError]
+    #
+    # @api private
+    # @since 0.1.0
+    def call(value)
+      raise(
+        SmartCore::Initializer::TypeCastingUnsupportedError,
+        'ThyTypes type system has no support for type casting.'
+      )
+    end
+  end
+end

data/lib/smart_core/initializer/plugins/thy_types/thy_types/operation/valid.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::TypeSystem::ThyTypes::Operation
+  # @api private
+  # @since 0.1.0
+  class Valid < Base
+    # @param value [Any]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.1.0
+    def call(value)
+      type.check(value).success?
+    end
+  end
+end

data/lib/smart_core/initializer/plugins/thy_types/thy_types/operation/validate.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module SmartCore::Initializer::TypeSystem::ThyTypes::Operation
+  # @api private
+  # @since 0.1.0
+  class Validate < Base
+    # @param value [Any]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def call(value)
+      raise(
+        SmartCore::Initializer::ThyTypeValidationError,
+        "Thy::Types validation error: (get #{value.inspect} for type #{type.inspect}"
+      ) unless type.check(value).success?
+    end
+  end
+end

data/lib/smart_core/initializer/settings.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::Settings
+  require_relative 'settings/type_system'
+  require_relative 'settings/duplicator'
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize
+    @type_system = TypeSystem.new
+  end
+
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def generic_type_object
+    @type_system.generic_type_object
+  end
+
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.1.0
+  def type_system
+    @type_system.resolve
+  end
+
+  # @param value [String, System]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def type_system=(value)
+    @type_system.assign(value)
+  end
+
+  # @return [SmartCore::Initializer::Settings]
+  #
+  # @api private
+  # @since 0.1.0
+  def dup
+    Duplicator.duplicate(self)
+  end
+end

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

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+module SmartCore::Initializer::Settings::Duplicator
+  class << self
+    # @param settings [SmartCore::Initializer::Settings]
+    # @return [SmartCore::Initializer::Settings]
+    #
+    # @api private
+    # @since 0.1.0
+    def duplicate(settings)
+      SmartCore::Initializer::Settings.new.tap do |new_instance|
+        type_system = settings.instance_variable_get(:@type_system).dup
+
+        new_instance.instance_variable_set(:@type_system, type_system)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::Settings::TypeSystem
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize
+    @type_system = nil
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def generic_type_object
+    thread_safe do
+      SmartCore::Initializer::TypeSystem.resolve(resolve).generic_type_object
+    end
+  end
+
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.1.0
+  def resolve
+    thread_safe do
+      @type_system || SmartCore::Initializer::Configuration.config[:default_type_system]
+    end
+  end
+
+  # @param value [String, Symbol]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def assign(value)
+    thread_safe do
+      SmartCore::Initializer::TypeSystem.resolve(value) # NOTE: type system existence validation
+      @type_system = 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