local_bus 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc7597ce848ed87503b21e8b893d9637f7f601945d4e6d0904938f2319b691f0
-  data.tar.gz: 6b65f578aac4e885afc4d76265fdf3812b2b3d8d32b2f0ba7d6abdc6f824fcf7
+  metadata.gz: 3abe4359b671f5e051a9e3b4e2cb0ac73ca9c00ef63c1622c158ebf4c116a1b5
+  data.tar.gz: 408ea743c2b5b8d3a000a8db5b8207f6e3d90edfb3976b8bf1aad3ec11dde8ab
 SHA512:
-  metadata.gz: 18c4ca9e676956c6b2571093bec9f57a76714ceb833f7aae021ac6563965d438499c05fcd5214e63b5b9cb8a192ed739d6926b54bc9d97e87a9f33b193289052
-  data.tar.gz: b1b99ef58b04fcfcf45808596be55bc9919f455aeb65a3ef53a56157305bff5aaf1310d418a02c14413f6db735a06dea58440d5f9d3a849073fd6a53f837247d
+  metadata.gz: de71a197041a072f69ad37e971663983da3f77a00889c71afc622d382e74480bf5bef25ebfdc5d97762d4a15f385b0d63bdd929f67c6e455dc378340d3afda93
+  data.tar.gz: fe165204058f9e5f9df6aa00d4f3d07db69478eeca3232a7204be758e0b6418800e903c576c927b04b0a958946e729c385a27341bb1f9168bcb2cb83198396db

data/README.md

@@ -87,7 +87,7 @@ Both interfaces ensure optimal performance:
 Best for real-time operations like logging, metrics, and state updates.
 
 ```ruby
-bus = LocalBus.instance.bus
+bus = LocalBus::Bus.new # ... or LocalBus.instance.bus
 
 bus.subscribe "user.created" do |message|
   AuditLog.record(message.payload)
@@ -101,6 +101,33 @@ result.wait  # blocks until all subscribers complete
 result.value # blocks and waits until all subscribers complete and returns the subscribers
 ```
 
+Subscribe with an explicit `callable`.
+
+```ruby
+callable = ->(message) { "Received message: #{message.payload}" }
+LocalBus.instance.bus.subscribe "user.created", callable: callable
+
+subscribers = LocalBus.instance.bus.publish("user.created", user_id: 123).value
+# => [#<LocalBus::Subscriber:0x0000000126b7cf38 ...>]
+
+subscribers.first.value
+# => "Received message: {:user_id=>123}"
+
+# you can use any object that responds to #call
+class ExampleCallable
+  def call(message)
+    "Received message: #{message.payload}"
+  end
+end
+
+LocalBus.instance.bus.subscribe "user.created", callable: ExampleCallable.new
+subscribers = LocalBus.instance.bus.publish("user.created", user_id: 123).value
+# => [#<LocalBus::Subscriber:0x0000000126b7cf38 ...>]
+
+subscribers.first.value
+# => "Received message: {:user_id=>123}"
+```
+
 ### Station (background processing)
 
 Best for async operations like emails, notifications, and resource-intensive tasks.
@@ -120,6 +147,33 @@ result.wait  # blocks until all subscribers complete
 result.value # blocks and waits until all subscribers complete and returns the subscribers
 ```
 
+Subscribe with an explicit `callable`.
+
+```ruby
+callable = ->(message) { "Received message: #{message.payload}" }
+LocalBus.instance.station.subscribe "email.welcome", callable: callable
+
+subscribers = LocalBus.instance.station.publish("email.welcome", user_id: 123).value
+# => [#<LocalBus::Subscriber:0x0000000126b7cf38 ...>]
+
+subscribers.first.value
+# => "Received message: {:user_id=>123}"
+
+# you can use any object that responds to #call
+class ExampleCallable
+  def call(message)
+    "Received message: #{message.payload}"
+  end
+end
+
+LocalBus.instance.station.subscribe "email.welcome", callable: ExampleCallable.new
+subscribers = LocalBus.instance.station.publish("email.welcome", user_id: 123).value
+# => [#<LocalBus::Subscriber:0x0000000126b7cf38 ...>]
+
+subscribers.first.value
+# => "Received message: {:user_id=>123}"
+```
+
 ## Advanced Usage & Considerations
 
 ### Concurrency Controls

data/lib/local_bus/bus.rb

@@ -73,6 +73,7 @@ class LocalBus
     # @rbs topic: String -- topic name
     # @rbs return: self
     def unsubscribe_all(topic)
+      topic = topic.to_s
       @subscriptions[topic].clear
       @subscriptions.delete topic
       self

data/lib/local_bus/station.rb

@@ -99,6 +99,8 @@ class LocalBus
 
           @pool = nil
         end
+      rescue
+        nil # ignore errors during shutdown
       end
 
       # Clean up shutdown handler
@@ -124,8 +126,7 @@ class LocalBus
     # @rbs &block: (Message) -> untyped -- alternative way to provide a callable
     # @rbs return: self
     def subscribe(topic, callable: nil, &block)
-      callable ||= block
-      bus.subscribe(topic, &callable)
+      bus.subscribe(topic, callable: callable || block)
       self
     end
 
@@ -214,9 +215,9 @@ class LocalBus
     # @rbs on: Array[String] -- signals to trap
     # @rbs return: void
     def enable_safe_shutdown(on:)
+      at_exit { stop }
       on.each do |signal|
         trap signal do
-          # Only queue the signal if we haven't started shutdown
           @shutdown_queue.push signal unless @shutdown.true?
         rescue
           nil

data/lib/local_bus/subscriber.rb

@@ -27,7 +27,10 @@ class LocalBus
       @callable = callable
       @message = message
       @id = callable.object_id
-      @source_location = callable.source_location
+      @source_location = case callable
+      in Proc then callable.source_location
+      else callable.method(:call).source_location
+      end
       @metadata = {}
     end
 

data/lib/local_bus/version.rb

@@ -3,5 +3,5 @@
 # rbs_inline: enabled
 
 class LocalBus
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: local_bus
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Nate Hopkins (hopsoft)
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-04 00:00:00.000000000 Z
+date: 2024-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async