observers 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6d833421a632a5d73e0b3bcd73d227881b67cfa5384bb386632b04607e3745d
-  data.tar.gz: 458dbadf1111fa9cdbeef5d65cce5bcd8b6da3ea355c4178ced79e0c48824f50
+  metadata.gz: e2d0c58f136cc23164aa0cf64ded4ff642c86d8f82842fedaf459a0205024b17
+  data.tar.gz: 4ab7392ec00ad1fcb13ad891051c807c40c496037bcd6e730c9692f9c6acfdbb
 SHA512:
-  metadata.gz: 5e1b8ad7ac1007633742d060524135d9013972dd973676a6f89a4c831668f9a590f0106397c315e727758b6e8e30ce344529750fd33d84f3305f7bbb4c805556
-  data.tar.gz: ec92959757150e34c161acd7152bdd4e82501a4dc3f0e4b0ffd79cd321fc196c81ce3d148040bff9121ec651ed351d215f636ac2e3042768032dfe225fa9c241
+  metadata.gz: fb4a46da4a46c8036f5f8acdebff74817138eb3566db27e929054d4b6d4670715324cb31cead6371bcd45b6f1ea11b927aadb8508dc5707bd417a8c6d7631e2b
+  data.tar.gz: e30650c3284a90f0a94c6fbf80ab0aa549e8676b2f93531d4d99da16944f4e0fa70922a220c224b41ccf8e839dfa01b2162a08c936a56c12350e1b6445a9c232

data/lib/keys.rb

@@ -4,26 +4,14 @@ require_relative 'models/key'
 
 module Observers
   class Keys
-    class MissingKeyError < StandardError; end
-
     class << self
-      def keys
-        @keys ||= {}
-        @keys
-      end
-
-      def fetch(key)
-        # TODO: Log instead per configuration, much better to fail silently sometimes!
-        keys[key] || raise(MissingKeyError, "Key key '#{key}' not found")
-      end
-
       def [](key)
-        keys[key] || upsert(key:)
+        keys[key] ||= Key.new(key:)
       end
 
-      def upsert(key:)
-        keys[key] = Key.new if keys[key].nil?
-        keys[key]
+      def keys
+        @keys ||= {}
+        @keys
       end
 
       def reset

data/lib/models/key.rb

@@ -4,7 +4,8 @@ module Observers
   class Key
     attr_reader :observers
 
-    def initialize
+    def initialize(key:)
+      @key = key
       @observers = []
     end
 
@@ -15,7 +16,9 @@ module Observers
     end
 
     # @returns: The result of the last observer with a non-nil value.
-    def trigger(action: nil, event:)
+    def trigger(action: nil, event: nil)
+      key_callback
+
       action = event.action if event && action.nil?
       action = :handle if action.nil?
 
@@ -31,7 +34,9 @@ module Observers
     end
 
     # @returns: The result of the first observer with a non-nil value.
-    def take(action: nil, event:)
+    def take(action: nil, event: nil)
+      key_callback
+
       action = event.action if event && action.nil?
       action = :handle if action.nil?
 
@@ -43,5 +48,11 @@ module Observers
 
       nil # This is a bad day for the take method, one of the worst.
     end
+
+    private
+
+    def key_callback
+      Observers.config.key_callback.call(@key) if Observers.config.key_callback && @observers.empty?
+    end
   end
 end

data/lib/observers.rb

@@ -4,13 +4,26 @@ require_relative 'keys'
 require_relative 'models/observer'
 
 module Observers
+  Config = Struct.new(:key_callback)
+
   class << self
+    def [](key)
+      Keys[key].observers
+    end
+
     def included(klass)
       klass.extend Observers
     end
+
+    def config
+      @config ||= Config.new(key_callback: nil)
+    end
+
+    def configure
+      yield(config)
+    end
   end
 
-  # Add an observer on the key side.
   def observers(key = self)
     Struct.new(:key) do
       def push(object, action: nil)
@@ -24,21 +37,17 @@ module Observers
     end.new(key)
   end
 
-  # Add an observer on the observer side.
   def observe(key, action: nil)
     Keys[key].observe(object: self, action:)
   end
 
   def trigger(key: self, action: nil, event: nil)
-    Keys.fetch(key).trigger(action:, event:)
+    Keys[key].trigger(action:, event:)
   end
 
   def take(key: self, action: nil, event: nil)
-    Keys.fetch(key).take(action:, event:)
+    Keys[key].take(action:, event:)
   end
 
   # TODO: Provide a "pipe/port/take" method that uses ractors to be concurrent... if supplied with immutable Data?
 end
-
-# For quick debugging, not official API.
-OKK = Observers::Keys.keys unless defined?(OKK)

data/lib/version.rb

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

metadata

@@ -1,28 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: observers
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - maedi
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: low_dependency
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+dependencies: []
 description: Observe events for objects of any kind
 email:
 - maediprichard@gmail.com