operation 1.3.2 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8081d9d41eb780b0a6cfd9eab6d0c52e1943200e
-  data.tar.gz: c97901feb589bd338c2d4973348a75532f247f8c
+  metadata.gz: 4c5ab2af692001edf354b6c55769c944e0d6b305
+  data.tar.gz: 6e90ab32338fe7d2ee8b5c2587cb5f80366fcda3
 SHA512:
-  metadata.gz: 628bf4e3a84a7398fbb19662f5e1f0eddf7534bd819b8f06643ae751d76f49c42737f7bbeb57b21a5003e46ed9d9e69a3a7b82d09741117e523c438515491f4e
-  data.tar.gz: a14af00be7b85f775a043aec4d11cfca155aa6acf11d77ad05728bd12499d860390eb904e1cd95f2e5a7fa96b4a6e398c6e641178ce777991f34c43301f7cb4f
+  metadata.gz: a82fdaddecfd11cc0807048b908ac4ca11af4c03ee48033d43c6083f30329a8d0d815bb51085154d5913313bf69c93e73c7692b99081ca18e09acb23c9d7694d
+  data.tar.gz: f2656a9c0e58277130dcf18fe48e8e2e0d1008dffedc26a106ae448944d5746025dda1ede2e31d649289b50bd78d711d760cb6374c3555c0010588a70979ef94

data/lib/operation/deferrable.rb

@@ -4,6 +4,17 @@ class Operation
 
     # Public Callbacks
 
+    def on_start(&block)
+      return unless block
+
+      if started?
+        block.call
+      else
+        startables.unshift block
+      end
+      self
+    end
+
     def on_progress(&block)
       return unless block
       progressables.unshift block
@@ -36,7 +47,7 @@ class Operation
       return unless block
 
       if succeeded? || failed?
-        block.call(*arguments)
+        block.call
       else
         finishables.unshift block
       end
@@ -62,16 +73,22 @@ class Operation
       status == :failed
     end
 
+    def started?
+      status != :unknown
+    end
+
     # Public State Setters
 
     def progress!(new_percent, code = nil)
       return if succeeded? || failed?
       @percent = new_percent.to_i
+      start! unless started?
       @status = code unless [:succeeded, :failed].include?(code)
 
       progressables.each do |callback|
         callback.call self
       end
+      self
     end
 
     def sub_progress!(from, till, sub)
@@ -82,6 +99,11 @@ class Operation
         new_percent = from.to_i + factor.to_i
       end
       progress! new_percent, sub.status
+      self
+    end
+
+    def start!(*args)
+      set_status :started, *args
     end
 
     def succeed!(*args)
@@ -98,28 +120,48 @@ class Operation
       @arguments = args unless args.empty?
       @status = new_status
 
+      call_startables!
       if succeeded? && !successables.empty?
         while callback = successables.pop
           callback.call(*arguments)
         end
-        while callback = finishables.pop
-          callback.call(*arguments)
-        end
+        call_finishables!
         failables.clear if !failables.empty?
 
       elsif failed? && !failables.empty?
         while callback = failables.pop
           callback.call(*arguments)
         end
-        while callback = finishables.pop
-          callback.call(*arguments)
-        end
+        call_finishables!
         successables.clear if !failables.empty?
       end
+      self
+    end
+
+    def call_startables!
+      return unless startables
+      return if startables.empty?
+
+      while callback = startables.pop
+        callback.call
+      end
+    end
+
+    def call_finishables!
+      return unless finishables
+      return if finishables.empty?
+
+      while callback = finishables.pop
+        callback.call
+      end
     end
 
     # Internal Methods
 
+    def startables
+      @startables ||= []
+    end
+
     def successables
       @successables ||= []
     end

data/lib/operation/version.rb

@@ -1,8 +1,8 @@
 class Operation
   module VERSION #:nodoc:
     MAJOR = 1
-    MINOR = 3
-    TINY  = 2
+    MINOR = 4
+    TINY  = 0
     PRE = nil
 
     STRING = [MAJOR, MINOR, TINY, PRE].compact.join '.'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: operation
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.4.0
 platform: ruby
 authors:
 - halo