hypo 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1671c3b418f72e704152244916967ebe0c2288d4
-  data.tar.gz: 55fde3998486b713e045de9878e45fa5ac336242
+  metadata.gz: 1a5df4c1be9652a444db79865461197009cf9b49
+  data.tar.gz: 71d0370d8cf8f3e9f672651c1ecab2e61e477047
 SHA512:
-  metadata.gz: bcd9ba4639e366d6f74f7275561aa9bc4c2a84c16907f7521dfb07c63564d8d4dcf9f011b7ff68738a8108ee3c7747d3eb6c48371d79f69aa7a25af052d76fe2
-  data.tar.gz: 267d919d6d1c9a2316747c47a3f94f95072a55137972cd8aa93ee4c471577b298fc7d165dc959f0ee9842afba1e3cd0a49666bb015789a3a392acad84104fdf7
+  metadata.gz: 19459aa0a3c3a230855b25d3750c2540d958732698791f02dce185ff6b2a7c3de885b10ba84e8b303495a5aa11cb811a6eaf862efce9f98265613c855892e58b
+  data.tar.gz: d852deaa4743bcf8783c5a4da1a3f752c6e9897926005acae1873107b22607edd68c1065fc1619eca12e40fea0e5ec621cdc72a71deb3c97ae82d5894a595528

data/README.md

@@ -73,10 +73,8 @@ end
 In that case you can register an instance instead of a type:
 ```ruby
 connection = DB.connect
-container.register(connection, :connection)    
+container.register_instance(connection, :connection)    
 ``` 
-You must specify component name as it's done in example above.
-
 ## Component Life Cycle
 By default all registered components have life cycle Hypo::Transient (:transient). 
 It means, every time when you resolve a component Hypo returns new instance of its type.
@@ -89,6 +87,44 @@ container.register(User).using_life_cycle(:singleton)
 Actually you can implement your own life cycle, 
 i.e. makes sense to think about HttpRequest strategy for your web applications.
 
+**Instances support only :singleton life cycle.** 
+
+Sometimes you need to manage a component life cycle manually. Especially it can be useful for "instances".
+For example, you're going to inject new instance of request parameters every http request in your web application:
+
+```ruby
+# somewhere in Rack application
+# ...
+query_string = env['QUERY_STRING']
+container.register_instance(query_string, :query_string)
+
+# handle the request
+
+container.remove(:query_string)
+# ...
+```
+
+Hypo resolves components with different life cycle strategies independently. 
+In other words you can inject a dependency with less lifespan than acceptor type. I.e.:
+
+```ruby
+class A; end
+
+class B
+  def initialize(type_a)
+    @type_a = type_a
+  end
+end
+
+
+container.register(A, :type_a).using_life_cycle(:transient)
+container.register(B, :type_b).using_life_cycle(:singleton)
+
+```
+
+According to :transient strategy every time when you try to resolve a singleton 
+you retrieve exactly the same instance of the singleton **but with new instance** of transient dependency.    
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/hypo/container.rb

@@ -13,12 +13,16 @@ module Hypo
       @life_cycles = {}
       add_life_cycle(LifeCycle::Transient.new, :transient)
       add_life_cycle(LifeCycle::Singleton.new, :singleton)
-      register self, :container
+      register_instance self, :container
     end
 
     def register(item, name = nil)
-      type = item.is_a?(Class) ? Component : Instance
-      component = type.new(item, self, name)
+      unless item.is_a?(Class)
+        raise ContainerError, 'Using method "register" you can register only a type. ' \
+          'If you wanna register an instance please use method "register_instance".'
+      end
+
+      component = Component.new(item, self, name)
 
       if @components.key?(component.name)
         raise ContainerError, "Component \"#{component.name}\" has already been registered"
@@ -27,6 +31,20 @@ module Hypo
       @components[component.name] = component
     end
 
+    def register_instance(item, name)
+      if item.is_a?(Class)
+        raise ContainerError, 'Using method "register_instance" you can register only an instance. ' \
+          'If you wanna register a type please use method "register".'
+      end
+
+      if @components.key?(name)
+        raise ContainerError, "Component \"#{name}\" has already been registered"
+      end
+
+      instance = Instance.new(item, self, name)
+      @components[name] = instance
+    end
+
     def resolve(name)
       unless @components.key?(name)
         raise ContainerError, "Component with name \"#{name}\" is not registered"

data/lib/hypo/version.rb

@@ -1,3 +1,3 @@
 module Hypo
-  VERSION = '0.6.2'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hypo
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - Vladimir Kalinkin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-09-17 00:00:00.000000000 Z
+date: 2017-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler