low_dependency 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 075ac4a80826125fc91b875a75713e886b1e97a61df624e3a627c00fad361869
-  data.tar.gz: b6cff0dfb63fb8dac55f017fb0c69a2fc38282cebf7daee3d6b320f5f285c096
+  metadata.gz: 6b0a13e9a844071f5d62b2f5c406738ea8e6a91eb5739d437c76e58880e6af7a
+  data.tar.gz: 67ae806313dd6bad24f796bc143436fb4cbfbc65dbc3a06a71b67a5eab0be447
 SHA512:
-  metadata.gz: 752c6eeb2d63d3986cb9515a016ef70dcf48beb31318c7b43c28fa042404019b70901fe88e881401796b2dd7707f6547f05131deafcbb8ccca9862a51239422f
-  data.tar.gz: 4802aad346e2e897e7e4678b7ead34fbed27e01c229dde55859937e9794c5d852eb24320a05358693439e84130d241a7bd4d7dd8c629678cfdb8a0a52e2bfcc9
+  metadata.gz: 268a0167f2823345223ccf8fa2d28799f58cd530b8d52cb233cd5b84bd7af44464551ac8375eaf9a60f48b6ae977b8801937694810783d4dcf4a9d1866caa25a
+  data.tar.gz: fe8dfa1f39c7e1dd889319e37c7ced72febcb093b17b4ff348110201214ddf131cdce269eb6182e3357bb1e1b0fead518efc060ecfdadf226c1ca65063dd93f6

data/lib/expressions/dependency.rb

@@ -3,20 +3,35 @@
 require 'expressions'
 
 module Low
+  # A Dependency Expression requires LowType in order to be injected via a constructor.
+  # See "LowDependency[:dependency]" for traditional dependency injection without LowType.
   class Dependency < Expressions::Expression
-    attr_reader :key, :var
+    attr_reader :provider_key, :var_name
 
-    def initialize(var:)
+    def initialize(provider_key: nil, var_name: nil)
       super()
 
-      @key = var
-      @var = var
+      @provider_key = provider_key || var_name
+      @var_name = var_name
     end
 
+    def required?
+      false
+    end
+
+    # Inject dependency via LowType's default value.
+    def default_value
+      Providers[@provider_key]
+    end
+
+    # Ignore LowType's validation of arguments of type Dependency.
+    def validate!(value:, proxy:); end
+
     private
 
-    def receive_value(value)
-      @key = value
+    def union_value(value)
+      @provider_key = value
+      @var_name = LowDependency.var_name_via_namespace(value)
     end
   end
 end

data/lib/factories/dependency_factory.rb

@@ -11,13 +11,13 @@ module Low
         dependencies.each do |dependency|
           case dependency
           when Hash
-            key = dependency.keys.first
-            dependency = dependency[key]
+            provider_key = dependency.keys.first
+            dependency = dependency[provider_key]
           else
-            key = dependency
+            provider_key = dependency
           end
 
-          class_dependencies << (Dependency.new(var: dependency) | key)
+          class_dependencies << (Dependency.new(var_name: dependency) | provider_key)
         end
 
         class_dependencies

data/lib/low_dependency.rb

@@ -12,7 +12,7 @@ class LowDependency
       Low::Providers.provide(key:, &block)
     end
 
-    # "include LowDependency[:dependency]"
+    # Usage: "include LowDependency[:dependency]"
     def [](*dependencies)
       class_dependencies = Low::DependencyFactory.parse([*dependencies])
 
@@ -35,11 +35,11 @@ class LowDependency
 
             def initialize
               self.class.low_dependencies.each do |dependency|
-                provider = Low::Providers.find(dependency.key)
-                raise StandardError, "Provider #{dependency.key} not found" if provider.nil?
+                provider = Low::Providers.find(dependency.provider_key)
+                raise StandardError, "Provider #{dependency.provider_key} not found" if provider.nil?
 
-                var = LowDependency.provider_from_namespace(dependency.var)
-                instance_variable_set("@#{var}", provider.result)
+                var_name = LowDependency.var_name_via_namespace(dependency.var_name)
+                instance_variable_set("@#{var_name}", provider.result)
               end
             end
 
@@ -51,15 +51,15 @@ class LowDependency
 
     def define_readers(dependencies, klass)
       dependencies.each do |dependency|
-        var = provider_from_namespace(dependency.var)
+        var_name = var_name_via_namespace(dependency.var_name)
 
-        klass.define_method(var) do
-          instance_variable_get("@#{var}")
+        klass.define_method(var_name) do
+          instance_variable_get("@#{var_name}")
         end
       end
     end
 
-    def provider_from_namespace(namespace)
+    def var_name_via_namespace(namespace)
       return namespace.split('.').last if namespace.is_a?(String)
 
       namespace

data/lib/repositories/providers.rb

@@ -5,6 +5,8 @@ require_relative '../models/provider'
 module Low
   # Private API. Public methods exposed via LowDependency.
   class Providers
+    class MissingProviderError < StandardError; end
+
     class << self
       def provide(key:, &block)
         providers[key] = Provider.new(key:, &block)
@@ -19,9 +21,12 @@ module Low
         providers[provider_key]
       end
 
-      # Usage: def initialize(dependency: Low::Providers[:dependency])
+      # Providers[] is harder to stub in tests and should only be used when dependency injection isn't possible.
       def [](provider_key)
-        providers[provider_key].result
+        provider = providers[provider_key]
+        raise(MissingProviderError, "Provider #{provider_key.inspect} not found") if provider.nil?
+
+        provider.result
       end
 
       def all

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Low
-  DEPENDENCY_VERSION = '0.2.1'
+  DEPENDENCY_VERSION = '0.3.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: low_dependency
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - maedi
@@ -13,16 +13,16 @@ dependencies:
   name: expressions
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.1'
 description: Automatic Dependency Injection where you get to see and keep control
   of the constructor
 email: