event_engine-subscribers 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9911cefcbfa87b20178f615e68e88cef8f57da763ad42fcdf10a3f7f1b9d7be9
-  data.tar.gz: 1aa83bfbbea17ba4b3d2555f08509545f487e94d38abc52409de1a97bfa52109
+  metadata.gz: eae67c45dcc6b8946ca569bbf90a1e9811b5c974a98ebdf27b1030aac9dfe948
+  data.tar.gz: 6fd89515d0fd50f6324a37f605343a2f63e347ce20400e6e166536c922125405
 SHA512:
-  metadata.gz: 64e5c8652616821523641c4ffa5e17afb165e052847cde405c42f9ba2e852ed90a5c77add76ba3d6315e4fe230b97c280ff6213db5671c18a94e41757d957f82
-  data.tar.gz: 6b420c78274b70abf4cda7d544074e692e400409dac035937204b2270a0a2605b9a3f63198d46b0c9201c49cd3406aab5a6d1f789de28defe4c69aaf4f6fd88c
+  metadata.gz: 4f0ac3aa8052389ef2b57646d586e07492346e9f1eb3a9abf4dcd5275687e4bebd11b4e023a5df14469971c32e6c74b32ddcde1ff494ff64331171efe3b294a8
+  data.tar.gz: 5567b5513c5524d4ab3c93a3db192def68a24ad5260805b8c2c3b861009f0c46d0cbffd257e6e6c7ee4fe4bdf84db318a2841c98db48f311bbce0e12df4749d9

data/README.md

@@ -100,9 +100,26 @@ EventEngine::Subscribers::UnsubscribedEventsError: These events are routed to
   subscribers but have none: hay_baled
 ```
 
-The check runs once the app has started, after every class in `app/subscribers` is
-registered. A subscriber anywhere else registers only once Rails has loaded its class,
-so keep subscribers in `app/subscribers`.
+The check runs once the app has started, after every class in `app/subscribers` and in
+the folders named in `subscriber_folders` is registered. A subscriber anywhere else
+registers only once Rails has loaded its class, so keep subscribers in `app/subscribers`
+or in a folder you name there.
+
+## Keeping subscribers in other folders
+
+A host that keeps subscribers outside `app/subscribers` names those folders, relative to
+the app's root:
+
+```ruby
+# config/application.rb
+config.event_engine_subscribers.subscriber_folders = ["hubs/*/app/subscribers"]
+```
+
+Each entry is a folder or a pattern that matches several folders. The gem adds every
+folder it matches to the app's eager load paths, then loads and registers its subscribers
+when the app starts and again after each code reload, the same as `app/subscribers`. A
+folder or pattern that matches nothing is skipped. It names no folders by default, so
+only `app/subscribers` is loaded.
 
 ## Requiring a pack's events to run inline
 

data/lib/event_engine/subscribers/engine.rb

@@ -7,6 +7,12 @@ module EventEngine
 
       config.event_engine_subscribers = ActiveSupport::OrderedOptions.new
       config.event_engine_subscribers.inline_packs = []
+      config.event_engine_subscribers.subscriber_folders = []
+
+      initializer "event_engine.subscribers.autoload_subscriber_folders", before: :set_autoload_paths do |app|
+        folders = Subscribers.folders_matching(app.root, app.config.event_engine_subscribers.subscriber_folders)
+        app.config.eager_load_paths += folders.map(&:to_s)
+      end
 
       initializer "event_engine.subscribers.register_processor" do
         config.after_initialize do
@@ -36,6 +42,9 @@ module EventEngine
         config.to_prepare do
           subscribers = app.root.join("app/subscribers")
           Rails.autoloaders.main.eager_load_dir(subscribers) if subscribers.directory?
+          Subscribers.folders_matching(app.root, app.config.event_engine_subscribers.subscriber_folders).each do |folder|
+            Rails.autoloaders.main.eager_load_dir(folder)
+          end
         end
       end
     end

data/lib/event_engine/subscribers/version.rb

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

data/lib/event_engine/subscribers.rb

@@ -34,6 +34,10 @@ module EventEngine
       true
     end
 
+    def self.folders_matching(root, patterns)
+      patterns.flat_map { |pattern| Dir[root.join(pattern).to_s] }.map { |folder| Pathname.new(folder) }.select(&:directory?)
+    end
+
     def self.pack_of(event_name) = EventEngine.schema_registry.latest_for(event_name).domain
     private_class_method :pack_of
   end

metadata

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