smart_container 0.5.0 → 0.9.0

data/lib/smart_core/container/dependency_watcher/observer.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.8.0
+class SmartCore::Container::DependencyWatcher::Observer
+  # @param container [SmartCore::Container]
+  # @param dependency_path [String]
+  # @param callback [Proc]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def initialize(container, dependency_path, callback)
+    @container = container
+    @dependency_path = dependency_path
+    @callback = callback
+  end
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def notify!
+    callback.call(dependency_path, container)
+  end
+
+  private
+
+  # @return [SmartCore::Container]
+  #
+  # @api private
+  # @since 0.8.0
+  attr_reader :container
+
+  # @return [String]
+  #
+  # @api private
+  # @since 0.8.0
+  attr_reader :dependency_path
+
+  # @return [Proc]
+  #
+  # @api private
+  # @since 0.8.0
+  attr_reader :callback
+end

data/lib/smart_core/container/entities/dependency.rb

@@ -20,11 +20,13 @@ class SmartCore::Container::Entities::Dependency < SmartCore::Container::Entitie
     @dependency_definition = dependency_definition
   end
 
+  # @param host_container [SmartCore::Container, NilClass]
   # @return [Any]
   #
   # @api private
   # @since 0.1.0
-  def reveal
+  # @version 0.8.1
+  def reveal(host_container = SmartCore::Container::NO_HOST_CONTAINER)
     dependency_definition.call
   end
 

data/lib/smart_core/container/entities/dependency_builder.rb

@@ -2,7 +2,8 @@
 
 # @api private
 # @since 0.1.0
-class SmartCore::Container::Entities::DependencyBuilder
+# @version 0.8.1
+module SmartCore::Container::Entities::DependencyBuilder
   class << self
     # @param dependency_name [String]
     # @param dependency_definition [Proc]
@@ -11,68 +12,35 @@ class SmartCore::Container::Entities::DependencyBuilder
     #
     # @api private
     # @since 0.1.0
-    # @version 0.2.0
+    # @version 0.8.1
     def build(dependency_name, dependency_definition, memoize)
-      new(dependency_name, dependency_definition, memoize).build
+      if memoize
+        build_memoized_dependency(dependency_name, dependency_definition)
+      else
+        build_original_dependency(dependency_name, dependency_definition)
+      end
     end
-  end
-
-  # @param dependency_name [String]
-  # @param dependency_definition [Proc]
-  # @param memoize [Boolean]
-  # @return [void]
-  #
-  # @api private
-  # @since 0.1.0
-  # @version 0.2.0
-  def initialize(dependency_name, dependency_definition, memoize)
-    @dependency_name = dependency_name
-    @dependency_definition = dependency_definition
-    @memoize = memoize
-  end
-
-  # @return [SmartCore::Container::Entities::Dependency]
-  #
-  # @api private
-  # @since 0.1.0
-  # @version 0.2.0
-  def build
-    memoize ? build_memoized_dependency : build_original_dependency
-  end
-
-  private
 
-  # @return [String]
-  #
-  # @api private
-  # @since 0.1.0
-  attr_reader :dependency_name
+    private
 
-  # @return [Proc]
-  #
-  # @api private
-  # @since 0.1.0
-  attr_reader :dependency_definition
-
-  # @return [Boolean]
-  #
-  # @api private
-  # @since 0.2.0
-  attr_reader :memoize
-
-  # @return [SmartCore::Container::Entities::Dependency]
-  #
-  # @api private
-  # @since 0.2.0
-  def build_memoized_dependency
-    SmartCore::Container::Entities::MemoizedDependency.new(dependency_name, dependency_definition)
-  end
+    # @param dependency_name [String]
+    # @param dependency_definition [Proc]
+    # @return [SmartCore::Container::Entities::Dependency]
+    #
+    # @api private
+    # @since 0.8.1
+    def build_memoized_dependency(dependency_name, dependency_definition)
+      SmartCore::Container::Entities::MemoizedDependency.new(dependency_name, dependency_definition)
+    end
 
-  # @return [SmartCore::Container::Entities::Dependency]
-  #
-  # @api private
-  # @since 0.2.0
-  def build_original_dependency
-    SmartCore::Container::Entities::Dependency.new(dependency_name, dependency_definition)
+    # @param dependency_name [String]
+    # @param dependency_definition [Proc]
+    # @return [SmartCore::Container::Entities::Dependency]
+    #
+    # @api private
+    # @since 0.8.1
+    def build_original_dependency(dependency_name, dependency_definition)
+      SmartCore::Container::Entities::Dependency.new(dependency_name, dependency_definition)
+    end
   end
 end

data/lib/smart_core/container/entities/memoized_dependency.rb

@@ -12,14 +12,16 @@ module SmartCore::Container::Entities
     # @since 0.2.0
     def initialize(dependency_name, dependency_definition)
       super(dependency_name, dependency_definition)
-      @lock = SmartCore::Container::ArbitaryLock.new
+      @lock = SmartCore::Container::ArbitraryLock.new
     end
 
+    # @param host_container [SmartCore::Container, NilClass]
     # @return [Any]
     #
     # @api private
     # @since 0.2.0
-    def reveal
+    # @version 0.8.1
+    def reveal(host_container = SmartCore::Container::NO_HOST_CONTAINER)
       @lock.thread_safe do
         unless instance_variable_defined?(:@revealed_dependency)
           @revealed_dependency = dependency_definition.call

data/lib/smart_core/container/entities/namespace.rb

@@ -9,24 +9,35 @@ class SmartCore::Container::Entities::Namespace < SmartCore::Container::Entities
   # @since 0.1.0
   alias_method :namespace_name, :external_name
 
+  # @return [NilClass, SmartCore::Container]
+  #
+  # @api private
+  # @since 0.8.01
+  attr_reader :host_container
+
   # @param namespace_name [String]
+  # @param host_container [NilClass, SmartCore::Container]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
-  def initialize(namespace_name)
+  # @version 0.8.1
+  def initialize(namespace_name, host_container = SmartCore::Container::NO_HOST_CONTAINER)
     super(namespace_name)
     @container_klass = Class.new(SmartCore::Container)
     @container_instance = nil
-    @lock = SmartCore::Container::ArbitaryLock.new
+    @host_container = host_container
+    @lock = SmartCore::Container::ArbitraryLock.new
   end
 
+  # @param runtime_host_container [SmartCore::Container, NilClass]
   # @return [SmartCore::Container]
   #
   # @api private
   # @since 0.1.0
-  def reveal
-    thread_safe { container_instance }
+  # @version 0.8.1
+  def reveal(runtime_host_container = SmartCore::Container::NO_HOST_CONTAINER)
+    thread_safe { container_instance(runtime_host_container) }
   end
 
   # @param dependencies_definition [Proc]
@@ -54,12 +65,18 @@ class SmartCore::Container::Entities::Namespace < SmartCore::Container::Entities
   # @since 0.1.0
   attr_reader :container_klass
 
+  # @param runtime_host_container [SmartCore::Container, NilClass]
   # @return [SmartCore::Container]
   #
   # @api private
   # @since 0.1.0
-  def container_instance
-    @container_instance ||= container_klass.new
+  # @version 0.8.1
+  def container_instance(runtime_host_container = SmartCore::Container::NO_HOST_CONTAINER)
+    @host_container ||= runtime_host_container
+    @container_instance ||= container_klass.new(
+      host_container: @host_container,
+      host_path: @host_container && namespace_name
+    )
   end
 
   # @param block [Block]

data/lib/smart_core/container/entities/namespace_builder.rb

@@ -2,40 +2,20 @@
 
 # @api private
 # @since 0.1.0
