emittance 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4e9a6fb1053c8170cf15f5b0591b50ee652a3e65
-  data.tar.gz: 99c427d6c87cddf253750f9e435454bdef626cec
+  metadata.gz: 986843810de58a199f02fdf539d2bfb3dba43e6d
+  data.tar.gz: dbdfc671b5dd1ec85d3722b4ffa7c30e9ec4d0a3
 SHA512:
-  metadata.gz: 54ad3b23a947f7a138c2e6182d91beb618473e0f64b7475c0236fddfdfb39aac6984e0a49534dcb630912b1d226f69c1fd2eeb2b359e41ace6d12162ad52f2c1
-  data.tar.gz: 842994125c20aba135f5d1daec7a7842027e47c58b2129d02cf3fb5a90f852b8a692d2dd3afaa0be338cfc5f1cfcf5e8e9e984cab9ede5009e6ee9b94c8ed9db
+  metadata.gz: a4369875f79828cb66bf11da0f57780f1dddacc55680ec50ffb3ee1980ad9f8b592600d313e7cd221c18733a4de34e107497d084d469313c794ade69105b3f10
+  data.tar.gz: 8837f6c33c9f7c812c2ef64355af6f3d21e8b14b03522e37c9e934f5f5ab7b22a137a8eed77b6163aeb1715e2c66af49da96217ecfbb2447534347cf17d1f464

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    emittance (0.0.3)
+    emittance (0.0.4)
 
 GEM
   remote: https://rubygems.org/

data/lib/emittance/broker.rb

@@ -5,12 +5,18 @@ module Emittance
   # Base class for event brokers.
   #
   class Broker
+    DISPATCHER_KLASS_NAME = 'Dispatcher'
+
     class << self
       # @param _event [Emittance::Event] the event to be passed off to watchers
       def process_event(_event)
         raise NotImplementedError
       end
 
+      def dispatcher
+        const_get DISPATCHER_KLASS_NAME
+      end
+
       def inherited(subklass)
         register_broker subklass
         super

data/lib/emittance/brokerage.rb

@@ -7,15 +7,23 @@ module Emittance
   #
   class Brokerage
     @enabled = true
+    @current_broker = nil
 
     class << self
       # @param event [Emittance::Event] the event object
       # @param broker_id [Symbol] a symbol that can be used to identify a broker by
-      def send_event(event, broker_id)
-        broker = registry.fetch(broker_id)
+      def send_event(event)
         broker.process_event event
       end
 
+      def broker
+        @current_broker
+      end
+
+      def use_broker(identifier)
+        @current_broker = registry.fetch identifier
+      end
+
       # @param broker [Emittance::Broker] the broker you would like to register
       def register_broker(broker)
         registry.register broker

data/lib/emittance/brokers/synchronous.rb

@@ -8,8 +8,10 @@ module Emittance
     class << self
       # (@see Emittance::Broker.process_event)
       def process_event(event)
-        Emittance::Dispatcher.process_event event
+        dispatcher.process_event event
       end
     end
   end
 end
+
+require 'emittance/dispatchers/synchronous'

data/lib/emittance/dispatchers/synchronous.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Emittance
+  class Synchronous
+    ##
+    # The synchronous dispatcher. Runs callbacks one-by-one, in series.
+    #
+    class Dispatcher
+      @registrations = {}
+      @enabled = true
+
+      class << self
+        def process_event(event)
+          registrations_for(event).each do |registration|
+            registration.call event
+          end
+        end
+
+        def registrations_for(identifier)
+          event_klass = find_event_klass identifier
+          registrations[event_klass] ||= empty_registration
+          registrations[event_klass]
+        end
+
+        def register(identifier, &callback)
+          event_klass = find_event_klass identifier
+          registrations[event_klass] ||= empty_registration
+          registrations_for(event_klass) << Emittance::Registration.new(event_klass, &callback)
+
+          callback
+        end
+
+        def register_method_call(identifier, object, method_name)
+          register identifier, &lambda_for_method_call(object, method_name)
+        end
+
+        def clear_registrations!
+          registrations.each_key do |event_klass|
+            clear_registrations_for! event_klass
+          end
+        end
+
+        def clear_registrations_for!(identifier)
+          event_klass = find_event_klass identifier
+          registrations[event_klass].clear
+        end
+
+        private
+
+        attr_accessor :registrations
+
+        def empty_registration
+          Set.new
+        end
+
+        def find_event_klass(event)
+          Emittance::EventLookup.find_event_klass(event)
+        end
+
+        def lambda_for_method_call(object, method_name)
+          ->(event) { object.send method_name, event }
+        end
+      end
+    end
+  end
+end

data/lib/emittance/emitter.rb

@@ -62,11 +62,11 @@ module Emittance
       #   if not using the default.
       #
       # @return the payload
-      def emit(identifier, payload: nil, broker: :synchronous)
+      def emit(identifier, payload: nil)
         now = Time.now
         event_klass = _event_klass_for identifier
         event = event_klass.new(self, now, payload)
-        _send_to_broker event, broker
+        _send_to_broker event
 
         payload
       end
