smart_injection 0.0.0.alpha

data/lib/smart_core/injection.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'smart_core/container'
+require 'set'
+
+# @api public
+# @since 0.1.0
+module SmartCore
+  # TODO: обязательно учесть наследование
+
+  class << self
+    # @param containers [Array<SmartCore::Container>]
+    # @return [Module]
+    #
+    # @api public
+    # @since 0.1.0
+    # rubocop:disable Naming/MethodName
+    def Injection(*containers)
+      ::SmartCore::Injection::Injector::Modulizer.with_containers(containers)
+    end
+    # rubocop:enable Naming/MethodName
+  end
+
+  # @api public
+  # @since 0.1.0
+  module Injection
+    require_relative 'injection/version'
+    require_relative 'injection/injector'
+    require_relative 'injection/locator'
+    require_relative 'injection/dsl'
+
+    class << self
+      # @param base_klass [Class, Module]
+      # @return [void]
+      #
+      # @api private
+      # @since 0.1.0
+      def included(base_klass)
+        ::SmartCore::Injection::Injector::Modulizer.inject_to(base_klass)
+      end
+    end
+  end
+end

data/lib/smart_core/injection/dsl.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.1.0
+module SmartCore::Injection::DSL
+  class << self
+    # @param base_klass [Class, Module]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def included(base_klass)
+      base_klass.instance_variable_set(
+        :@__smart_injection_injector__,
+        SmartCore::Injection::Injector.new(base_klass)
+      )
+      base_klass.extend(ClassMethods)
+    end
+  end
+
+  # @api private
+  # @since 0.1.0
+  module ClassMethods
+    # @param imports [Hash<String|Symbol,String>]
+    # @option memoize [Boolean]
+    # @option access [Symbol]
+    # @option bind [Symbol]
+    # @option from [NilClass, SmartCore::Container]
+    # @return [void]
+    #
+    # @api public
+    # @sincd 0.1.0
+    def import(
+      imports,
+      memoize: SmartCore::Injection::Injector::InjectionSettings::DEFAULT_MEMOIZE,
+      access: SmartCore::Injection::Injector::InjectionSettings::DEFAULT_ACCESS,
+      bind: SmartCore::Injection::Injector::InjectionSettings::DEFAULT_BINDING_STRATEGY,
+      from: SmartCore::Injection::Injector::InjectionSettings::EMPTY_CONTAINER_DESTINATION
+    )
+      __smart_injection_injector__.inject(imports, memoize, access, bind, from)
+    end
+
+    # @param imports [Hash<String|Symbol,String>]
+    # @option memoize [Boolean]
+    # @option access [Symbol]
+    # @option bind [Symbol]
+    # @option from [NilClass, SmartCore::Container]
+    # @return [void]
+    #
+    # @api public
+    # @sincd 0.1.0
+    def import_static(
+      imports,
+      memoize: SmartCore::Injection::Injector::InjectionSettings::DEFAULT_MEMOIZE,
+      access: SmartCore::Injection::Injector::InjectionSettings::DEFAULT_ACCESS,
+      bind: SmartCore::Injection::Injector::InjectionSettings::DEFAULT_BINDING_STRATEGY,
+      from: SmartCore::Injection::Injector::InjectionSettings::EMPTY_CONTAINER_DESTINATION
+    )
+      __smart_injection_injector__.inject_static(imports, memoize, access, bind, from)
+    end
+
+    # @param containers [Array<SmartCore::Container>]
+    # @return [void]
+    #
+    # @api public
+    # @since 0.1.0
+    def register_container(*containers)
+      __smart_injection_injector__.register_container(containers)
+    end
+
+    # @return [Array<SmartCore::Container>]
+    #
+    # @api public
+    # @since 0.1.0
+    def linked_containers
+      __smart_injection_injector__.associated_containers
+    end
+
+    private
+
+    # @return [SmartCore::Injection::Injector]
+    #
+    # @api private
+    # @since 0.1.0
+    attr_reader :__smart_injection_injector__
+  end
+end

