smart_container 0.2.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8724a62bc6365606a5b796bac2899c5ddba96c179548878f12e324291b6862a3
-  data.tar.gz: 769c81de665be07979bbeb8026398ff6cf6e8885159cbe6ab1aff52d07a64095
+  metadata.gz: 3e536932a27a4bcf2ded83ea750978459e8dbf6a34ea35dfac8ef7008db3240d
+  data.tar.gz: 2566b21ef936d31bab5ff8eb6d6d51cd6510db97acf62d9dc55992915094a962
 SHA512:
-  metadata.gz: b1f138811f9b345b2f735b4f90e06d44ef83b955358e78b786becb9e2d73144de113cbfc0b08d765c245a7c1a4889bba8f5c3ed63219f28fa312554f8834d1ae
-  data.tar.gz: 69da3a3c4ac8b5d34243a617dff6614654a9c116ef7270f7f313127dafe973a2d102143df21fcad222bb9d94499606f983835b74e711a9c823934c58c8bc42a2
+  metadata.gz: d1c443404d20ac8c6f61ea8bf6d37db0acd4e1131626ca00c75bf26f695262f275ee6814aab3ecd4b0a4c17b4d3f50ae449abb6932e658f0cc325e3e87cba8ea
+  data.tar.gz: 587dac41ae390e811802ca6c5a6a4610d81d4b7cecd1d5de224a409b1724edf180c98d78acc1a81cd9bc06010343d5a42f769acd219d12d395bef06c4f9420c6

data/.rubocop.yml

@@ -5,11 +5,11 @@ inherit_gem:
     - lib/rubocop.rspec.yml
 
 AllCops:
-  TargetRubyVersion: 2.4.9
+  TargetRubyVersion: 2.7.1
   Include:
     - lib/**/*.rb
     - spec/**/*.rb
     - Gemfile
     - Rakefile
-    - siege.gemspec
+    - smart_container.gemspec
     - bin/console

data/.travis.yml

@@ -1,28 +1,22 @@
 ---
 language: ruby
 cache: bundler
+os: linux
+dist: xenial
 before_install:
-- gem install bundler -v 2.1.2
+- gem install bundler
 script:
 - bundle exec rake rubocop
 - bundle exec rake rspec
 jobs:
   fast_finish: true
   include:
-  - rvm: 2.4.9
-    os: [linux, osx]
-  - rvm: 2.5.7
-    os: [linux, osx]
-  - rvm: 2.6.5
-    os: [linux, osx]
-  - rvm: 2.7.0
-    os: [linux, osx]
+  - rvm: 2.4.10
+  - rvm: 2.5.8
+  - rvm: 2.6.6
+  - rvm: 2.7.1
   - rvm: ruby-head
-    os: [linux, osx]
   - rvm: jruby-head
-    os: [linux, osx]
   allow_failures:
   - rvm: ruby-head
-    os: [linux, osx]
   - rvm: jruby-head
-    os: [linux, osx]

data/CHANGELOG.md

@@ -1,25 +1,40 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
-## [0.2.0] - 202-01-05
+## [0.7.0] - 2020-06-20
+### Added
+- `SmartCore::Container.define {}` - an ability to avoid explicit class definition that allows
+  to create container instances from an anonymous container class imidietly
+
+## [0.6.0] - 2020-01-12
+### Added
+- Missing memoization flag `:memoize` for runtime-based dependency registration:
+  - `memoize: false` by default;
+  - signature: `SmartCore::Container#register(dependency_name, memoize: false, &dependency)`
+
+## [0.5.0] - 2020-01-07
+### Added
+- Key predicates (`#key?(key)`, `#dependency?(path, memoized: nil/true/false)`, `#namespace?(path)`);
+
+## [0.4.0] - 2020-01-06
+### Added
+- `#keys(all_variants: false)` - return a list of dependency keys
+  (`all_variants: true` is mean "including namespace kaeys");
+- `#each_dependency(yield_all: false) { |key, value| }` - iterate over conteiner's dependencies
+  (`yield_all: true` will include nested containers to iteration process);
+### Fixed
+- `SmartCore::Container::ResolvingError` class has incorrect message attribute name;
+
+## [0.3.0] - 2020-01-05
+### Changed
+- Dependency resolving is not memoized by default (previously: totally memoized 😱);
+
+## [0.2.0] - 2020-01-05
 ### Changed
 - (Private API (`SmartCore::Container::RegistryBuilder`)) improved semantics:
   - `build_state` is renamed to `initialise`;
   - `build_definitions` is renamed to `define`;
