hypo 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f95c8eb6eb6a8fdcef40c219b52f93ef7f019e57
-  data.tar.gz: 3026722dd03cdb35709b13c0325b72fd248c3841
+  metadata.gz: 2e0d6a53f9f9c68dce9af65d0eaef9b209fd54c6
+  data.tar.gz: 70d8862335541f7f9973c93f49934492fef939ca
 SHA512:
-  metadata.gz: ea62c01f490442eb5456e23294dda1559b2c96837e85c3f04fe9a2aa4b2b263f24fb16c5c086d3171bd67176f0c94041db39883039d14325a236b064f9bf5c23
-  data.tar.gz: 1f26a3b5bedefd8a8ab10a5527e20228769e910402686519dd291c55b461bcd88d5a389eba52595dd170fcb3d4abd34279310e6c26d96e4765fa1d450ce22dce
+  metadata.gz: 8a2412d9b4226b8816db156cf2cc45ca763dc227005071b1f704263584af6c0b4ae45d14a994d1dd65b3a8c66ab73744311abe619a556b3c611dc8fb2e8b1519
+  data.tar.gz: 2e03e94c0303e02b175d54bdfa94d880d027b5b68d0152c2d9d56b7f9ba952cf7fb5a64b7de2e14f7182b0ca34d1fcbabe573da954fcf6e712b16132cce8e5d3

data/README.md

@@ -142,8 +142,19 @@ lifetime.purge
 
 #### Lifetime :scope
 For most of cases when you need to bind dependency lifetime to lifetime of another item of your application
-you can use Hypo::Lifetime::Scope (:scope) strategy.
+you can use Hypo::Lifetime::Scope (:scope) strategy. In order to to that first of all you should implement a scope:
 
+```ruby
+class Request
+  include Hypo::Scope
+    
+  def handle
+    # do something
+    release
+    # return a result
+  end
+end
+``` 
 
 ```ruby
 # somewhere in Rack application: application initialization
@@ -159,14 +170,27 @@ container
 container
     .register_instance(request, :request)
     .using_lifetime(:scope)
-    .bound_to(request) # an object
+    .bound_to(request) # the scope!
 
-# handle the request
-# ...
-
-lifetime.purge(request)
+request.handle
 ``` 
 
+
+:scope lifetime supports a finalizing for its objects. Class with such ability should respond to "finalize" method:
+
+```ruby
+class SQLTransation
+  def initialize
+    @transaction = DB.begin_transaction
+  end
+  
+  def finalize
+    @transaction.commit
+  end
+end
+```
+Method "finalize" calls on scope releasing (Hypo::Scope#release).
+
 ### Remove components
 Sometimes you need to manage a component lifetime 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:

data/lib/hypo/component.rb

@@ -7,7 +7,7 @@ module Hypo
     include ScopeFriendly
     include LifetimeFriendly
 
-    attr_reader :name, :type, :container, :lifetime, :scope
+    attr_reader :name, :type, :container, :lifetime
 
     def initialize(type, container, name = nil)
       @container = container

data/lib/hypo/container.rb

@@ -3,6 +3,7 @@ require 'hypo/component'
 require 'hypo/instance'
 require 'hypo/lifetime/transient'
 require 'hypo/lifetime/singleton'
+require 'hypo/lifetime/scope'
 
 module Hypo
   class Container

data/lib/hypo/lifetime/scope.rb

@@ -6,11 +6,6 @@ module Hypo
       end
 
       def instance(component)
-        if component.scope.nil?
-          raise ContainerError, "Component \"#{component.name}\" must be bound to a scope" \
-            " according to Hupo::Lifetime::Scope lifetime strategy"
-        end
-
         scope = component.scope.object_id
         @instances[scope] = {} unless @instances.key? scope
 
@@ -26,6 +21,10 @@ module Hypo
       end
 
       def purge(scope)
+        @instances[scope.object_id].each_value do |instance|
+          instance.finalize if instance.respond_to? :finalize
+        end
+
         @instances.delete scope.object_id
       end
     end

data/lib/hypo/lifetime_friendly.rb

@@ -1,7 +1,11 @@
 module Hypo
   module LifetimeFriendly
-    def use_lifetime(lifetime)
-      @lifetime = @container.lifetimes[lifetime]
+    def use_lifetime(name)
+      unless @container.lifetimes.key? name
+        raise ContainerError, "Lifetime with name \"#{name}\" is not registered"
+      end
+
+      @lifetime = @container.lifetimes[name]
 
       self
     end

data/lib/hypo/scope.rb

@@ -0,0 +1,7 @@
+module Hypo
+  module Scope
+    def release
+      @container.lifetimes[:scope].purge(self)
+    end
+  end
+end

data/lib/hypo/scope_friendly.rb

@@ -2,7 +2,7 @@ module Hypo
   module ScopeFriendly
     def bind_to(scope)
       if scope.is_a? Symbol
-        @scope = @container.resolve(scope)
+        @scope_name = scope
       else
         @scope = scope
       end
@@ -10,6 +10,15 @@ module Hypo
       self
     end
 
+    def scope
+      if @scope.nil? && @scope_name.nil?
+        raise ContainerError, "Component \"#{@name}\" must be bound to a scope" \
+            " according to Hypo::Lifetime::Scope lifetime strategy"
+      end
+
+      @scope || @container.resolve(@scope_name)
+    end
+
     alias bound_to bind_to
   end
 end

data/lib/hypo/version.rb

@@ -1,3 +1,3 @@
 module Hypo
-  VERSION = '0.8.0'
+  VERSION = '0.8.1'
 end

data/lib/hypo.rb

@@ -1,5 +1,6 @@
 require 'hypo/version'
 require 'hypo/container'
+require 'hypo/scope'
 
 module Hypo
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hypo
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Vladimir Kalinkin
@@ -78,6 +78,7 @@ files:
 - lib/hypo/lifetime/singleton.rb
 - lib/hypo/lifetime/transient.rb
 - lib/hypo/lifetime_friendly.rb
+- lib/hypo/scope.rb
 - lib/hypo/scope_friendly.rb
 - lib/hypo/version.rb
 homepage: https://github.com/cylon-v/hypo