data/lib/smart_core/injection/errors.rb

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

data/lib/smart_core/injection/injector.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Injection::Injector
+  require_relative 'injector/container_set'
+  require_relative 'injector/injection_settings'
+  require_relative 'injector/modulizer'
+  require_relative 'injector/strategies'
+
+  # @param injectable [Class, Module]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize(injectable)
+    @injectable = injectable
+    @linked_containers = SmartCore::Injection::Injector::ContainerSet.new
+    @access_lock = SmartCore::Engine::Lock.new
+  end
+
+  # @param imports [Hash<String|Symbol,String>]
+  # @param memoize [Boolean]
+  # @param access [Symbol]
+  # @param bind [Symbol]
+  # @param from [NilClass, SmartCore::Container]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def inject(imports, memoize, access, bind, from)
+    thread_safe { inject_instance_method(imports, memoize, access, bind, from) }
+  end
+
+  # @param imports [Hash<String|Symbol,String>]
+  # @param memoize [Boolean]
+  # @param access [Symbol]
+  # @param bind [Symbol]
+  # @param from [NilClass, SmartCore::Container]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def inject_static(imports, memoize, access, bind, from)
+    thread_safe { inject_class_method(imports, memoize, access, bind, from) }
+  end
+
+  # @param containers [Array<SmartCore::Container>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def register_container(containers)
+    thread_safe { link_container(containers) }
+  end
+
+  # @return [Array<SmartCore::Container>]
+  #
+  # @api private
+  # @since 0.1.0
+  def associated_containers
+    thread_safe { linked_containers.list }
+  end
+
+  private
+
+  # @return [Class, Module]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :injectable
+
+  # @return [Array<SmartCore::Container>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :linked_containers
+
+  # @param imports [Hash<String|Symbol,String>]
+  # @param memoize [Boolean]
+  # @param access [Symbol]
+  # @param bind [Symbol]
+  # @param from [NilClass, SmartCore::Container]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def inject_instance_method(imports, memoize, access, bind, from)
+    SmartCore::Injection::Injector::Strategies::MethodInjection.inject_instance_method(
+      SmartCore::Injection::Injector::InjectionSettings.new(
+        injectable,
+        linked_containers,
+        imports,
+        memoize: memoize,
+        access: access,
+        bind: bind,
+        from: from
+      )
+    )
+  end
+
+  # @param imports [Hash<String|Symbol,String>]
+  # @param memoize [Boolean]
+  # @param access [Symbol]
+  # @param bind [Symbol]
+  # @param from [NilClass, SmartCore::Container]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def inject_class_method(imports, memoize, access, bind, from)
+    SmartCore::Injection::Injector::Strategies::MethodInjection.inject_class_method(
+      SmartCore::Injection::Injector::InjectionSettings.new(
+        injectable,
+        linked_containers,
+        imports,
+        memoize: memoize,
+        access: access,
+        bind: bind,
+        from: from
+      )
+    )
+  end
+
+  # @param containers [Array<SmartCore::Container>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def link_container(containers)
+    containers.each do |container|
+      linked_containers.add(container)
+    end
+  end
+
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def thread_safe(&block)
+    @access_lock.synchronize(&block)
+  end
+end

data/lib/smart_core/injection/injector/container_set.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Injection::Injector::ContainerSet
+  # @since 0.1.0
+  include Enumerable
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize
+    @containers = [] # NOTE: we use Array cuz we need an ordered set
+    @access_lock = SmartCore::Engine::Lock.new
+  end
+
+  # @param container [SmartCore::Container]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def add(container)
+    thread_safe { append_container(container) }
+  end
+  alias_method :<<, :add
+
+  # @param block [Block]
+  # @yield [container]
+  # @yieldparam container [SmartCore::Container]
+  # @return [Enumerator]
+  #
+  # @api private
+  # @since 0.1.0
+  def each(&block)
+    thread_safe { block_given? ? containers.each(&block) : containers.each }
+  end
+
+  # @param block [Block]
+  # @yield [container]
+  # @yieldparam container [SmartCore::Container]
+  # @return [Enumerator]
+  #
+  # @api private
+  # @since 0.1.0
+  def reverse_each(&block)
+    thread_safe { block_given? ? containers.reverse_each(&block) : containers.reverse_each }
+  end
+
+  # @return [Array<SmartCore::Container>]
+  #
+  # @api private
+  # @since 0.1.0
+  def list
+    thread_safe { containers.dup }
+  end
+
+  private
+
+  # @return [Array<SmartCore::Container>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :containers
+
+  # @param container [SmartCore::Container]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def append_container(container)
+    # NOTE:
+    #   - #concant is used to prevent container duplications in ordered set;
+    #   - @containers should have an ordered unified container list;
+    containers.concat([container])
+  end
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def thread_safe(&block)
+    @access_lock.synchronize(&block)
+  end
+end

data/lib/smart_core/injection/injector/injection_settings.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Injection::Injector::InjectionSettings
+  require_relative 'injection_settings/incompatability_control'
+
+  # @return [Hash<String|Symbol,String>]
+  #
+  # @api private
+  # @since 0.1.0
+  DEFAULT_IMPORTS = {}.freeze
+
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.1.0
+  DEFAULT_ACCESS = :public
+
+  # @return [Array<Symbol>]
+  #
+  # @api private
+  # @since 0.1.0
+  ACCESS_MARKS = %i[public protected private].freeze
+
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.1.0
+  DEFAULT_BINDING_STRATEGY = :dynamic
+
+  # @return [Array<Symbol>]
+  #
+  # @api private
+  # @since 0.1.0
+  BINDING_STRATEGIES = %i[static dynamic].freeze
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.1.0
+  DEFAULT_MEMOIZE = false
+
+  # @return [NilClass]
+  #
+  # @api private
+  # @since 0.1.0
+  EMPTY_CONTAINER_DESTINATION = nil
+
+  # @return [Hash<String|Symbol,String>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :imports
+
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :access
+
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :bind
+
+  # @return [NilClass, <SmartCore::Container>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :from
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :memoize
+
+  # @return [SmartCore::Injection::Injector::ContainerSet]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :container_set
+
+  # @return [Class, Module]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :injectable
+
+  # @param injectable [Class, Module]
+  # @param container_set [SmartCore::Injection::Injector::ContainerSet]
+  # @param import [Hash<String|Symbol,String>]
+  # @option memoize [Boolean]
+  # @option access [Symbol]
+  # @option bind [Symbol]
+  # @option from [NilClass, SmartCore::Container]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize(
+    injectable,
+    container_set,
+    imports,
+    memoize: DEFAULT_MEMOIZE,
+    access: DEFAULT_ACCESS,
+    bind: DEFAULT_BINDING_STRATEGY,
+    from: EMPTY_CONTAINER_DESTINATION
+  )
+    IncompatabilityControl.prevent_incompatabilities!(
+      injectable,
+      imports,
+      memoize,
+      access,
+      bind,
+      from
+    )
+
+    @injectable = injectable
+    @container_set = container_set
+    @imports = imports
+    @memoize = memoize
+    @access = access
+    @bind = bind
+    @from = from
+  end
+
+  # @return [Class, Module]
+  #
+  # @api private
+  # @since 0.1.0
+  def instance_level_injectable
+    injectable
+  end
+
+  # @return [Class]
+  #
+  # @api private
+  # @since 0.1.0
+  def class_level_injectable
+    class << injectable; self; end
+  end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.1.0
+  def bind_dynamic?
+    bind == :dynamic
+  end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.1.0
+  def bind_static?
+    bind == :static
+  end
+
+  # @param block [Block]
+  # @yield [import_key, import_path]
+  # @yieldparam import_key [String, Symbol]
+  # @yieldparam import_path [String]
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.1.0
+  def each_import(&block)
+    block_given? ? imports.each_pair(&block) : imports.each_pair
+  end
+end