-- (Public API) Support for memoized dependencies (all dependencies are memoized by default)
-  ```ruby
-  class MyContainer < SmartCore::Container
-    namespace(:some_naespace) do
-      # memoized by default
-      register(:random_number) { rand(1000) }
-      # explicit memoization
-      register(:random_number, memoized: true) { rand(1000) }
-
-      # register non-memoizable dependency
-      register(:random_number, memoized: false) { rand(1000) }
-    end
-  end
-  ```
+- (Public API) Support for memoized dependencies (all dependencies are memoized by default);
 
 ## [0.1.0] - 2020-01-02
 

data/Gemfile.lock

@@ -1,83 +1,98 @@
 PATH
   remote: .
   specs:
-    smart_container (0.2.0)
-      smart_engine (~> 0.2)
+    smart_container (0.6.0)
+      smart_engine (~> 0.5)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    armitage-rubocop (0.78.0)
-      rubocop (= 0.78.0)
+    activesupport (6.0.2.2)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+      zeitwerk (~> 2.2)
+    armitage-rubocop (0.81.0)
+      rubocop (= 0.81.0)
       rubocop-performance (= 1.5.2)
-      rubocop-rails (= 2.4.1)
-      rubocop-rake (= 0.5.0)
-      rubocop-rspec (= 1.37.1)
+      rubocop-rails (= 2.5.2)
+      rubocop-rake (= 0.5.1)
+      rubocop-rspec (= 1.38.1)
     ast (2.4.0)
     coderay (1.1.2)
+    concurrent-ruby (1.1.6)
     diff-lcs (1.3)
     docile (1.3.2)
+    i18n (1.8.2)
+      concurrent-ruby (~> 1.0)
     jaro_winkler (1.5.4)
-    json (2.3.0)
-    method_source (0.9.2)
+    method_source (1.0.0)
+    minitest (5.14.0)
     parallel (1.19.1)
-    parser (2.7.0.1)
+    parser (2.7.1.0)
       ast (~> 2.4.0)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    rack (2.0.8)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    rack (2.2.2)
     rainbow (3.0.0)
     rake (13.0.1)
+    rexml (3.2.4)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
       rspec-mocks (~> 3.9.0)
     rspec-core (3.9.1)
       rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.0)
+    rspec-expectations (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-support (3.9.2)
-    rubocop (0.78.0)
+    rubocop (0.81.0)
       jaro_winkler (~> 1.5.1)
       parallel (~> 1.10)
-      parser (>= 2.6)
+      parser (>= 2.7.0.1)
       rainbow (>= 2.2.2, < 4.0)
+      rexml
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
     rubocop-performance (1.5.2)
       rubocop (>= 0.71.0)
-    rubocop-rails (2.4.1)
+    rubocop-rails (2.5.2)
+      activesupport
       rack (>= 1.1)
       rubocop (>= 0.72.0)
-    rubocop-rake (0.5.0)
+    rubocop-rake (0.5.1)
       rubocop
-    rubocop-rspec (1.37.1)
+    rubocop-rspec (1.38.1)
       rubocop (>= 0.68.1)
     ruby-progressbar (1.10.1)
-    simplecov (0.17.1)
+    simplecov (0.18.5)
       docile (~> 1.1)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.2)