@@ -77,11 +77,11 @@ module Emittance
       # @param identifiers [*] anything that can be used to generate an +Event+ class.
       # @param payload (@see #emit)
       # @param broker (@see #emit)
-      def emit_with_dynamic_identifier(*identifiers, payload:, broker: :synchronous)
+      def emit_with_dynamic_identifier(*identifiers, payload:)
         now = Time.now
         event_klass = _event_klass_for(*identifiers)
         event = event_klass.new(self, now, payload)
-        _send_to_broker event, broker
+        _send_to_broker event
 
         payload
       end
@@ -131,8 +131,8 @@ module Emittance
         Emittance::Event.event_klass_for(*identifiers)
       end
 
-      def _send_to_broker(event, broker)
-        Emittance::Brokerage.send_event event, broker
+      def _send_to_broker(event)
+        Emittance::Brokerage.send_event event
       end
     end
   end

data/lib/emittance/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Emittance
-  VERSION = '0.0.3'
+  VERSION = '0.0.4'
 end

data/lib/emittance/watcher.rb

@@ -16,10 +16,16 @@ module Emittance
     # @return [Proc] the block that will run when the event fires
     def watch(identifier, callback_method = nil, &callback)
       if callback_method
-        Emittance::Dispatcher.register_method_call identifier, self, callback_method
+        _dispatcher.register_method_call identifier, self, callback_method
       else
-        Emittance::Dispatcher.register identifier, &callback
+        _dispatcher.register identifier, &callback
       end
     end
+
+    private
+
+    def _dispatcher
+      Emittance.dispatcher
+    end
   end
 end

data/lib/emittance.rb

@@ -13,29 +13,43 @@ require 'emittance/event'
 require 'emittance/emitter'
 require 'emittance/watcher'
 require 'emittance/action'
-require 'emittance/dispatcher'
 
 ##
 # The base namespace for this library. You can do some basic configuration stuff by calling methods on its singleton.
 #
 module Emittance
   class << self
-    # Enable eventing process-wide.
+    # Enable eventing process-wide
     def enable!
       Emittance::Brokerage.enable!
     end
 
-    # Disable eventing process-wide.
+    # Disable eventing process-wide
     def disable!
       Emittance::Brokerage.disable!
     end
 
-    # @return [Boolean] true if eventing is enabled, false otherwise.
+    # @return [Boolean] true if eventing is enabled, false otherwise
     def enabled?
       Emittance::Brokerage.enabled?
     end
 
-    # Not yet implemented!
+    # @return [Class] the currently enabled broker class
+    def broker
+      Emittance::Brokerage.broker
+    end
+
+    # @return [Class] the dispatcher attached to the currently enabled broker
+    def dispatcher
+      broker.dispatcher
+    end
+
+    # @param [identifier] the identifier that can be used to identify the broker you wish to use
+    def use_broker(identifier)
+      Emittance::Brokerage.use_broker identifier
+    end
+
+    # Not yet implemented! Remove nocov and private flags when finished.
     # :nocov:
     # @private
     def suppress(&_blk)
@@ -45,3 +59,5 @@ module Emittance
     # :nocov:
   end
 end
+
+Emittance.use_broker :synchronous

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: emittance
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Tyler Guillen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-12-13 00:00:00.000000000 Z
+date: 2017-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -120,7 +120,7 @@ files:
 - lib/emittance/broker.rb
 - lib/emittance/brokerage.rb
 - lib/emittance/brokers/synchronous.rb
-- lib/emittance/dispatcher.rb
+- lib/emittance/dispatchers/synchronous.rb
 - lib/emittance/emitter.rb
 - lib/emittance/errors.rb
 - lib/emittance/event.rb

data/lib/emittance/dispatcher.rb

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-require 'set'
-
-module Emittance
-  # @private
-  class Dispatcher
-    @registrations = {}
-    @enabled = true
-
-    class << self
-      def process_event(event)
-        registrations_for(event).each do |registration|
-          registration.call event
-        end
-      end
-
-      def registrations_for(identifier)
-        event_klass = find_event_klass identifier
-        registrations[event_klass] ||= empty_registration
-        registrations[event_klass]
-      end
-
-      def register(identifier, &callback)
-        event_klass = find_event_klass identifier
-        registrations[event_klass] ||= empty_registration
-        registrations_for(event_klass) << Emittance::Registration.new(event_klass, &callback)
-
-        callback
-      end
-
-      def register_method_call(identifier, object, method_name)
-        register identifier, &lambda_for_method_call(object, method_name)
-      end
-
-      def clear_registrations!
-        registrations.each_key do |event_klass|
-          clear_registrations_for! event_klass
-        end
-      end
-
-      def clear_registrations_for!(identifier)
-        event_klass = find_event_klass identifier
-        registrations[event_klass].clear
-      end
-
-      private
-
-      attr_accessor :registrations
-
-      def empty_registration
-        Set.new
-      end
-
-      def find_event_klass(event)
-        Emittance::EventLookup.find_event_klass(event)
-      end
-
-      def lambda_for_method_call(object, method_name)
-        ->(event) { object.send method_name, event }
-      end
-    end
-  end
-end