smart_container 0.1.0

data/lib/smart_core/container/arbitary_lock.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Container::ArbitaryLock
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize
+    @lock = Mutex.new
+  end
+
+  # @param block [Proc]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def thread_safe(&block)
+    @lock.owned? ? yield : @lock.synchronize(&block)
+  end
+end

data/lib/smart_core/container/definition_dsl.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+class SmartCore::Container
+  # @api private
+  # @since 0.1.0
+  module DefinitionDSL
+    require_relative 'definition_dsl/commands'
+    require_relative 'definition_dsl/command_set'
+    require_relative 'definition_dsl/inheritance'
+
+    class << self
+      # @param base_klass [Class<SmartCore::Container>]
+      # @return [void]
+      #
+      # @api private
+      # @since 0.1.0
+      def included(base_klass)
+        base_klass.instance_variable_set(:@__container_definition_commands__, CommandSet.new)
+        base_klass.instance_variable_set(:@__container_instantiation_commands__, CommandSet.new)
+        base_klass.instance_variable_set(:@__container_definition_lock__, ArbitaryLock.new)
+        base_klass.singleton_class.send(:attr_reader, :__container_definition_commands__)
+        base_klass.singleton_class.send(:attr_reader, :__container_instantiation_commands__)
+        base_klass.extend(ClassMethods)
+        base_klass.singleton_class.prepend(ClassInheritance)
+      end
+    end
+
+    # @api private
+    # @since 0.1.0
+    module ClassInheritance
+      # @param child_klass [Class<SmartCore::Container>]
+      # @return [void]
+      #
+      # @api private
+      # @since 0.1.0
+      def inherited(child_klass)
+        child_klass.instance_variable_set(:@__container_definition_commands__, CommandSet.new)
+        child_klass.instance_variable_set(:@__container_instantiation_commands__, CommandSet.new)
+        child_klass.instance_variable_set(:@__container_definition_lock__, ArbitaryLock.new)
+        SmartCore::Container::DefinitionDSL::Inheritance.inherit(base: self, child: child_klass)
+        child_klass.singleton_class.prepend(ClassInheritance)
+        super
+      end
+    end
+
+    # @api private
+    # @since 0.1.0
+    module ClassMethods
+      # @param namespace_name [String, Symbol]
+      # @param dependencies_definition [Block]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.1.0
+      def namespace(namespace_name, &dependencies_definition)
+        @__container_definition_lock__.thread_safe do
+          DependencyCompatability::Definition.prevent_dependency_overlap!(self, namespace_name)
+
+          __container_definition_commands__ << Commands::Definition::Namespace.new(
+            namespace_name, dependencies_definition
+          )
+        end
+      end
+
+      # @param dependency_name [String, Symbol]
+      # @param dependency_definition [Block]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.1.0
+      def register(dependency_name, &dependency_definition)
+        @__container_definition_lock__.thread_safe do
+          DependencyCompatability::Definition.prevent_namespace_overlap!(self, dependency_name)
+
+          __container_definition_commands__ << Commands::Definition::Register.new(
+            dependency_name, dependency_definition
+          )
+        end
+      end
+
+      # @param container_klass [Class<SmartCore::Container>]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.1.0
+      def compose(container_klass)
+        @__container_definition_lock__.thread_safe do
+          __container_definition_commands__ << Commands::Definition::Compose.new(
+            container_klass
+          )
+
+          __container_instantiation_commands__ << Commands::Instantiation::Compose.new(
+            container_klass
+          )
+        end
+      end
+
+      # @return [void]
+      #
+      # @api public
+      # @since 0.1.0
+      def freeze_state!
+        @__container_definition_lock__.thread_safe do
+          __container_instantiation_commands__ << Commands::Instantiation::FreezeState.new
+        end
+      end
+    end
+  end
+end

data/lib/smart_core/container/definition_dsl/command_set.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Container::DefinitionDSL::CommandSet
+  # @since 0.1.0
+  include Enumerable
+
+  # @return [Array<SmartCore::Container::DefinitionDSL::Commands::Base>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :commands
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize
+    @commands = []
+    @access_lock = SmartCore::Container::ArbitaryLock.new
+  end
+
+  # @param [SmartCore::Container::DefinitionDSL::Commands::Base]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def add_command(command)
+    thread_safe { commands << command }
+  end
+  alias_method :<<, :add_command
+
+  # @param block [Block]
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.1.0
+  def each(&block)
+    thread_safe { block_given? ? commands.each(&block) : commands.each }
+  end
+
+  # @param command_set [SmartCore::Container::DefinitionDSL::CommandSet]
+  # @param concat_condition [Block]
+  # @yield [command]
+  # @yieldparam command [SmartCore::Container::DefinitionDSL::Commands::Base]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def concat(command_set, &concat_condition)
+    thread_safe do
+      if block_given?
+        command_set.dup.each { |command| (commands << command) if yield(command) }
+      else
+        # :nocov:
+        commands.concat(command_set.dup.commands) # NOTE: unreachable code at this moment
+        # :nocov:
+      end
+    end
+  end
+
+  # @return [SmartCore::Container::DefinitionDSL::CommandSet]
+  #
+  # @api private
+  # @since 0.1.0
+  def dup
+    thread_safe do
+      self.class.new.tap do |duplicate|
+        commands.each do |command|
+          duplicate.add_command(command.dup)
+        end
+      end
+    end
+  end
+
+  private
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def thread_safe(&block)
+    @access_lock.thread_safe(&block)
+  end
+end

data/lib/smart_core/container/definition_dsl/commands.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+module SmartCore::Container::DefinitionDSL::Commands
+  require_relative 'commands/base'
+  require_relative 'commands/instantiation'
+  require_relative 'commands/definition'
+end

data/lib/smart_core/container/definition_dsl/commands/base.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Container::DefinitionDSL::Commands::Base
+  class << self
+    # @param identifier [Boolean]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.19.0
+    def inheritable=(identifier)
+      @inheritable = identifier
+    end
+
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.19.0
+    def inheritable?
+      @inheritable
+    end
+
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.19.0
+    def inherited(child_klass)
+      child_klass.instance_variable_set(:@inheritable, true)
+      super
+    end
+  end
+
+  # @param regsitry [SmartCore::Container::Registry]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def call(registry); end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.19.0
+  def inheritable?
+    self.class.inheritable?
+  end
+end

data/lib/smart_core/container/definition_dsl/commands/definition.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+module SmartCore::Container::DefinitionDSL::Commands::Definition
+  require_relative 'definition/namespace'
+  require_relative 'definition/register'
+  require_relative 'definition/compose'
+end

data/lib/smart_core/container/definition_dsl/commands/definition/compose.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module SmartCore::Container::DefinitionDSL::Commands::Definition
+  # @api private
+  # @since 0.1.0
+  class Compose < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @since 0.1.0
+    self.inheritable = true
+
+    # @param container_klass [Class<SmartCore::Container>]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def initialize(container_klass)
+      raise(
+        SmartCore::ArgumentError,
+        'Container class should be a subtype of Quantum::Container'
+      ) unless container_klass < SmartCore::Container
+
+      @container_klass = container_klass
+    end
+
+    # @param registry [SmartCore::Container::Registry]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def call(registry)
+      SmartCore::Container::RegistryBuilder.build_definitions(container_klass, registry)
+    end
+
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Definition::Compose]
+    #
+    # @api private
+    # @since 0.1.0
+    def dup
+      self.class.new(container_klass)
+    end
+
+    private
+
+    # @return [Class<SmartCore::Container>]
+    #
+    # @api private
+    # @since 0.1.0
+    attr_reader :container_klass
+  end
+end

data/lib/smart_core/container/definition_dsl/commands/definition/namespace.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module SmartCore::Container::DefinitionDSL::Commands::Definition
+  # @api private
+  # @since 0.1.0
+  class Namespace < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @since 0.1.0
+    self.inheritable = true
+
+    # @return [String]
+    #
+    # @api private
+    # @since 0.1.0
+    attr_reader :namespace_name
+
+    # @param namespace_name [String, Symbol]
+    # @param dependencies_definition [Proc]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def initialize(namespace_name, dependencies_definition)
+      SmartCore::Container::KeyGuard.indifferently_accessable_key(namespace_name).tap do |name|
+        @namespace_name = name
+        @dependencies_definition = dependencies_definition
+      end
+    end
+
+    # @param registry [SmartCore::Container::Registry]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def call(registry)
+      registry.register_namespace(namespace_name, &dependencies_definition)
+    end
+
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Definition::Namespace]
+    #
+    # @api private
+    # @since 0.1.0
+    def dup
+      self.class.new(namespace_name, dependencies_definition)
+    end
+
+    private
+
+    # @return [Proc]
+    #
+    # @api private
+    # @since 0.1.0
+    attr_reader :dependencies_definition
+  end
+end

data/lib/smart_core/container/definition_dsl/commands/definition/register.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module SmartCore::Container::DefinitionDSL::Commands::Definition
+  # @api private
+  # @since 0.1.0
+  class Register < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @since 0.1.0
+    self.inheritable = true
+
+    # @return [String]
+    #
+    # @api private
+    # @since 0.1.0
+    attr_reader :dependency_name
+
+    # @param dependency_name [String, Symbol]
+    # @param dependency_definition [Proc]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def initialize(dependency_name, dependency_definition)
+      SmartCore::Container::KeyGuard.indifferently_accessable_key(dependency_name).tap do |name|
+        @dependency_name = name
+        @dependency_definition = dependency_definition
+      end
+    end
+
+    # @param registry [SmartCore::Container::Registry]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.1.0
+    def call(registry)
+      registry.register_dependency(dependency_name, &dependency_definition)
+    end
+
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Definition::Register]
+    #
+    # @api private
+    # @since 0.1.0
+    def dup
+      self.class.new(dependency_name, dependency_definition)
+    end
+
+    private
+
+    # @return [Proc]
+    #
+    # @api private
+    # @since 0.1.0
+    attr_reader :dependency_definition
+  end
+end