-    smart_engine (0.2.0)
-    unicode-display_width (1.6.0)
+      simplecov-html (~> 0.11)
+    simplecov-html (0.12.2)
+    smart_engine (0.5.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.7)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.7.0)
+    zeitwerk (2.3.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  armitage-rubocop (~> 0.78)
+  armitage-rubocop (~> 0.81)
   bundler (~> 2.1)
-  pry (~> 0.12)
+  pry (~> 0.13)
   rake (~> 13.0)
   rspec (~> 3.9)
-  simplecov (~> 0.17)
+  simplecov (~> 0.18)
   smart_container!
 
 BUNDLED WITH
-   2.1.2
+   2.1.4

data/README.md

@@ -24,35 +24,214 @@ require 'smart_core/container'
 
 ## Synopsis (demo)
 
+- container class creation:
+
 ```ruby
 class Container < SmartCore::Container
   namespace(:database) do # support for namespaces
-    register(:resolver) { SomeDatabaseResolver.new } # dependency registration
+    register(:resolver, memoize: true) { SomeDatabaseResolver.new } # dependency registration
 
     namespace(:cache) do # support for nested naespaces
-      register(:memcached) { MemcachedClient.new }
-      register(:redis) { RedisClient.new }
+      register(:memcached, memoize: true) { MemcachedClient.new }
+      register(:redis, memoize: true) { RedisClient.new }
     end
   end
 
   # root dependencies
-  register(:logger) { Logger.new(STDOUT) }
+  register(:logger, memoize: true) { Logger.new(STDOUT) }
 
-  # do not memoize registered object
-  register(:random, memoize: false) { rand(1000) }
+  # dependencies are not memoized by default (memoize: false)
+  register(:random) { rand(1000) }
 end
+```
+
+- mixin:
+
+```ruby
+# full documentaiton is coming;
+
+class Application
+  include SmartCore::Container::Mixin
 
+  dependencies do
+    namespace(:database) do
+      register(:cache) { MemcachedClient.new }
+    end
+  end
+end
+
+# access:
+Application.container
+Application.new.container # NOTE: the same instance as Application.container
+```
+
+- container instantiation and dependency resolving:
+
+```ruby
 container = Container.new # create container instance
+```
 
+```ruby
 container['database.resolver'] # => #<SomeDatabaseResolver:0x00007f0f0f1d6332>
 container['database.cache.redis'] # => #<RedisClient:0x00007f0f0f1d0158>
 container['logger'] # => #<Logger:0x00007f5f0f2f0158>
 
+container.resolve('logger') # #resolve(path) is an alias for #[](path)
+
 # non-memoized dependency
 container['random'] # => 352
 container['random'] # => 57
+
+# trying to resolve a namespace as dependency
+container['database'] # => SmartCore::Container::ResolvingError
+
+# but you can fetch any depenendency type (internal containers and values) via #fetch
+container.fetch('database') # => SmartCore::Container (nested container)
+container.fetch('database.resolver') # => #<SomeDatabaseResolver:0x00007f0f0f1d6332>
+```
+
+- runtime-level dependency/namespace registration:
+
+```ruby
+container.namespace(:api) do
+  register(:provider) { GoogleProvider } # without memoization
+end
+
+container.register('game_api', memoize: true) { 'overwatch' } # with memoization
+
+container['api.provider'] # => GoogleProvider
+container['game_api'] # => 'overwatch'
+```
+
+- container keys (dependency names):
+
+```ruby
+# get dependnecy keys (only dependencies)
+container.keys
+# => result:
+[
+  'database.resolver',
+  'database.cache.memcached',
+  'database.cache.redis',
+  'logger',
+  'random'
+]
+```
+```ruby
+# get all keys (namespaces and dependencies)
+container.keys(all_variants: true)
+# => result:
+[
+  'database', # namespace
+  'database.resolver',
+  'database.cache', # namespace
+  'database.cache.memcached',
+  'database.cache.redis',
+  'logger',
+  'random'
+]
 ```
 
+- key predicates:
+  - `key?(key)` - has dependency or namespace?
+  - `namespace?(path)` - has namespace?
+  - `dependency?(path)` - has dependency?
+  - `dependency?(path, memoized: true)` - has memoized dependency?
+  - `dependency?(path, memoized: false)` - has non-memoized dependency?
+
+```ruby
+container.key?('database') # => true
+container.key?('database.cache.memcached') # => true
+
+container.dependency?('database') # => false
+container.dependency?('database.resolver') # => true
+
+container.namespace?('database') # => true
+container.namespace?('database.resolver') # => false
+
+container.dependency?('database.resolver', memoized: true) # => true
+container.dependency?('database.resolver', memoized: false) # => false
+
+container.dependency?('random', memoized: true) # => false
+container.dependency?('random', memoized: false) # => true
+```
+
+- state freeze (`#freeze!`, `.#frozen?`):
+
+```ruby
+# documentation is coming;
+```
+
+- reloading (`#reload!):
+
+```ruby
+# documentation is coming;
+```
+
+- hash tree (`#hash_tree`, `#hash_tree(resolve_dependencies: true)`):
+
+```ruby
+# documentation is coming`;
+```
+
+- `SmartCore::Container.define` - avoid explicit class definition (allows to create container instance from an anonymous container class immidietly):
+
+```ruby
+# - create from empty container class -
+
+AppContainer = SmartCore::Container.define do
+  namespace :database do
+    register(:logger) { Logger.new }
+  end
+end # => an instance of Class<SmartCore::Container>
+
+AppContainer.resolve('database.logger') # => #<Logger:0x00007f5f0f2f0158>
+AppContainer['database.logger'] # => #<Logger:0x00007f5f0f2f0158>
+```
+
+```ruby
+# - create from another container class with a custom sub-definitions -
+
+class BasicContainer < SmartCore::Container
+  namespace(:api) do
+    register(:client) { Kickbox.new }
+  end
+end
+
+AppContainer = BasicContainer.define do
+  register(:db_driver) { Sequel }
+end
+# --- or ---
+AppContainer = SmartCore::Container.define(BasicContainer) do
+  register(:db_driver) { Sequel }
+end
+
+AppContainer['api.client'] # => #<Kickbox:0x00007f5f0f2f0158> (BasicContainer dependency)
+AppContainer['db_driver'] # => Sequel (AppContainer dependency)
+```
+
+---
+
+## Roadmap
+
+- support for instant dependency registration:
+
+```ruby
+# common (dynamic) way:
+register('dependency_name') { dependency_value }
+
+# instant way:
+register('dependency_name', dependency_value)
+```
+
+- support for memoization ignorance during dependency resolving:
+
+```ruby
+resolve('logger', :allocate) # Draft
+```
+
+- container composition;
+
 ---
 
 ## Contributing

data/Rakefile

@@ -4,6 +4,7 @@ require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'rubocop'
 require 'rubocop/rake_task'
+require 'rubocop-rails'
 require 'rubocop-performance'
 require 'rubocop-rspec'
 require 'rubocop-rake'
@@ -11,8 +12,8 @@ require 'rubocop-rake'
 RuboCop::RakeTask.new(:rubocop) do |t|
   config_path = File.expand_path(File.join('.rubocop.yml'), __dir__)
   t.options = ['--config', config_path]
-  t.requires << 'rubocop-performance'
   t.requires << 'rubocop-rspec'
+  t.requires << 'rubocop-performance'
   t.requires << 'rubocop-rake'
 end
 

data/lib/smart_core/container.rb

@@ -20,6 +20,27 @@ module SmartCore
     require_relative 'container/dependency_resolver'
     require_relative 'container/mixin'
 
+    class << self
+      # @param initial_container_klass [Class<SmartCore::Container>]
+      # @param container_definitions [Block]
+      # @return [SmartCore::Container]
+      #
+      # @api public
+      # @since 0.7.0
+      def define(initial_container_klass = self, &container_definitions)
+        unless initial_container_klass <= SmartCore::Container
+          raise(SmartCore::Container::ArgumentError, <<~ERROR_MESSAGE)
+            Base class should be a type of SmartCore::Container
+          ERROR_MESSAGE
+        end
+
+        Class.new(initial_container_klass, &container_definitions).new
+      end
+    end
+
+    # @since 0.4.0
+    include ::Enumerable
+
     # @since 0.1.0
     include DefinitionDSL
 
@@ -44,8 +65,14 @@ module SmartCore
     #
     # @api public
     # @sicne 0.1.0
-    def register(dependency_name, &dependency_definition)
-      thread_safe { registry.register_dependency(dependency_name, &dependency_definition) }
+    def register(
+      dependency_name,
+      memoize: SmartCore::Container::Registry::DEFAULT_MEMOIZATION_BEHAVIOR,
+      &dependency_definition
+    )
+      thread_safe do
+        registry.register_dependency(dependency_name, memoize: memoize, &dependency_definition)
+      end
     end
 
     # @param namespace_name [String, Symbol]
@@ -102,6 +129,61 @@ module SmartCore
       thread_safe { build_registry! }
     end
 
+    # @option all_variants [Boolean]
+    # @return [Array<String>]
+    #
+    # @api public
+    # @since 0.4.0
+    def keys(all_variants: SmartCore::Container::Registry::DEFAULT_KEY_EXTRACTION_BEHAVIOUR)
+      thread_safe { registry.keys(all_variants: all_variants) }
+    end
+
+    # @param key [String, Symbol]
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.5.0
+    def key?(key)
+      thread_safe { DependencyResolver.key?(self, key) }
+    end
+
+    # @param namespace_path [String, Symbol]
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.5.0
+    def namespace?(namespace_path)
+      thread_safe { DependencyResolver.namespace?(self, namespace_path) }
+    end
+
+    # @param dependency_path [String, Symbol]
+    # @option memoized [NilClass, Boolean]
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.5.0
+    def dependency?(dependency_path, memoized: nil)
+      thread_safe { DependencyResolver.dependency?(self, dependency_path, memoized: memoized) }
+    end
+
+    # @option yield_all [Boolean]
+    # @param block [Block]
+    # @yield [dependency_name, dependency_value]
+    # @yield_param dependency_name [String]
+    # @yield_param dependency_value [Any, SmartCore::Container]
+    # @return [Enumerable]
+    #
+    # @api public
+    # @since 0.4.0
+    def each_dependency(
+      yield_all: SmartCore::Container::Registry::DEFAULT_ITERATION_YIELD_BEHAVIOUR,
+      &block
+    )
+      thread_safe { registry.each_dependency(yield_all: yield_all, &block) }
+    end
+    alias_method :each, :each_dependency
+    alias_method :each_pair, :each_dependency
+
     # @option resolve_dependencies [Boolean]
     # @return [Hash<String|Symbol,SmartCore::Container::Entities::Base|Any>]
     #

data/lib/smart_core/container/definition_dsl.rb

@@ -69,8 +69,12 @@ class SmartCore::Container
       #
       # @api public
       # @since 0.1.0
-      # @version 0.2.0
-      def register(dependency_name, memoize: true, &dependency_definition)
+      # @version 0.3.0
+      def register(
+        dependency_name,
+        memoize: SmartCore::Container::Registry::DEFAULT_MEMOIZATION_BEHAVIOR,
+        &dependency_definition
+      )
         @__container_definition_lock__.thread_safe do
           DependencyCompatability::Definition.prevent_namespace_overlap!(self, dependency_name)
 

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

@@ -36,7 +36,7 @@ module SmartCore::Container::DefinitionDSL::Commands::Definition
     # @since 0.1.0
     # @version 0.2.0
     def call(registry)
-      registry.register_dependency(dependency_name, memoize, &dependency_definition)
+      registry.register_dependency(dependency_name, memoize: memoize, &dependency_definition)
     end
 
     # @return [SmartCore::Container::DefinitionDSL::Commands::Definition::Register]

data/lib/smart_core/container/dependency_resolver.rb

@@ -5,6 +5,12 @@
 module SmartCore::Container::DependencyResolver
   require_relative 'dependency_resolver/route'
 
+  # @return [String]
+  #
+  # @api private
+  # @since 0.4.0
+  PATH_PART_SEPARATOR = '.'
+
   class << self
     # @param container [SmartCore::Container]
     # @param dependency_path [String, Symbol]
@@ -20,6 +26,54 @@ module SmartCore::Container::DependencyResolver
       container.registry.resolve(dependency_path).reveal
     end
 
+    # @param container [SmartCore::Container]
+    # @param key [String, Symbol]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.5.0
+    def key?(container, key)
+      extract(container, key)
+      true
+    rescue SmartCore::Container::ResolvingError
+      false
+    end
+
+    # @param container [SmartCore::Container]
+    # @param namespace_path [String, Symbol]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.5.0
+    def namespace?(container, namespace_path)
+      extract(container, namespace_path).is_a?(SmartCore::Container::Entities::Namespace)
+    rescue SmartCore::Container::ResolvingError
+      false
+    end
+
+    # @param container [SmartCore::Container]
+    # @param dependency_path [String, Symbol]
+    # @option memoized [NilClass, Boolean]
+    # @return [Boolean]
+    #
+    # @api private
+    # @since 0.5.0
+    def dependency?(container, dependency_path, memoized: nil)
+      entity = extract(container, dependency_path)
+
+      case
+      when memoized.nil?
+        entity.is_a?(SmartCore::Container::Entities::Dependency)
+      when !!memoized == true
+        entity.is_a?(SmartCore::Container::Entities::MemoizedDependency)
+      when !!memoized == false
+        entity.is_a?(SmartCore::Container::Entities::Dependency) &&
+          !entity.is_a?(SmartCore::Container::Entities::MemoizedDependency)
+      end
+    rescue SmartCore::Container::ResolvingError
+      false
+    end
+
     # @param container [SmartCore::Container]
     # @param dependency_path [String, Symbol]
     # @return [SmartCore::Container, Any]
@@ -32,12 +86,11 @@ module SmartCore::Container::DependencyResolver
     #
     # @api private
     # @since 0.1.0
-    # @version 0.1.0
     def resolve(container, dependency_path)
       entity = container
       Route.build(dependency_path).each do |cursor|
         entity = entity.registry.resolve(cursor.current_path)
-        prevent_cursor_overflow!(cursor, entity)
+        prevent_ambiguous_resolving!(cursor, entity)
         entity = entity.reveal
       end
       entity
@@ -47,6 +100,25 @@ module SmartCore::Container::DependencyResolver
 
     private
 
+    # @param container [SmartCore::Container]
+    # @param entity_path [String, Symbol]
+    # @return [SmartCore::Container::Entities::Base]
+    #
+    # @api private
+    # @since 0.5.0
+    def extract(container, entity_path)
+      resolved_entity = container
+      extracted_entity = container
+
+      Route.build(entity_path).each do |cursor|
+        resolved_entity = resolved_entity.registry.resolve(cursor.current_path)
+        extracted_entity = resolved_entity
+        resolved_entity = resolved_entity.reveal
+      end
+
+      extracted_entity
+    end
+
     # @param cursor [SmartCore::Container::DependencyResolver::Route::Cursor]
     # @param entity [SmartCore::Container::Entities::Base]
     # @return [void]
@@ -54,8 +126,8 @@ module SmartCore::Container::DependencyResolver
     # @raise [SmartCore::Container::ResolvingError]
     #
     # @api private
-    # @since 0.1.0
-    def prevent_cursor_overflow!(cursor, entity)
+    # @since 0.5.0
+    def prevent_ambiguous_resolving!(cursor, entity)
       if cursor.last? && entity.is_a?(SmartCore::Container::Entities::Namespace)
         raise(
           SmartCore::Container::ResolvingError.new(
@@ -84,10 +156,9 @@ module SmartCore::Container::DependencyResolver
     # @api private
     # @since 0.1.0
     def process_resolving_error(dependency_path, error)
-      full_dependency_path = Route.build_path(dependency_path, error.path_part)
-      raise(SmartCore::Container::ResolvingError.new(<<~MESSAGE, path_part: full_dependency_path))
-        #{error.message} (incorrect path: "#{full_dependency_path}")
-      MESSAGE
+      full_dependency_path = Route.build_path(error.path_part)
+      message = "#{error.message} (incorrect path: \"#{full_dependency_path}\")"
+      raise(SmartCore::Container::ResolvingError.new(message, path_part: full_dependency_path))
     end
   end
 end

data/lib/smart_core/container/dependency_resolver/route.rb

@@ -2,18 +2,13 @@
 
 # @api private
 # @since 0.1.0
+# @version 0.4.0
 class SmartCore::Container::DependencyResolver::Route
   require_relative 'route/cursor'
 
   # @since 0.1.0
   include Enumerable
 
-  # @return [String]
-  #
-  # @api private
-  # @since 0.1.0
-  PATH_PART_SEPARATOR = '.'
-
   class << self
     # @param path [String, Symbol]
     # @return [SmartCore::Container::DependencyResolver::Route]
@@ -28,8 +23,9 @@ class SmartCore::Container::DependencyResolver::Route
     #
     # @api private
     # @since 0.1.0
+    # @version 0.4.0
     def build_path(*path_parts)
-      path_parts.join(PATH_PART_SEPARATOR)
+      path_parts.join(SmartCore::Container::DependencyResolver::PATH_PART_SEPARATOR)
     end
   end
 
@@ -50,9 +46,10 @@ class SmartCore::Container::DependencyResolver::Route
   #
   # @api private
   # @since 0.1.0
+  # @version 0.4.0
   def initialize(path)
     @path = path
-    @path_parts = path.split(PATH_PART_SEPARATOR).freeze
+    @path_parts = path.split(SmartCore::Container::DependencyResolver::PATH_PART_SEPARATOR).freeze
     @size = @path_parts.size
   end
 

data/lib/smart_core/container/errors.rb

@@ -57,7 +57,8 @@ class SmartCore::Container
     #
     # @api private
     # @since 0.1.0
-    def initialize(messegae = nil, path_part:)
+    # @version 0.4.0
+    def initialize(message = nil, path_part:)
       @path_part = path_part
       super(message)
     end

data/lib/smart_core/container/registry.rb

@@ -7,6 +7,24 @@ class SmartCore::Container::Registry
   # @since 0.1.0
   include Enumerable
 
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.3.0
+  DEFAULT_MEMOIZATION_BEHAVIOR = false
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.4.0
+  DEFAULT_ITERATION_YIELD_BEHAVIOUR = false
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.4.0
+  DEFAULT_KEY_EXTRACTION_BEHAVIOUR = false
+
   # @return [Hash<Symbol,SmartCore::Container::Entity>]
   #
   # @api private
@@ -38,8 +56,8 @@ class SmartCore::Container::Registry
   #
   # @api private
   # @since 0.1.0
-  # @version 0.2.0
-  def register_dependency(name, memoize = true, &dependency_definition)
+  # @version 0.3.0
+  def register_dependency(name, memoize: DEFAULT_MEMOIZATION_BEHAVIOR, &dependency_definition)
     thread_safe { add_dependency(name, dependency_definition, memoize) }
   end
 
@@ -78,6 +96,30 @@ class SmartCore::Container::Registry
     thread_safe { enumerate(&block) }
   end
 
+  # @param root_dependency_name [NilClass, String]
+  # @option yield_all [Boolean]
+  # @param block [Block]
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.4.0
+  def each_dependency(
+    root_dependency_name = nil,
+    yield_all: DEFAULT_ITERATION_YIELD_BEHAVIOUR,
+    &block
+  )
+    thread_safe { iterate(root_dependency_name, yield_all: yield_all, &block) }
+  end
+
+  # @option all_variants [Boolean]
+  # @return [Array<String>]
+  #
+  # @api private
+  # @since 0.4.0
+  def keys(all_variants: DEFAULT_KEY_EXTRACTION_BEHAVIOUR)
+    thread_safe { extract_keys(all_variants: all_variants) }
+  end
+
   # @return [Hash<String|Symbol,SmartCore::Container::Entities::Base|Any>]
   #
   # @api private
@@ -152,9 +194,8 @@ class SmartCore::Container::Registry
     dependency_name = indifferently_accessable_name(entity_path)
     registry.fetch(dependency_name)
   rescue KeyError
-    raise(SmartCore::Container::ResolvingError.new(<<~MESSAGE, path_part: dependency_name))
-      Entity with \"#{dependency_name}\" name does not exist
-    MESSAGE
+    error_message = "Entity with \"#{dependency_name}\" name does not exist"
+    raise(SmartCore::Container::ResolvingError.new(error_message, path_part: dependency_name))
   end
 
   # @param dependency_name [String, Symbol]
@@ -209,6 +250,58 @@ class SmartCore::Container::Registry
     namespace_entity.tap { namespace_entity.append_definitions(dependencies_definition) }
   end
 
+  # @param root_dependency_name [String, NilClass]
+  # @param block [Block]
+  # @option yield_all [Boolean]
+  # @yield [dependency_name, dependency]
+  # @yield_param dependency_name [String]
+  # @yield_param dependency [Any]
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.4.0
+  def iterate(root_dependency_name = nil, yield_all: DEFAULT_ITERATION_YIELD_BEHAVIOUR, &block)
+    enumerator = Enumerator.new do |yielder|
+      registry.each_pair do |dependency_name, dependency|
+        final_dependency_name =
+          if root_dependency_name
+            "#{root_dependency_name}" \
+            "#{SmartCore::Container::DependencyResolver::PATH_PART_SEPARATOR}" \
+            "#{dependency_name}"
+          else
+            dependency_name
+          end
+
+        case dependency
+        when SmartCore::Container::Entities::Dependency
+          yielder.yield(final_dependency_name, dependency.reveal)
+        when SmartCore::Container::Entities::Namespace
+          yielder.yield(final_dependency_name, dependency.reveal) if yield_all
+          dependency.reveal.registry.each_dependency(
+            final_dependency_name,
+            yield_all: yield_all,
+            &block
+          )
+        end
+      end
+    end
+
+    block_given? ? enumerator.each(&block) : enumerator.each
+  end
+
+  # @option all_variants [Boolean]
+  # @return [Array<String>]
+  #
+  # @api private
+  # @since 0.4.0
+  def extract_keys(all_variants: DEFAULT_KEY_EXTRACTION_BEHAVIOUR)
+    Set.new.tap do |dependency_names|
+      iterate(yield_all: all_variants) do |dependency_name, _dependency|
+        dependency_names << dependency_name
+      end
+    end.to_a
+  end
+
   # @param name [String, Symbol]
   # @return [void]
   #

data/lib/smart_core/container/version.rb

@@ -4,7 +4,7 @@ module SmartCore
   class Container
     # @api public
     # @since 0.1.0
-    # @version 0.2.0
-    VERSION = '0.2.0'
+    # @version 0.7.0
+    VERSION = '0.7.0'
   end
 end

data/smart_container.gemspec

@@ -3,7 +3,7 @@
 require_relative 'lib/smart_core/container/version'
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.4.9')
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.4.10')
 
   spec.name    = 'smart_container'
   spec.version = SmartCore::Container::VERSION
@@ -27,12 +27,12 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'smart_engine', '~> 0.2'
+  spec.add_dependency 'smart_engine', '~> 0.5'
 
   spec.add_development_dependency 'bundler',          '~> 2.1'
   spec.add_development_dependency 'rake',             '~> 13.0'
   spec.add_development_dependency 'rspec',            '~> 3.9'
-  spec.add_development_dependency 'armitage-rubocop', '~> 0.78'
-  spec.add_development_dependency 'simplecov',        '~> 0.17'
-  spec.add_development_dependency 'pry',              '~> 0.12'
+  spec.add_development_dependency 'armitage-rubocop', '~> 0.81'
+  spec.add_development_dependency 'simplecov',        '~> 0.18'
+  spec.add_development_dependency 'pry',              '~> 0.13'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smart_container
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-01-05 00:00:00.000000000 Z
+date: 2020-06-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: smart_engine
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -72,42 +72,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.78'
+        version: '0.81'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.78'
+        version: '0.81'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.18'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.13'
 description: Thread-safe semanticaly-defined IoC/DI Container
 email:
 - iamdaiver@gmail.com
@@ -178,7 +178,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.9
+      version: 2.4.10
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="