smart_injection 0.0.0.alpha3 → 0.0.0

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

@@ -1,113 +0,0 @@
-# frozen_string_literal: true
-
-# @api private
-# @since 0.1.0
-module SmartCore::Injection::Injector::InjectionSettings::IncompatabilityControl
-  class << self
-    # @param injectable [Class, Module]
-    # @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 prevent_incompatabilities!(injectable, imports, memoize, access, bind, from)
-      prevent_injectable_incompatabilities!(injectable)
-      prevent_imports_incompatabilites!(imports)
-      prevent_memoize_incompatabilites(memoize)
-      prevent_access_incompatabilites(access)
-      prevent_bind_incompatabilites(bind)
-      prevent_from_incompatabilites(from)
-    end
-
-    private
-
-    # @param injectable [Class, Module]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def prevent_injectable_incompatabilities!(injectable)
-      unless injectable.is_a?(Class) || injectable.is_a?(Module)
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-        ERROR_MESSAGE
-      end
-    end
-
-    # @param imports [Hash<String|Symbol,String>]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def prevent_imports_incompatabilites!(imports)
-      unless imports.is_a?(::Hash)
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-          Incorrect import list (should be a type of Hash)
-        ERROR_MESSAGE
-      end
-
-      unless imports.keys.all? { |key| key.is_a?(String) || key.is_a?(Symbol) }
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-          Some method aliases are incorret (they should be a type of String or Symbol)
-        ERROR_MESSAGE
-      end
-
-      unless imports.values.all? { |value| value.is_a?(String) }
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-          Some injection pathes are incorrect (they should be a type of String)
-        ERROR_MESSAGE
-      end
-    end
-
-    # @param memoize [Boolean]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def prevent_memoize_incompatabilites(memoize)
-      unless memoize.is_a?(::TrueClass) || memoize.is_a?(::FalseClass)
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-        ERROR_MESSAGE
-      end
-    end
-
-    # @param access [Symbol]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def prevent_access_incompatabilites(access)
-      unless SmartCore::Injection::Injector::InjectionSettings::ACCESS_MARKS.include?(access)
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-        ERROR_MESSAGE
-      end
-    end
-
-    # @param bind [Symbol]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def prevent_bind_incompatabilites(bind)
-      unless SmartCore::Injection::Injector::InjectionSettings::BINDING_STRATEGIES.include?(bind)
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-        ERROR_MESSAGE
-      end
-    end
-
-    # @param from [NilClass, SmartCore::Container]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def prevent_from_incompatabilites(from)
-      unless from.is_a?(NilClass) || from.is_a?(SmartCore::Container)
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-        ERROR_MESSAGE
-      end
-    end
-  end
-end

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

@@ -1,173 +0,0 @@
-# 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

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

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-# @api private
-# @since 0.1.0
-module SmartCore::Injection::Injector::Modulizer
-  class << self
-    # @param containers [Array<SmartCore::Container>]
-    # @return [Module]
-    #
-    # @api private
-    # @since 0.1.0
-    def with_containers(containers)
-      prevent_inconsistency!(containers)
-      build_container_injectable_module(containers)
-    end
-
-    # @param base_klass [Class, Module]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def inject_to(base_klass)
-      base_klass.include(::SmartCore::Injection::DSL)
-    end
-
-    private
-
-    # @param containers [Array<SmartCore::Container>]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def prevent_inconsistency!(containers)
-      unless containers.is_a?(Array) && containers.all? { |cont| cont.is_a?(SmartCore::Container) }
-        raise(SmartCore::Injection::ArgumentError, <<~ERROR_MESSAGE)
-          Injectable containers should be a type of SmartCore::Container
-        ERROR_MESSAGE
-      end
-    end
-
-    # @param containers [Array<SmartCore::Container>]
-    # @return [Module]
-    #
-    # @api private
-    # @since 0.1.0
-    def build_container_injectable_module(containers)
-      Module.new do
-        define_singleton_method :included do |base_klass|
-          base_klass.include(::SmartCore::Injection::DSL)
-          base_klass.register_container(*containers)
-        end
-      end
-    end
-  end
-end

data/lib/smart_core/injection/injector/strategies/method_injection.rb

@@ -1,92 +0,0 @@
-# frozen_string_literal: true
-
-# @api private
-# @since 0.1.0
-module SmartCore::Injection::Injector::Strategies::MethodInjection
-  class << self
-    # @param injection_settings [SmartCore::Injection::Injector::InjectionSettings]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def inject_instance_method(injection_settings)
-      inject_dependency(injection_settings, injection_settings.instance_level_injectable)
-    end
-
-    # @param injection_settings [SmartCore::Injection::Injector::InjectionSettings]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def inject_class_method(injection_settings)
-      inject_dependency(injection_settings, injection_settings.class_level_injectable)
-    end
-
-    private
-
-    # @param injection_settings [SmartCore::Injection::Injector::InjectionSettings]
-    # @param injectable [Class, Module]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def inject_dependency(injection_settings, injectable)
-      injection_settings.each_import do |import_key, import_path|
-        locator = build_locator(injection_settings, import_key, import_path)
-        process_injection_bindings(injection_settings, locator)
-        injection = build_injection(injection_settings, import_key, locator)
-        inject_injection(injection_settings, injection, injectable)
-      end
-    end
-
-    # @param injection_settings [SmartCore::Injection::Injector::InjectionSettings]
-    # @param import_key [String, Symbol]
-    # @param import_path [String]
-    # @return [SmartCore::Injection::Locator]
-    #
-    # @api private
-    # @since 0.1.0
-    def build_locator(injection_settings, import_key, import_path)
-      SmartCore::Injection::Locator::Factory.create(injection_settings, import_key, import_path)
-    end
-
-    # @param locator [SmartCore::Injection::Locator]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def process_injection_bindings(injection_settings, locator)
-      locator.bind! if injection_settings.bind_static?
-    end
-
-    # @param injection_settings [SmartCore::Injection::Injector::InjectionSettings]
-    # @param import_key [String, Symbol]
-    # @param locator [SmartCore::Injection::Locator]
-    # @return [Module]
-    #
-    # @api private
-    # @since 0.1.0
-    def build_injection(injection_settings, import_key, locator)
-      Module.new do
-        define_method(import_key) { locator.resolve_dependency }
-
-        case injection_settings.access
-        when :public then public(import_key)
-        when :private then private(import_key)
-        when :protected then protected(import_key)
-        end
-      end
-    end
-
-    # @param injection_settings [SmartCore::Injection::Injector::InjectionSettings]
-    # @param injection [Module]
-    # @param injectable [Class, Module]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.1.0
-    def inject_injection(injection_settings, injection, injectable)
-      injectable.include(injection)
-    end
-  end
-end

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

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-# @api private
-# @since 0.1.0
-module SmartCore::Injection::Injector::Strategies
-  require_relative 'strategies/method_injection'
-end

data/lib/smart_core/injection/injector.rb

@@ -1,165 +0,0 @@
-# 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
-
-  # @param another_injectable [Class, Module]
-  # @return [SmartCore::Injection::Injector]
-  #
-  # @api private
-  # @since 0.1.0
-  def duplicate_for(another_injectable)
-    thread_safe { create_duplicate(another_injectable) }
-  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 another_injectable [Class, Module]
-  # @return [SmartCore::Injection::Injector]
-  #
-  # @api private
-  # @since 0.1.0
-  def create_duplicate(another_injectable)
-    self.class.new(another_injectable).tap do |duplicate|
-      linked_containers.each do |container|
-        duplicate.register_container(container)
-      end
-    end
-  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_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