-class SmartCore::Container::Entities::NamespaceBuilder
-  class << self
-    # @param namespace_name [String]
-    # @return [SmartCore::Container::Entities::Namespace]
-    #
-    # @api private
-    # @since 0.1.0
-    def build(namespace_name)
-      new(namespace_name).build
+# @version 0.8.1
+module SmartCore::Container::Entities
+  module NamespaceBuilder
+    class << self
+      # @param namespace_name [String]
+      # @param host_container [SmartContainer, NilClass]
+      # @return [SmartCore::Container::Entities::Namespace]
+      #
+      # @api private
+      # @since 0.1.0
+      # @version 0.8.1
+      def build(namespace_name, host_container = SmartCore::Container::NO_HOST_CONTAINER)
+        SmartCore::Container::Entities::Namespace.new(namespace_name, host_container)
+      end
     end
   end
-
-  # @param namespace_name [String]
-  # @return [void]
-  #
-  # @api private
-  # @since 0.1.0
-  def initialize(namespace_name)
-    @namespace_name = namespace_name
-  end
-
-  # @return [SmartCore::Container::Entities::Namespace]
-  #
-  # @api private
-  # @since 0.1.0
-  def build
-    SmartCore::Container::Entities::Namespace.new(namespace_name)
-  end
-
-  private
-
-  # @return [String]
-  #
-  # @api private
-  # @since 0.1.0
-  attr_reader :namespace_name
 end

