smart_container 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb1bc1e5f80263730638b0b0387105364777f87e957b5f673c27c219f206273d
-  data.tar.gz: 0d1a505edb3b4456ab44ecfe52071b1cb5555f51680d3a48de68fb12bd11dcad
+  metadata.gz: 92746ed446b181dc165a597563edc69b62b41550974023342c4693f2c17dee6a
+  data.tar.gz: 1cf3862c40c1044510a11e09f19df542a8d0b3a255bd0df5593ad9c531b9f10b
 SHA512:
-  metadata.gz: 3959674748c1dcc2564bd6edc9ee0acdc3770b0bd260d50c7a1bba5906fee6725ff577e90a2b36b0a81910c423020431810b2a052f42c65826bfc8dcabe7dc22
-  data.tar.gz: f01f97eda299d91b22f730de1eba90e546f9f4de0362218bc0b8f86d8800acd6abf3d2214e223c0246f5c1d4b4742b71c7223ada409a3665765c088c88ab207e
+  metadata.gz: ec6db288f98f769d0bbe96dd4d35186d1a199f6e046edf1de83a50c4b76149366c94a7c172a005378be88c8e8503436b9dad7e2518bcbae1de939b2a37204600
+  data.tar.gz: 9124de765215847cb7bd135a19524043652b9f9d7580027106a43cc6fa8f61a3bfd22c982cf07b1f46ea196b6fdae978d0973682a9c24511eb679d7c310b33a7

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [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

data/README.md

@@ -70,6 +70,19 @@ 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 }
+end
+
+container.register('game_api') { 'overwatch' }
+
+container['api.provider'] # => GoogleProvider
+container['game_api'] # => 'overwatch'
+```
+
 - container keys (dependency names):
 
 ```ruby
@@ -99,6 +112,42 @@ container.keys(all_variants: true)
 ]
 ```
 
+- 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:
+
+```ruby
+# documentation is coming;
+```
+
+- reloading:
+
+```ruby
+# documentation is coming;
+```
+
 ---
 
 ## Contributing

data/lib/smart_core/container/dependency_resolver.rb

@@ -26,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]
@@ -38,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
@@ -53,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]
@@ -60,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(

data/lib/smart_core/container/version.rb

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

data/lib/smart_core/container.rb

@@ -114,6 +114,34 @@ module SmartCore
       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]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smart_container
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-01-06 00:00:00.000000000 Z
+date: 2020-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: smart_engine