local_bus 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc7597ce848ed87503b21e8b893d9637f7f601945d4e6d0904938f2319b691f0
-  data.tar.gz: 6b65f578aac4e885afc4d76265fdf3812b2b3d8d32b2f0ba7d6abdc6f824fcf7
+  metadata.gz: fa03fc7b7c1f5e14bff852435b75e343f150ceee9b5f9638ce365918bc39c939
+  data.tar.gz: 1aa8d5ffa9895245ff78f1b00c2d4f3697a1183afe82dc4bcd3d7c420453e924
 SHA512:
-  metadata.gz: 18c4ca9e676956c6b2571093bec9f57a76714ceb833f7aae021ac6563965d438499c05fcd5214e63b5b9cb8a192ed739d6926b54bc9d97e87a9f33b193289052
-  data.tar.gz: b1b99ef58b04fcfcf45808596be55bc9919f455aeb65a3ef53a56157305bff5aaf1310d418a02c14413f6db735a06dea58440d5f9d3a849073fd6a53f837247d
+  metadata.gz: 6e17c54a44652eac0c7edb7715a1db68507a0b82b4c3acdd9bfbc4e41d5741b5b80965d623be8e369c4080e43a0cb8696431d6464588655ecc863c47d8bf81e6
+  data.tar.gz: 57fbbe8719669a3dbee59252c2d71ce20c1ce232110779ffa9bf8fa4c68e7da1b59cb9fb916d308c7e8d21e499117eb74b4a5e464db2c0eab2866e53855d9c12

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

@@ -124,8 +124,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
 

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.1"
 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.1
 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