low_dependency 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb969f9e394ddc2e6e0b4669e58736b14ea78b7539495035c51a11765d8c365b
-  data.tar.gz: 19144722e967c2d936a039d1667701b552cb0db4f78aa737c8ac6a24aef137d7
+  metadata.gz: 6b0a13e9a844071f5d62b2f5c406738ea8e6a91eb5739d437c76e58880e6af7a
+  data.tar.gz: 67ae806313dd6bad24f796bc143436fb4cbfbc65dbc3a06a71b67a5eab0be447
 SHA512:
-  metadata.gz: b3fd43c0ded0f0c9e5b6390c45c2638395fc3fc75ef085038fdd70749ff8fba83435ffa33862e289d50f8b99bc4368179d5922287a0dc977e6aa810f52f1a176
-  data.tar.gz: da84dd6d96730943ae4d23228108e1186f2657d53bcf4387ae15cddcefbecbdba1716c48149a8ddd82834308f910d3354281926a1a2360c9c910597eb734f0cf
+  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

@@ -4,22 +4,20 @@ require_relative '../expressions/dependency'
 
 module Low
   class DependencyFactory
-    include LowType
-
     class << self
-      def parse(dependencies = Array)
+      def parse(dependencies)
         class_dependencies = []
 
         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

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'low_type'
 require_relative 'config/config'
 require_relative 'expressions/dependency'
 require_relative 'factories/dependency_factory'
@@ -13,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])
 
@@ -36,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
 
@@ -52,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

@@ -3,7 +3,10 @@
 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)
@@ -18,6 +21,14 @@ module Low
         providers[provider_key]
       end
 
+      # Providers[] is harder to stub in tests and should only be used when dependency injection isn't possible.
+      def [](provider_key)
+        provider = providers[provider_key]
+        raise(MissingProviderError, "Provider #{provider_key.inspect} not found") if provider.nil?
+
+        provider.result
+      end
+
       def all
         providers
       end

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Low
-  DEPENDENCY_VERSION = '0.2.0'
+  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.0
+  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: