helium-dependency 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3c477fdd6eae79003d31bd5f809f152e600f490c0924c77359c63084f39a637
-  data.tar.gz: a1c782280618b56c55bbbea4a134d51e34649e434fccfc8ff6f1924b2a3a06c2
+  metadata.gz: e4bd58694ef42a91e52faa8df95f2e5a07ec62d243810dbb838119c4565dacc6
+  data.tar.gz: 6aa2e549751835d4e9da275724003657c49f96124e34f3ca565e39a6d62fc1be
 SHA512:
-  metadata.gz: 697acb06244340a05a6d4b09386e5a6fd3690e0cf7a0e3c6ac77ea59b62e02c5c0a2ff06caaaa1e3f7752c4308afbfbf11d151baf5cb18b3aae10ad461fc0ad1
-  data.tar.gz: fa339c5751f62dec3d0c7217123d528a1d45397c558cbc7010cef58fd008f92899f81c7484ac97ee3fb518d230b25811a26ebd77f2ca74a80cd742d061d51cb4
+  metadata.gz: 94ec932a3e80a1114a5a95460a059ed2dbb35d6676ce5c19c0d08ab7470b74a805989be6c02c79cd315f8cdad36594f0b65cd8b9debf9f094b3575f9f321d0d0
+  data.tar.gz: 29e6060e937216a3985be5a8400ac9a9aed828bc1dfe9825eee6aff198ce06e3eaa24ae5db5eca968e5c721fad49add9952168613876797881972eaf33cbabfb

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    helium-dependency (0.1.0)
+    helium-dependency (0.1.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,8 +1,6 @@
 # Helium::Dependency
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/helium/dependency`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+Simple dependency inkjection for Ruby object.
 
 ## Installation
 
@@ -22,7 +20,34 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+Simply include `Helium::Dependency` and then define the list of dependencies, together with a block to create default injection.
+Injected value are already available when the default block is evaluated, so dependencies can reference each other.
+
+```
+class Bike
+  include Helium::Dependency
+
+  dependency(:wheel_size) { 26 }
+  dependency(:wheels, public: true) { Array.new(2) { Wheel.new(size: wheel_size) } }
+end
+
+Bike.new(wheel_size: 20).wheels #=> [#Wheel(@size: 20), #Wheel(@size: 20)]
+```
+
+Injection happens in the class `new` method before `initialize` is called, so you can define your own initialization and use dependencies inside it.
+
+```
+class NamedBike < Bike
+  def initialize(name)
+    @name = "#{name} (#{wheels.map(&:size).join(', ')})"
+  end
+
+  attr_reader :name
+end
+
+NamedBike.new("Steven").name #=> "Steven (26, 26)"
+NamedBike.new("Lil Steven", wheel_size: 16).name #=> "Lil Steven (16, 16)"
+```
 
 ## Development
 

data/lib/helium/dependency.rb

@@ -6,18 +6,37 @@ module Helium
 
     def self.included(mod)
       mod.extend ClassMethods
-      mod.prepend Initialization
     end
 
     module ClassMethods
-      def dependency(name, &default_block)
+      def new(*args, **kwargs, &block)
+        instance = allocate
+
+        deps = {}
+        dependencies.each do |dep|
+          next unless kwargs.key?(dep)
+          deps[dep] = kwargs.delete(dep)
+        end
+
+        instance.instance_variable_set(:@deps, deps)
+
+        if kwargs.any?
+          instance.send :initialize, *args, **kwargs, &block
+        else
+          instance.send :initialize, *args, &block
+        end
+
+        instance
+      end
+
+      def dependency(name, public: false, &default_block)
         dependencies << name
 
         define_method(name) do
           @deps[name] ||= instance_exec(&default_block)
         end
 
-        private name
+        private(name) unless public
       end
 
       def dependencies
@@ -25,22 +44,5 @@ module Helium
       end
     end
 
-    module Initialization
-      def initialize(*args, **kwargs, &block)
-        @deps = {}
-
-        self.class.dependencies.each do |dep|
-          next unless kwargs.key?(dep)
-
-          @deps[dep] = kwargs.delete(dep)
-        end
-
-        if kwargs.any?
-          super *args, **kwargs, &block
-        else
-          super *args, &block
-        end
-      end
-    end
   end
 end

data/lib/helium/dependency/version.rb

@@ -1,5 +1,5 @@
 module Helium
   module Dependency
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: helium-dependency
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Stanislaw Klajn
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-07-08 00:00:00.000000000 Z
+date: 2021-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler