smart_core 0.6.0 → 0.7.0

data/lib/smart_core/container/{command_set.rb → definition_dsl/command_set.rb}

@@ -1,56 +1,58 @@
 # frozen_string_literal: true
 
 # @api private
-# @since 0.5.0
-class SmartCore::Container::CommandSet
-  # @since 0.5.0
+# @since 0.7.0
+class SmartCore::Container::DefinitionDSL::CommandSet
+  # @since 0.7.0
   include Enumerable
 
-  # @return [Array<SmartCore::Container::Commands::Base>]
+  # @return [Array<SmartCore::Container::DefinitionDSL::Commands::Base>]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.7.0
   attr_reader :commands
 
+  # @return [void]
+  #
   # @api private
-  # @since 0.5.0
+  # @since 0.7.0
   def initialize
     @commands = []
-    @access_lock = Mutex.new
+    @access_lock = SmartCore::Container::ArbitaryLock.new
   end
 
-  # @param command [SmartCore::Container::Commands::Base]
+  # @param [SmartCore::Container::DefinitionDSL::Commands::Base]
   # @return [void]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.7.0
   def add_command(command)
     thread_safe { commands << command }
   end
   alias_method :<<, :add_command
 
-  # @yield [SmartCore::Container::Commands::Base]
+  # @param block [Block]
   # @return [Enumerable]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.7.0
   def each(&block)
     thread_safe { block_given? ? commands.each(&block) : commands.each }
   end
 
-  # @param command_set [SmartCore::Container::CommandSet]
+  # @param command_set [SmartCore::Container::DefinitionDSL::CommandSet]
   # @return [void]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.7.0
   def concat(command_set)
     thread_safe { commands.concat(command_set.dup.commands) }
   end
 
-  # @return [SmartCore::Operation::AttributeSet]
+  # @return [SmartCore::Container::DefinitionDSL::CommandSet]
   #
   # @api private
-  # @since 0.2.0
+  # @since 0.7.0
   def dup
     thread_safe do
       self.class.new.tap do |duplicate|
@@ -61,22 +63,14 @@ class SmartCore::Container::CommandSet
     end
   end
 
-  # @return [void]
-  #
-  # @api private
-  # @since 0.5.0
-  def clear
-    thread_safe { commands.clear }
-  end
-
   private
 
-  # @param block [Proc]
+  # @param block [Block]
   # @return [Any]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.7.0
   def thread_safe(&block)
-    @access_lock.synchronize(&block)
+    @access_lock.thread_safe(&block)
   end
 end

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.7.0
+module SmartCore::Container::DefinitionDSL::Commands
+  require_relative 'commands/base'
+  require_relative 'commands/definition/namespace'
+  require_relative 'commands/definition/register'
+  require_relative 'commands/definition/compose'
+  require_relative 'commands/instantiation/compose'
+  require_relative 'commands/instantiation/freeze_state'
+end

data/lib/smart_core/container/{commands → definition_dsl/commands}/base.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # @api private
-# @since 0.5.0
-class SmartCore::Container::Commands::Base
+# @since 0.7.0
+class SmartCore::Container::DefinitionDSL::Commands::Base
   # @param regsitry [SmartCore::Container::Registry]
   # @return [void]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.7.0
   def call(registry); end
 end

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

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module SmartCore::Container::DefinitionDSL::Commands::Definition
+  # @api private
+  # @since 0.7.0
+  class Compose < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @param container_klass [Class<SmartCore::Container>]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.7.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.7.0
+    def call(registry)
+      SmartCore::Container::RegistryBuilder.build_definitions(container_klass, registry)
+    end
+
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Definition::Compose]
+    #
+    # @api private
+    # @since 0.7.0
+    def dup
+      self.class.new(container_klass)
+    end
+
+    private
+
+    # @return [Class<SmartCore::Container>]
+    #
+    # @api private
+    # @since 0.7.0
+    attr_reader :container_klass
+  end
+end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module SmartCore::Container::DefinitionDSL::Commands::Definition
+  # @api private
+  # @since 0.7.0
+  class Namespace < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @return [String]
+    #
+    # @api private
+    # @since 0.7.0
+    attr_reader :namespace_name
+
+    # @param namespace_name [String, Symbol]
+    # @param dependencies_definition [Proc]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.7.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.7.0
+    def call(registry)
+      registry.register_namespace(namespace_name, &dependencies_definition)
+    end
+
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Definition::Namespace]
+    #
+    # @api private
+    # @since 0.7.0
+    def dup
+      self.class.new(namespace_name, dependencies_definition)
+    end
+
+    private
+
+    # @return [Proc]
+    #
+    # @api private
+    # @since 0.7.0
+    attr_reader :dependencies_definition
+  end
+end

