event_engine-subscribers 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77ec2b6b5c9768d1968ead2a2d567e796a91747036be8d6c407137a36997c781
-  data.tar.gz: 4f97fd5b867ca07942c082c3e37a65e4a0bb452c6e7c4d59fd409561ccb9ea23
+  metadata.gz: 9911cefcbfa87b20178f615e68e88cef8f57da763ad42fcdf10a3f7f1b9d7be9
+  data.tar.gz: 1aa83bfbbea17ba4b3d2555f08509545f487e94d38abc52409de1a97bfa52109
 SHA512:
-  metadata.gz: b806c0dbe05a8c57a1d3b1c0cd0fbe7937d015f5822d37c3f5feafd083d922a5f528b871564aaa8259866d8f0bd6ca4b90af63351788b8521f4baadf57346201
-  data.tar.gz: fcc63467dcf27dc0021304dd36821de214c30f9eff44efca1f3f2cd6a9b5a59cbe6f43693547f28e86bc4b0f7dfa949f8d912ee25c914bd1ff35328ba9aed617
+  metadata.gz: 64e5c8652616821523641c4ffa5e17afb165e052847cde405c42f9ba2e852ed90a5c77add76ba3d6315e4fe230b97c280ff6213db5671c18a94e41757d957f82
+  data.tar.gz: 6b420c78274b70abf4cda7d544074e692e400409dac035937204b2270a0a2605b9a3f63198d46b0c9201c49cd3406aab5a6d1f789de28defe4c69aaf4f6fd88c

data/README.md

@@ -104,23 +104,21 @@ The check runs once the app has started, after every class in `app/subscribers`
 registered. A subscriber anywhere else registers only once Rails has loaded its class,
 so keep subscribers in `app/subscribers`.
 
-## Requiring every event to run inline
+## Requiring a pack's events to run inline
 
 A subscriber that refuses a change can only undo it when it runs inline, during the
-emit. A host that depends on that calls the event start check once the subscriber
-processors are registered:
+emit. A host that depends on that names the event packs whose events must run inline:
 
 ```ruby
 # config/application.rb
-config.after_initialize do
-  EventEngine::Subscribers.check_inline!(EventEngine::Subscribers.routes)
-end
+config.event_engine_subscribers.inline_packs = [:console]
 ```
 
-The app then refuses to start when an event has no rule, when a rule names a processor
-nothing registered, or when any event is routed to `background`. The last error names
-every such event. A host that does not call it can route events to `background` as
-before.
+When the app starts, the gem then refuses to start when an event has no rule, when a
+rule names a processor nothing registered, or when an event in a named pack is routed to
+`background`. The last error names every such event. Events in other packs may still
+run in the background. With no packs named, which is the default, the gem runs no inline
+check.
 
 ## A working example app
 

data/lib/event_engine/subscribers/engine.rb

@@ -5,6 +5,9 @@ module EventEngine
     class Engine < ::Rails::Engine
       isolate_namespace EventEngine::Subscribers
 
+      config.event_engine_subscribers = ActiveSupport::OrderedOptions.new
+      config.event_engine_subscribers.inline_packs = []
+
       initializer "event_engine.subscribers.register_processor" do
         config.after_initialize do
           processor = Processor.new
@@ -18,6 +21,13 @@ module EventEngine
         config.after_initialize { Subscribers.check!(Subscribers.routes) }
       end
 
+      initializer "event_engine.subscribers.check_inline_packs", after: "event_engine.subscribers.register_processor" do |app|
+        config.after_initialize do
+          packs = app.config.event_engine_subscribers.inline_packs
+          Subscribers.check_inline!(Subscribers.routes, packs: packs) if packs.any?
+        end
+      end
+
       initializer "event_engine.subscribers.forget_unloaded_subscribers" do |app|
         app.reloader.before_class_unload { Registry.clear! }
       end

data/lib/event_engine/subscribers/version.rb

@@ -1,5 +1,5 @@
 module EventEngine
   module Subscribers
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

data/lib/event_engine/subscribers.rb

@@ -25,12 +25,16 @@ module EventEngine
       true
     end
 
-    def self.check_inline!(routes)
+    def self.check_inline!(routes, packs: nil)
       EventEngine.validate_rules!
       background = routes.reject { |_event_name, process_type| process_type == :inline }.keys
+      background = background.select { |event_name| packs.include?(pack_of(event_name)) } if packs
       raise BackgroundEventsError, background if background.any?
 
       true
     end
+
+    def self.pack_of(event_name) = EventEngine.schema_registry.latest_for(event_name).domain
+    private_class_method :pack_of
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: event_engine-subscribers
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - tylercschneider