data/lib/smart_core/container/host.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+using SmartCore::Ext::BasicObjectAsObject
+
+# @api private
+# @since 0.8.1
+class SmartCore::Container::Host
+  class << self
+    # @param container [SmartCore::Container]
+    # @param path [String]
+    # @return [SmartCore::Container::Host]
+    #
+    # @api private
+    # @since 0.8.1
+    # rubocop:disable Metrics/AbcSize, Style/NilComparison
+    def build(container, path)
+      if (container.nil? && !path.nil?) || (!container.nil? && path.nil?)
+        raise(SmartCore::Container::ArgumentError, <<~ERROR_MESSAGE)
+          Host container requires both host container instance and host container path
+          (container: #{container.inspect} / path: #{path.inspect})
+        ERROR_MESSAGE
+      end
+
+      if (!container.nil? && !path.nil?) &&
+         (!container.is_a?(SmartCore::Container) || !path.is_a?(String))
+        raise(SmartCore::Container::ArgumentError, <<~ERROR_MESSAGE)
+          Host container should be a type of SmartCore::Container
+          and host path should be a type of String.
+        ERROR_MESSAGE
+      end
+
+      new(container, path)
+    end
+    # rubocop:enable Metrics/AbcSize, Style/NilComparison
+  end
+
+  # @return [SmartCore::Container]
+  #
+  # @api private
+  # @since 0.8.1
+  attr_reader :container
+
+  # @return [String]
+  #
+  # @api private
+  # @since 0.8.1
+  attr_reader :path
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.8.1
+  attr_reader :exists
+  alias_method :exists?, :exists
+  alias_method :present?, :exists
+
+  # @param container [SmartCore::Container]
+  # @param path [String]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.1
+  def initialize(container, path)
+    @container = container
+    @path = path
+    @exists = !!container
+  end
+
+  # @param nested_entity_path [String]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.1
+  def notify_about_nested_changement(nested_entity_path)
+    return unless exists?
+    host_path = "#{path}" \
+                "#{SmartCore::Container::DependencyResolver::PATH_PART_SEPARATOR}" \
+                "#{nested_entity_path}"
+    container.watcher.notify(host_path)
+  end
+end

data/lib/smart_core/container/mixin.rb

@@ -11,7 +11,7 @@ module SmartCore::Container::Mixin
     # @since 0.1.0
     def included(base_klass)
       # rubocop:disable Layout/LineLength
-      base_klass.instance_variable_set(:@__smart_core_container_access_lock__, SmartCore::Container::ArbitaryLock.new)
+      base_klass.instance_variable_set(:@__smart_core_container_access_lock__, SmartCore::Container::ArbitraryLock.new)
       base_klass.instance_variable_set(:@__smart_core_container_klass__, Class.new(SmartCore::Container))
       base_klass.instance_variable_set(:@__smart_core_container__, nil)
       # rubocop:enable Layout/LineLength
@@ -34,7 +34,7 @@ module SmartCore::Container::Mixin
       inherited_container_klass = Class.new(@__smart_core_container_klass__)
 
       # rubocop:disable Layout/LineLength
-      child_klass.instance_variable_set(:@__smart_core_container_access_lock__, SmartCore::Container::ArbitaryLock.new)
+      child_klass.instance_variable_set(:@__smart_core_container_access_lock__, SmartCore::Container::ArbitraryLock.new)
       child_klass.instance_variable_set(:@__smart_core_container_klass__, inherited_container_klass)
       child_klass.instance_variable_set(:@__smart_core_container__, nil)
       # rubocop:enable Layout/LineLength

data/lib/smart_core/container/registry.rb

@@ -37,7 +37,7 @@ class SmartCore::Container::Registry
   # @since 0.1.0
   def initialize
     @registry = {}
-    @access_lock = SmartCore::Container::ArbitaryLock.new
+    @access_lock = SmartCore::Container::ArbitraryLock.new
   end
 
   # @param entity_path [String, Symbol]
@@ -57,18 +57,24 @@ class SmartCore::Container::Registry
   # @api private
   # @since 0.1.0
   # @version 0.3.0
-  def register_dependency(name, memoize = DEFAULT_MEMOIZATION_BEHAVIOR, &dependency_definition)
+  def register_dependency(name, memoize: DEFAULT_MEMOIZATION_BEHAVIOR, &dependency_definition)
     thread_safe { add_dependency(name, dependency_definition, memoize) }
   end
 
   # @param name [String, Symbol]
+  # @param host_container [NilClasss, SmartCore::Container]
   # @param dependencies_definition [Block]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
-  def register_namespace(name, &dependencies_definition)
-    thread_safe { add_namespace(name, dependencies_definition) }
+  # @version 0.8.1
+  def register_namespace(
+    name,
+    host_container = SmartCore::Container::NO_HOST_CONTAINER,
+    &dependencies_definition
+  )
+    thread_safe { add_namespace(name, host_container, dependencies_definition) }
   end
 
   # @return [void]
@@ -223,6 +229,7 @@ class SmartCore::Container::Registry
   end
 
   # @param namespace_name [String, Symbol]
+  # @param host_container [NilClass, SmartCore::Container]
   # @param dependencies_definition [Proc]
   # @return [SmartCore::Container::Entities::Namespace]
   #
@@ -230,25 +237,26 @@ class SmartCore::Container::Registry
   #
   # @api private
   # @since 0.1.0
-  def add_namespace(namespace_name, dependencies_definition)
+  # @version 0.8.1
+  # rubocop:disable Lint/EmptyBlock
+  def add_namespace(namespace_name, host_container, dependencies_definition)
     if state_frozen?
       raise(SmartCore::Container::FrozenRegistryError, 'Can not modify frozen registry!')
     end
     namespace_name = indifferently_accessable_name(namespace_name)
+    dependencies_definition ||= proc {}
     prevent_dependency_overlap!(namespace_name)
 
-    # rubocop:disable Layout/RescueEnsureAlignment
     namespace_entity = begin
       fetch_entity(namespace_name)
     rescue SmartCore::Container::FetchError
       registry[namespace_name] = SmartCore::Container::Entities::NamespaceBuilder.build(
-        namespace_name
+        namespace_name, host_container
       )
     end
-    # rubocop:enable Layout/RescueEnsureAlignment
-
     namespace_entity.tap { namespace_entity.append_definitions(dependencies_definition) }
   end
+  # rubocop:enable Lint/EmptyBlock
 
   # @param root_dependency_name [String, NilClass]
   # @param block [Block]