data/lib/smart_core/container/{commands → definition_dsl/commands/definition}/register.rb

@@ -1,30 +1,24 @@
 # frozen_string_literal: true
 
-module SmartCore::Container::Commands
+module SmartCore::Container::DefinitionDSL::Commands::Definition
   # @api private
-  # @since 0.5.0
-  class Register < Base
-    # @return [String, Symbol]
+  # @since 0.7.0
+  class Register < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @return [String]
     #
     # @api private
-    # @since 0.5.0
+    # @since 0.7.0
     attr_reader :dependency_name
 
     # @param dependency_name [String, Symbol]
-    # @param options [Hash<Symbol,Any>]
     # @param dependency_definition [Proc]
-    # @option memoize [Boolean]
     # @return [void]
     #
-    # @todo option list
-    # @see [SmartCore::Container::KeyGuard]
-    #
     # @api private
-    # @since 0.5.0
-    def initialize(dependency_name, dependency_definition, **options)
+    # @since 0.7.0
+    def initialize(dependency_name, dependency_definition)
       SmartCore::Container::KeyGuard.indifferently_accessable_key(dependency_name).tap do |name|
         @dependency_name = name
-        @options = options
         @dependency_definition = dependency_definition
       end
     end
@@ -33,17 +27,17 @@ module SmartCore::Container::Commands
     # @return [void]
     #
     # @api private
-    # @since 0.5.0
+    # @since 0.7.0
     def call(registry)
-      registry.register(dependency_name, **options, &dependency_definition)
+      registry.register_dependency(dependency_name, &dependency_definition)
     end
 
-    # @return [SmartCore::Container::Commands::Register]
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Definition::Register]
     #
     # @api private
-    # @since 0.5.0
+    # @since 0.7.0
     def dup
-      self.class.new(dependency_name, dependency_definition, **options)
+      self.class.new(dependency_name, dependency_definition)
     end
 
     private
@@ -51,13 +45,7 @@ module SmartCore::Container::Commands
     # @return [Proc]
     #
     # @api private
-    # @since 0.5.0
+    # @since 0.7.0
     attr_reader :dependency_definition
-
-    # @return [Hash<Symbol,Any>]
-    #
-    # @api private
-    # @since 0.5.0
-    attr_reader :options
   end
 end

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

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module SmartCore::Container::DefinitionDSL::Commands::Instantiation
+  # @api private
+  # @since 0.7.0
+  class Compose < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @param container_klass [Class<SmartCore::Container>]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.7.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.7.0
+    def call(registry)
+      SmartCore::Container::RegistryBuilder.build_state(
+        container_klass, registry, ignored_commands: [
+          SmartCore::Container::DefinitionDSL::Commands::Instantiation::FreezeState
+        ]
+      )
+    end
+
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Instantiation::Compose]
+    #
+    # @api private
+    # @since 0.7.0
+    def dup
+      self.class.new(container_klass)
+    end
+
+    private
+
+    # @return [Class<SmartCore::Container>]
+    #
+    # @api private
+    # @since 0.7.0
+    attr_reader :container_klass
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module SmartCore::Container::DefinitionDSL::Commands::Instantiation
+  # @api private
+  # @since 0.7.0
+  class FreezeState < SmartCore::Container::DefinitionDSL::Commands::Base
+    # @param registry [SmartCore::Container::Registry]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.7.0
+    def call(registry)
+      registry.freeze!
+    end
+
+    # @return [SmartCore::Container::DefinitionDSL::Commands::Instantiation::FreezeState]
+    #
+    # @api private
+    # @since 0.7.0
+    def dup
+      self.class.new
+    end
+  end
+end

