observers 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a683d87de52e3b964c325db4cc4cb732203c594eac263aadaf513a59a0dab76
-  data.tar.gz: 50b6e45f3357de2e06b5d599c7c2614804af8db850522717f34f6524064c4f53
+  metadata.gz: eb285238975fddf6f112154a0c2dba9ce47569011afd28b613c6a9ecce4f6611
+  data.tar.gz: cd5998f3e1632de38775a2f840ac4215c2bb872bf9436213d99b0b73574a3dd1
 SHA512:
-  metadata.gz: a5e2e9afdb9f313a8bcaddbd8c0b309e01aa52d495458e3cb63efc3182b1c7876b87ccd227bb0fa55fb0866d31514b22fe715a58d276e610e14165d51010188e
-  data.tar.gz: ab2d9cc3aa952df58c7a7b5bfe9fa2f4f1c6eb1aa74469c8e82145324f0f45c5759126770a30d7a1252a20cccbb5dcef6d8e586eeb9d47fc48ed71c01ef9d3e8
+  metadata.gz: 76195d403e724f44bec4bb2b77922efaa608be434ea5462084dd0e88b1d917535f622c66935392bc53cea35b1d05114f024e4ef5498babca6eedca68c1d92517
+  data.tar.gz: 5bf9e779194597ea33148459bc92cbef3406070feadfe3d81b94ea95077eca9f697da3b1e7cd8e1f7e648306dc0b28934f68b95fea54031dadaf33092ecfdabc

data/lib/models/observable.rb

@@ -13,7 +13,7 @@ module Observers
       @observers << Observer.new(object:, action:)
     end
 
-    # @returns: The result of the last trigger with a non-nil value.
+    # @returns: The result of the last observer with a non-nil value.
     def trigger(action:, event:)
       action = event.action if event && action.nil?
       action = :handle if action.nil?
@@ -27,5 +27,18 @@ module Observers
 
       last_result
     end
+
+    # @returns: The result of the first observer with a non-nil value.
+    def take(action:, event:)
+      action = event.action if event && action.nil?
+      action = :handle if action.nil?
+
+      @observers.each do |observer|
+        result = observer.trigger(action:, event:)
+        return result unless result.nil?
+      end
+
+      nil # This is a bad day for the take method, one of the worst.
+    end
   end
 end

data/lib/observers.rb

@@ -24,11 +24,14 @@ module Observers
     Observables[key].observe(object: self, action:)
   end
 
-  # Returns the last observer's non-nil return value.
   def trigger(key = self, action: nil, event: nil)
     Observables.fetch(key).trigger(action:, event:)
   end
 
+  def take(key = self, action: nil, event: nil)
+    Observables.fetch(key).take(action:, event:)
+  end
+
   # TODO: Provide a "pipe/port/take" method that uses ractors to be concurrent... if supplied with immutable Data?
 end
 

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Observers
-  VERSION = '0.4.0'
+  VERSION = '0.5.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: observers
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - maedi