invokr 0.0.6 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9f813b2a7451887b13d734bf67a3dacb9c5046a8
-  data.tar.gz: 95c15ca02dcbfc7ba1a938d4926533c9800b2e42
+  metadata.gz: d465d0fe3a99374d9964c837dd835e2686ea18e4
+  data.tar.gz: 6f524e10b9b8dcd60755ac40ea7264835370cf5d
 SHA512:
-  metadata.gz: 9ba3d9a231c5c359ea78b10932fea381cd1e15c765704a57cc5bd40905472581674df5c40782dc3cb268b72031a01344fd98707b997cb07584a029831b0fe648
-  data.tar.gz: acd9c17ba32c4e05031dddf856a07ce3aec1d45ac00d0feae5a251bc3af7e774eb5c726ad0de4873a2c92af36453429fa6d8ba16a54df2ea45374ba24ae88b58
+  metadata.gz: aeb433d0fcc41411665277604feab0b684f82a0f3cbdfd86cab9a9822d93aa2af2b27b5f5856fc95f8f6578d2291860d74a295e54c7338bd4852a1f7061b5534
+  data.tar.gz: 68128087cca50df10d2186934160052d6a809c93f1f8d078c6025cb57a2825ac7b52ef824dab49e4475b7235647715796cf0f446787eac1b45f147f38cc2827b

data/README.md

@@ -70,7 +70,7 @@ Before ruby 2.x introduced keyword arguments, it was common to end your method s
 
 ## Dependency injection
 
-One of the use cases for Invokr is building abstract factories. In this case, you want to inspect the method signature of `Object#initialize`, but actually pass `.new` to the class to have it allocate memory and invoke the initializer for you. Since this is a weird case, there's some support to make building a dependency injector much easier, just make sure you explictily `require "invokr/dependency_injection"` and then check out `test/dependency_injection_example_test.rb` for how it is used. Basically, your factory object just needs to implement a method called `resolve` that takes in the name of a dependency that maps to a parameter on the `#initialize` method for the class you're trying to build out.
+One of the use cases for Invokr is building abstract factories. In this case, you want to inspect the method signature of `Object#initialize`, but actually pass `.new` to the class to have it allocate memory and invoke the initializer for you. Check out `test/dependency_injection_example_test.rb` for how it is used. You can use a hash to serve as the registry of objects, or build your own custom resolver.
 
 ## Contributing
 

data/lib/invokr.rb

@@ -1,5 +1,12 @@
 require 'delegate'
 
+require_relative 'invokr/builder'
+require_relative 'invokr/dependency_injection'
+require_relative 'invokr/errors'
+require_relative 'invokr/invocation'
+require_relative 'invokr/method'
+require_relative 'invokr/version'
+
 module Invokr
   extend self
 
@@ -11,6 +18,17 @@ module Invokr
     end
   end
 
+  def inject obj, args = {}
+    using = require_arguments! args, :using
+    DependencyInjection.inject obj, using
+  end
+
+  def query_method method
+    Method.new method
+  end
+
+  private
+
   def invoke_method args = {}
     method_name, obj, hsh_args = require_arguments! args, :method, :on, :with
     method = obj.method method_name
@@ -18,19 +36,13 @@ module Invokr
     invocation.invoke! obj
   end
 
-  def invoke_proc _proc, args
+  def invoke_proc _proc, args = {}
     hsh_args = require_arguments! args, :with
     invocation = Builder.build _proc, hsh_args, args[:block]
     obj = SimpleDelegator.new _proc
     invocation.invoke! obj
   end
 
-  def query_method method
-    Method.new method
-  end
-
-  private
-
   def require_arguments! hsh, *args
     found_args, missing_args = args.partition do |arg|
       hsh.has_key? arg
@@ -40,9 +52,3 @@ module Invokr
     args.size == 1 ? list.first : list
   end
 end
-
-require_relative 'invokr/builder'
-require_relative 'invokr/errors'
-require_relative 'invokr/invocation'
-require_relative 'invokr/method'
-require_relative 'invokr/version'