data/lib/smart_core/container/dependency_compatability.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # @api private
-# @since 0.5.0
+# @since 0.7.0
 module SmartCore::Container::DependencyCompatability
-  require_relative 'dependency_compatability/abstract'
-  require_relative 'dependency_compatability/command_set'
+  require_relative 'dependency_compatability/general'
+  require_relative 'dependency_compatability/definition'
   require_relative 'dependency_compatability/registry'
 end

data/lib/smart_core/container/dependency_compatability/definition.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.7.0
+module SmartCore::Container::DependencyCompatability::Definition
+  class << self
+    # @since 0.7.0
+    include SmartCore::Container::DependencyCompatability::General
+
+    # @param container_klass [Class<SmartCore::Container>]
+    # @param dependency_name [String, Symbol]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.7.0
+    def potential_namespace_overlap?(container_klass, dependency_name)
+      begin
+        anonymous_container = Class.new(container_klass).new
+        anonymous_container.register(dependency_name, &(proc {}))
+        false
+      rescue SmartCore::Container::DependencyOverNamespaceOverlapError
+        true
+      end
+    end
+
+    # @param container_klass [Class<SmartCore::Container>]
+    # @param namespace_name [String, Symbol]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.7.0
+    def potential_dependency_overlap?(container_klass, namespace_name)
+      begin
+        anonymous_container = Class.new(container_klass).new
+        anonymous_container.namespace(namespace_name, &(proc {}))
+        false
+      rescue SmartCore::Container::NamespaceOverDependencyOverlapError
+        true
+      end
+    end
+  end
+end

data/lib/smart_core/container/dependency_compatability/general.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.7.0
+module SmartCore::Container::DependencyCompatability::General
+  # @param context [Class<SmartCore::Container>, SmartCore::Container::Registry]
+  # @param dependency_name [String, Symbol]
+  # @return [void]
+  #
+  # @raise [SmartCore::Container::DependencyOverNamespaceOverlapError]
+  #
+  # @api private
+  # @since 0.7.0
+  def prevent_namespace_overlap!(context, dependency_name)
+    raise(
+      SmartCore::Container::DependencyOverNamespaceOverlapError,
+      "Trying to overlap already registered '#{dependency_name}' namespace " \
+      "with '#{dependency_name}' dependency!"
+    ) if potential_namespace_overlap?(context, dependency_name)
+  end
+
+  # @param context [Class<SmartCore::Container>, SmartCore::Container::Registry]
+  # @param namespace_name [String, Symbol]
+  # @return [void]
+  #
+  # @raise [SmartCore::Container::NamespaceOverDependencyOverlapError]
+  #
+  # @api private
+  # @since 0.7.0
+  def prevent_dependency_overlap!(context, namespace_name)
+    raise(
+      SmartCore::Container::NamespaceOverDependencyOverlapError,
+      "Trying to overlap already registered '#{namespace_name}' dependency " \
+      "with '#{namespace_name}' namespace!"
+    ) if potential_dependency_overlap?(context, namespace_name)
+  end
+
+  # @param context [Class<SmartCore::Container>, SmartCore::Container::Registry]
+  # @param dependency_name [String, Symbol]
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.7.0
+  def potential_namespace_overlap?(context, dependency_name)
+    # :nocov:
+    raise NoMethodError
+    # :nocov:
+  end
+
+  # @param context [Class<SmartCore::Container>, SmartCore::Container::Registry]
+  # @param namespace_name [String, Symbol]
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.7.0
+  def potential_dependency_overlap?(context, namespace_name)
+    # :nocov:
+    raise NoMethodError
+    # :nocov:
+  end
+end