pgbus 0.19.2 → 0.19.4

data/lib/pgbus.rb

@@ -90,6 +90,13 @@ module Pgbus
     # Readers need no lock: a reference is published whole.
     attr_reader :loader, :models_loader, :configuration
 
+    # The settings a non-main Ractor reads (Configuration::Snapshot): a
+    # Ractor-shareable copy of the configuration as the last Pgbus.finalize!
+    # or Pgbus.configure left it, readable from any Ractor. The defaults until
+    # the first finalize, and again after reset!. A setter alone does not
+    # publish: the main Ractor reads the configuration itself.
+    attr_reader :configuration_snapshot
+
     # Process-global flag set by Worker#graceful_shutdown so the adapter
     # can report stopping? to ActiveJob::Continuation (Rails 8.1+).
     def stopping
@@ -210,20 +217,21 @@ module Pgbus
       # configure once a Rails app has booted. While a Rails app boots, the
       # engine's after_initialize finalizes instead, after every initializer
       # and after_initialize block has had its say.
-      configuration.finalize! if configuration.finalized? || !rails_booting?
+      finalize_configuration! if configuration.finalized? || !rails_booting?
       configuration
     end
 
     # The end of boot: validates the configuration (unless eager_validation
-    # is off) and freezes its plain-data settings into Ractor-shareable values
-    # (Configuration#finalize!). Callables and the logger stay as they are, on
-    # the main Ractor. Runs on its own: from the engine's after_initialize in a
+    # is off), freezes its plain-data settings into Ractor-shareable values
+    # (Configuration#finalize!) and publishes configuration_snapshot for
+    # non-main Ractors. Callables and the logger stay as they are, on the main
+    # Ractor. Runs on its own: from the engine's after_initialize in a
     # Rails app, at the end of each Pgbus.configure without Rails, and in
     # `pgbus start` after its flags. Call it yourself only when you configure
     # pgbus through setters alone, without Rails.
     def finalize!
       configuration.validate! if configuration.eager_validation
-      configuration.finalize!
+      finalize_configuration!
     end
 
     # Built on first use, under @state_lock: two threads making the first
@@ -333,6 +341,7 @@ module Pgbus
         @client&.close
         @client = nil
         @configuration = Configuration.new
+        @configuration_snapshot = Configuration::Snapshot.of(@configuration)
         @stream_cache = Concurrent::Map.new
       end
     end
@@ -364,11 +373,26 @@ module Pgbus
     # Process-local, like the client it holds; replaced (never mutated in
     # place) by reset!/reset_client!.
     attr_reader :stream_cache
+
+    # Freezes the configuration's plain-data settings and publishes the
+    # snapshot non-main Ractors read, unless a reset! replaced the
+    # configuration meanwhile (its own snapshot stands) or the snapshot could
+    # not be taken (the last one stands).
+    def finalize_configuration!
+      config = configuration
+      config.finalize!
+      snapshot = Configuration::Snapshot.of(config)
+      @state_lock.synchronize do
+        @configuration_snapshot = snapshot if snapshot && @configuration.equal?(config)
+      end
+      config
+    end
   end
 
   # Module state, built here at load rather than by `||=` on first use, so no
   # two threads can each build their own (issue #527). @state_lock guards every
-  # later write: the client memo, reset!/reset_client!, the stopping flag.
+  # later write: the client memo, reset!/reset_client!, the stopping flag, the
+  # configuration snapshot.
   @state_lock = Mutex.new
   @stopping = false
   @client = nil
@@ -378,6 +402,7 @@ module Pgbus
 
   # After loader.setup: Configuration is Zeitwerk-managed.
   @configuration = Configuration.new
+  @configuration_snapshot = Configuration::Snapshot.of(@configuration)
 
   # In non-Rails contexts, set up model autoloading via a separate loader.
   # This is torn down by the Engine initializer when Rails boots.

data/sig/pgbus/configuration/snapshot.rbs

@@ -0,0 +1,12 @@
+module Pgbus
+  class Configuration
+    # The settings a non-main Ractor reads, as one shareable value
+    # (Pgbus.configuration_snapshot).
+    class Snapshot < Data
+      attr_reader queue_prefix: String
+      def self.new: (queue_prefix: String) -> instance
+                  | (String queue_prefix) -> instance
+      def self.of: (Configuration configuration) -> Snapshot?
+    end
+  end
+end

data/sig/pgbus.rbs

@@ -57,6 +57,7 @@ module Pgbus
   end
 
   def self.configuration: () -> Configuration
+  def self.configuration_snapshot: () -> Configuration::Snapshot
   def self.configure: () { (Configuration) -> void } -> Configuration
   def self.finalize!: () -> Configuration
   def self.client: () -> Client

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgbus
 version: !ruby/object:Gem::Version
-  version: 0.19.2
+  version: 0.19.4
 platform: ruby
 authors:
 - Mikael Henriksson
@@ -329,6 +329,7 @@ files:
 - lib/pgbus/configuration/capsule_dsl.rb
 - lib/pgbus/configuration/deploy_settings.rb
 - lib/pgbus/configuration/presence_settings.rb
+- lib/pgbus/configuration/snapshot.rb
 - lib/pgbus/configuration/stream_authorization.rb
 - lib/pgbus/current_attributes.rb
 - lib/pgbus/database_tasks_guard.rb
@@ -363,7 +364,10 @@ files:
 - lib/pgbus/integrations/appsignal/dashboards/pgbus_health.json
 - lib/pgbus/integrations/appsignal/dashboards/pgbus_streams.json
 - lib/pgbus/integrations/appsignal/dashboards/pgbus_throughput.json
+- lib/pgbus/integrations/appsignal/event_span.rb
+- lib/pgbus/integrations/appsignal/job_span.rb
 - lib/pgbus/integrations/appsignal/probe.rb
+- lib/pgbus/integrations/appsignal/span_subscriber.rb
 - lib/pgbus/integrations/appsignal/subscriber.rb
 - lib/pgbus/log_formatter.rb
 - lib/pgbus/mcp.rb
@@ -515,6 +519,7 @@ files:
 - sig/pgbus/active_job/adapter.rbs
 - sig/pgbus/client.rbs
 - sig/pgbus/configuration.rbs
+- sig/pgbus/configuration/snapshot.rbs
 - sig/pgbus/streams.rbs
 - sig/pgbus/streams/stream.rbs
 homepage: https://github.com/zoolutions/pgbus