data/lib/invokr/dependency_injection.rb

@@ -1,28 +1,82 @@
 module Invokr
   module DependencyInjection
-    def self.inject args = {}
-      klass = args.fetch :klass
-      resolver = args.fetch :using
-      injector = Injector.new resolver, klass
-      injector.inject
+    extend self
+
+    def inject obj, using
+      meth = case obj
+             when Proc then :inject_proc
+             when Class then :inject_klass
+             else raise ArgumentError, "can't inject #{obj.inspect}"
+             end
+      resolver = build_resolver using
+      send meth, obj, resolver
     end
 
-    Injector = Struct.new :resolver, :klass do
-      def inject
-        method = Invokr.query_method klass.instance_method :initialize
-        method.invoke method: :new, with: self
+    private
+
+    def build_resolver using
+      if using.is_a? Hash
+        HashResolver.new using
+      else
+        using
       end
+    end
+
+    def inject_klass klass, resolver
+      injector = KlassInjector.new resolver, klass
+      injector.inject
+    end
+
+    def inject_proc proc, resolver
+      injector = ProcInjector.new resolver, proc
+      injector.inject
+    end
 
+    Injector = Struct.new :resolver, :obj do
       def keys
-        initializer.parameters.map { |_, identifier| identifier }
+        method.parameters.map { |_, identifier| identifier }
       end
 
       def fetch arg, &default
         resolver.resolve arg, &default
       end
+    end
+
+    class KlassInjector < Injector
+      def inject
+        _method = Invokr.query_method method
+        _method.invoke :method => :new, :with => self
+      end
+
+      def method
+        obj.instance_method :initialize
+      end
+    end
+
+    class ProcInjector < Injector
+      def inject
+        Invokr.invoke :proc => obj, :with => self
+      end
+
+      def method
+        obj
+      end
+    end
+
+    class HashResolver
+      def initialize hsh
+        @hsh = hsh
+      end
+
+      def inject klass
+        DependencyInjection.inject(
+          :klass => klass,
+          :using => self,
+        )
+      end
 
-      def initializer
-        klass.instance_method :initialize
+      def resolve val
+        @hsh.fetch val
       end
     end
   end

data/lib/invokr/version.rb

@@ -1,3 +1,3 @@
 module Invokr
-  VERSION = "0.0.6"
+  VERSION = "0.1.0"
 end

data/test/dependency_injection_example_test.rb

@@ -1,33 +1,32 @@
-require 'invokr/dependency_injection'
+require 'ostruct'
 
 class DependencyInjectionExampleTest < Minitest::Test
-  def setup
-    @injector = TestInjector.new(
-      :album => 'farmhouse',
-      :guitarist => 'trey',
-      :drummer => 'fishman',
+  def test_dependency_injection
+    obj = Invokr.inject(
+      TestObject,
+      :using => {
+        :album => 'farmhouse',
+        :guitarist => 'trey',
+        :drummer => 'fishman',
+      },
     )
-  end
 
-  def test_dependency_injection
-    @injector.inject TestObject
+    assert_equal 'farmhouse', obj.album
+    assert_equal 'trey', obj.guitarist
   end
 
-  class TestInjector
-    def initialize hsh
-      @hsh = hsh
-    end
+  def test_injecting_a_proc
+    my_proc = -> foo do OpenStruct.new foo: foo end
 
-    def inject klass
-      Invokr::DependencyInjection.inject(
-        :klass => klass,
-        :using => self,
-      )
-    end
+    obj = Invokr.inject(
+      my_proc,
+      :using => {
+        :foo => 'bar',
+        :ping => 'pong',
+      }
+    )
 
-    def resolve val
-      @hsh.fetch val
-    end
+    assert_equal 'bar', obj.foo
   end
 
   class TestObject

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: invokr
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.1.0
 platform: ruby
 authors:
 - ntl
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-23 00:00:00.000000000 Z
+date: 2014-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler