smart_initializer 0.1.0.alpha4 → 0.1.0

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

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::TypeSystem::Interop::Aliasing::AliasList
+  # @param interop_klass [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize(interop_klass)
+    @interop_klass = interop_klass
+    @list = {}
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @return [Array<String>]
+  #
+  # @api private
+  # @since 0.1.0
+  def keys
+    thread_safe { registered_aliases }
+  end
+
+  # @return [Hash<String,Any>]
+  #
+  # @api private
+  # @since 0.1.0
+  def to_h
+    thread_safe { transform_to_hash }
+  end
+  alias_method :to_hash, :to_h
+
+  # @param alias_name [String, Symbol]
+  # @param type [Any]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def associate(alias_name, type)
+    interop_klass.prevent_incompatible_type!(type)
+    thread_safe { set_alias(alias_name, type) }
+  end
+
+  # @param alias_name [String, Symbol]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def resolve(alias_name)
+    thread_safe { get_alias(alias_name) }
+  end
+
+  private
+
+  # @return [Hash<String,Any>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :list
+
+  # @return [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :interop_klass
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def thread_safe(&block)
+    @lock.synchronize(&block)
+  end
+
+  # @param alias_name [String, Symbol]
+  # @param type [Any]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def set_alias(alias_name, type)
+    alias_name = normalized_alias(alias_name)
+
+    if list.key?(alias_name)
+      ::Warning.warn(
+        "[#{interop_klass.name}] Shadowing of the already existing \"#{alias_name}\" type alias."
+      )
+    end
+
+    list[alias_name] = type
+  end
+
+  # @param alias_name [String, Symbol]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def get_alias(alias_name)
+    alias_name = normalized_alias(alias_name)
+
+    begin
+      list.fetch(alias_name)
+    rescue ::KeyError
+      raise(SmartCore::Initializer::TypeAliasNotFoundError, <<~ERROR_MESSAGE)
+        Alias with name "#{alias_name}" not found.
+      ERROR_MESSAGE
+    end
+  end
+
+  # @param alias_name [String, Symbol]
+  # @return [String]
+  #
+  # @api private
+  # @since 0.1.0
+  def normalized_alias(alias_name)
+    raise(
+      SmartCore::Initializer::ArgumentError,
+      'Type alias should be a type of string or symbol'
+    ) unless alias_name.is_a?(String) || alias_name.is_a?(Symbol)
+
+    alias_name.to_s
+  end
+
+  # @return [Hash<String,Any>]
+  #
+  # @api private
+  # @since 0.1.0
+  def transform_to_hash
+    list.to_h
+  end
+
+  # @return [Array<String>]
+  #
+  # @api private
+  # @since 0.1.0
+  def registered_aliases
+    list.keys
+  end
+end

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# @abstract
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::TypeSystem::Interop::Operation
+  # @param type [Any]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize(type)
+    @type = type
+  end
+
+  # @param value [Any]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def call(value); end
+
+  private
+
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :type
+end

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

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::TypeSystem::Registry
+  # @since 0.1.0
+  include Enumerable
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize
+    @systems = {}
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @param system_identifier [String, Symbol]
+  # @param interop_klass [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def register(system_identifier, interop_klass)
+    thread_safe { apply(system_identifier, interop_klass) }
+  end
+
+  # @param system_identifier [String, Symbol]
+  # @return [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  #
+  # @api private
+  # @since 0.1.0
+  def resolve(system_identifier)
+    thread_safe { fetch(system_identifier) }
+  end
+
+  # @return [Array<String>]
+  #
+  # @api private
+  # @since 0.1.0
+  def names
+    thread_safe { system_names }
+  end
+
+  # @return [Array<Class<SmartCore::Initializer::TypeSystem::Interop>>]
+  #
+  # @api private
+  # @since 0.1.0
+  def interops
+    thread_safe { system_interops }
+  end
+
+  # @param block [Block]
+  # @yield [system_name, system_interop]
+  #   @yieldparam system_name [String]
+  #   @yieldparam system_interop [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.1.0
+  def each(&block)
+    thread_safe { iterate(&block) }
+  end
+
+  # @return [Hash<String,Class<SmartCore::Initializer::TypeSystem::Interop>]
+  #
+  # @api private
+  # @since 0.1.0
+  def to_h
+    thread_safe { systems.dup }
+  end
+  alias_method :to_hash, :to_h
+
+  private
+
+  # @return [Hash<String,Class<SmartCore::Initializer::TypeSystem::Interop>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :systems
+
+  # @return [Array<String>]
+  #
+  # @pai private
+  # @since 0.1.0
+  def system_names
+    systems.keys
+  end
+
+  # @return [Array<Class<SmartCore::Initializer::TypeSystem::Interop>>]
+  #
+  # @api private
+  # @since 0.1.0
+  def system_interops
+    systems.values
+  end
+
+  # @param block [Block]
+  # @yield [system_name, system_interop]
+  #   @yieldparam system_name [String]
+  #   @yieldparam system_interop [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.1.0
+  def iterate(&block)
+    block_given? ? systems.each_pair(&block) : systems.each_pair
+  end
+
+  # @param system_identifier [String, Symbol]
+  # @param interop_klass [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def apply(system_identifier, interop_klass)
+    prevent_incorrect_system_interop!(interop_klass)
+    identifier = indifferently_accessible_identifier(system_identifier)
+    systems[identifier] = interop_klass
+  end
+
+  # @param system_identifier [String, Symbol]
+  # @return [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  #
+  # @raise [SmartCore::Initializer::UnsupportedTypeSystemError]
+  #
+  # @api private
+  # @since 0.1.0
+  def fetch(system_identifier)
+    identifier = indifferently_accessible_identifier(system_identifier)
+
+    begin
+      systems.fetch(identifier)
+    rescue ::KeyError
+      raise(SmartCore::Initializer::UnsupportedTypeSystemError, <<~ERROR_MESSAGE)
+        "#{identifier}" type system is not supported.
+      ERROR_MESSAGE
+    end
+  end
+
+  # @param interop_klass [Class<SMartCore::Initializer::TypeSystem::Interop>]
+  # @return [void]
+  #
+  # @raise [SmartCore::Initializer::IncorrectTypeSystemInteropError]
+  #
+  # @api private
+  # @since 0.1.0
+  def prevent_incorrect_system_interop!(interop_klass)
+    unless interop_klass.is_a?(Class) && interop_klass < SmartCore::Initializer::TypeSystem::Interop
+      raise(
+        SmartCore::Initializer::IncorrectTypeSystemInteropError,
+        'Incorrect type system interop class.'
+      )
+    end
+  end
+
+  # @param system_identifier [String, Symbol]
+  # @return [String]
+  #
+  # @api private
+  # @since 0.1.0
+  def indifferently_accessible_identifier(system_identifier)
+    system_identifier.to_s.clone.tap(&:freeze)
+  end
+
+  # @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/type_system/registry_interface.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+module SmartCore::Initializer::TypeSystem::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(
+        :@registry, SmartCore::Initializer::TypeSystem::Registry.new
+      )
+      base_module.instance_variable_set(
+        :@access_lock, SmartCore::Engine::Lock.new
+      )
+    end
+  end
+
+  # @option system_identifier [String, Symbol]
+  # @option type [Any]
+  # @return [SmartCore::Initializer::TypeSystem::Interop]
+  #
+  # @api private
+  # @since 0.1.0
+  def build_interop(system: system_identifier, type: type_object)
+    thread_safe { registry.resolve(system_identifier).create(type_object) }
+  end
+
+  # @param identifier [String, Symbol]
+  # @param interop_klass [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def register(identifier, interop_klass)
+    thread_safe { registry.register(identifier, interop_klass) }
+  end
+
+  # @param identifier [String, Symbol]
+  # @return [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  #
+  # @api private
+  # @since 0.1.0
+  def resolve(identifier)
+    thread_safe { registry.resolve(identifier) }
+  end
+  alias_method :[], :resolve
+
+  # @return [Array<String>]
+  #
+  # @api public
+  # @since 0.1.0
+  def names
+    thread_safe { registry.names }
+  end
+
+  # @return [Array<Class<SmartCore::Initializer::TypeSystem::Interop>>]
+  #
+  # @api public
+  # @since 0.1.0
+  def systems
+    thread_safe { registry.to_h }
+  end
+
+  # @param block [Block]
+  # @yield [system_name, system_interop]
+  #   @yieldparam system_name [String]
+  #   @yieldparam system_interop [Class<SmartCore::Initializer::TypeSystem::Interop>]
+  # @return [Enumerable]
+  #
+  # @api public
+  # @since 0.1.0
+  def each(&block)
+    thread_safe { registry.each(&block) }
+  end
+
+  private
+
+  # @return [SmartCore::Initializer::TypeSystem::Registry]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :registry
+
+  # @return [SmartCore::Engine::Lock]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :access_lock
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api pribate
+  # @since 0.1.0
+  def thread_safe(&block)
+    access_lock.synchronize(&block)
+  end
+end