postburner 1.0.0.pre.24 → 1.0.0.rc.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f585bd5690984dacccdd8999899c3d9ca170baf9214e098f31c7da573564350b
-  data.tar.gz: 8342287cb88d5d9fdc8d549a1ccdc1b1be5860c26fe428d13b343d183757d7ba
+  metadata.gz: dd9830a1ebdf2cded8cba28a7750c1610c75cba7c3954b8846c92eb7455fac64
+  data.tar.gz: 50c0d435d1f673bac9f5226c31672d78b7ef9c85453a276b72633f215f27d736
 SHA512:
-  metadata.gz: eb624fc558e9f80c6d1a8f903470654ad2b084f320532a97178f203c66fdc93c41f4d718df67c06f63d20ceaa9149cd330cd89efd69de289d6ca156999da6c8e
-  data.tar.gz: 3ee2ca1ed836af20a49a5a9045e9508b63ef38f5092348fa2e0258666f33b8bb3964f75af4c736a608a2c388affb2f5b112922fad38963f685733333da976743
+  metadata.gz: 0a6522ef8f294e80abd08c401357cf1c0cff967d94cf7d09d84377cdf923c7734712329ef3039e8c51828e8936bea5bf8862cdbfe409b27700138f957c158282
+  data.tar.gz: 93806d46b3e1e0ef21ee01627d09ec97b7c092b65877b8d75756b227cb7c99771f4fcafe509997e40867557fa8ad0beb54f136e28c1f68d1da0aceef5328343a

data/lib/postburner/active_job/execution.rb

@@ -5,15 +5,14 @@ module Postburner
     # Handles execution of ActiveJob jobs from Beanstalkd payloads.
     #
     # Supports both default jobs (fast, no PostgreSQL) and tracked jobs
-    # (full audit trail). Also handles legacy Postburner::Job format
-    # for backward compatibility.
+    # (full audit trail). Also handles native Postburner::Job format.
     #
     class Execution
       class << self
         # Executes a job from a Beanstalkd payload.
         #
-        # Automatically detects payload type (default, tracked, or legacy)
-        # and routes to the appropriate execution path.
+        # Automatically detects payload type (default, tracked, or native
+        # Postburner::Job) and routes to the appropriate execution path.
         #
         # @param payload_json [String] JSON payload from Beanstalkd
         #
@@ -24,8 +23,8 @@ module Postburner
         def execute(payload_json, beanstalk_job: nil)
           payload = Payload.parse(payload_json)
 
-          if Payload.legacy_format?(payload)
-            execute_legacy(payload, beanstalk_job: beanstalk_job)
+          if Payload.native_format?(payload)
+            execute_native(payload, beanstalk_job: beanstalk_job)
           elsif Payload.tracked?(payload)
             execute_tracked(payload, beanstalk_job: beanstalk_job)
           else
@@ -88,15 +87,15 @@ module Postburner
           job.perform_now
         end
 
-        # Executes a legacy Postburner::Job (backward compatibility).
+        # Executes a native Postburner::Job.
         #
-        # Legacy format: { "class" => "JobClassName", "args" => [job_id] }
+        # Native format: { "class" => "JobClassName", "args" => [job_id] }
         #
-        # @param payload [Hash] Parsed legacy payload
+        # @param payload [Hash] Parsed native payload
         #
         # @return [void]
         #
-        def execute_legacy(payload, beanstalk_job: nil)
+        def execute_native(payload, beanstalk_job: nil)
           job_class = payload['class'].constantize
           job_id = payload['args'].first
 

data/lib/postburner/active_job/payload.rb

@@ -145,17 +145,20 @@ module Postburner
           payload['tracked'] == true || payload[:tracked] == true
         end
 
-        # Detects if a parsed payload is for a legacy Postburner::Job.
+        # Detects if a parsed payload is a native Postburner::Job format
+        # (as opposed to an ActiveJob adapter payload).
         #
-        # Legacy format: { "class" => "JobClassName", "args" => [job_id] }
+        # Native format: { "class" => "JobClassName", "args" => [job_id] }
         #
         # @param payload [Hash] Parsed payload
         #
-        # @return [Boolean] true if legacy format
+        # @return [Boolean] true if native Postburner::Job format
         #
-        def legacy_format?(payload)
+        def native_format?(payload)
           payload.key?('class') && payload.key?('args') && !payload.key?('v')
         end
+
+        alias_method :legacy_format?, :native_format?
       end
     end
   end

data/lib/postburner/instrumentation.rb

@@ -87,15 +87,15 @@ module Postburner
 
     # Build job payload from a parsed Beanstalkd payload hash.
     #
-    # Handles both ActiveJob format and legacy Postburner::Job format.
+    # Handles both ActiveJob format and native Postburner::Job format.
     #
     # @param payload [Hash] Parsed JSON payload from Beanstalkd
     # @param beanstalk_job_id [Integer, nil] Beanstalkd job ID
     # @return [Hash] Standardized job payload
     #
     def job_payload_from_hash(payload, beanstalk_job_id: nil)
-      if Postburner::ActiveJob::Payload.legacy_format?(payload)
-        # Legacy format: { "class" => "JobClass", "args" => [id] }
+      if Postburner::ActiveJob::Payload.native_format?(payload)
+        # Native Postburner::Job format: { "class" => "JobClass", "args" => [id] }
         {
           class: payload['class'],
           id: payload['args']&.first,

data/lib/postburner/version.rb

@@ -1,3 +1,3 @@
 module Postburner
-  VERSION = '1.0.0.pre.24'
+  VERSION = '1.0.0.rc.1'
 end

data/lib/postburner/worker.rb

@@ -260,7 +260,15 @@ module Postburner
       logger.info "[Postburner::Worker] Mode: Single process (forks: 0)"
 
       @gc_count = Concurrent::AtomicFixnum.new(0)
-      @gc_limit = worker_config[:gc_limit]
+      # gc_limit is disabled in single process mode — there is no parent process
+      # to restart the child, so exiting would rely on an external supervisor
+      # (Docker, systemd) to restart the entire process. Use forks: 1+ to enable
+      # gc_limit with automatic in-process restarts.
+      @gc_limit = nil
+      if worker_config[:gc_limit]
+        logger.debug "[Postburner::Worker] gc_limit disabled in single process mode" \
+                     " (use forks: 1+ to enable)"
+      end
 
       thread_count = worker_config[:threads]
       @pool = Concurrent::FixedThreadPool.new(thread_count)
@@ -645,8 +653,8 @@ module Postburner
     # @return [String] Human-readable job description
     # @api private
     def format_job_description(payload)
-      if Postburner::ActiveJob::Payload.legacy_format?(payload)
-        # Legacy Postburner::Job format: { "class" => "HeartbeatJob", "args" => [123] }
+      if Postburner::ActiveJob::Payload.native_format?(payload)
+        # Native Postburner::Job format: { "class" => "HeartbeatJob", "args" => [123] }
         job_class = payload['class'] || 'UnknownJob'
         job_id = payload['args']&.first
         job_id ? "#{job_class}##{job_id}" : job_class
@@ -679,7 +687,7 @@ module Postburner
       begin
         payload = JSON.parse(beanstalk_job.body)
 
-        if payload['tracked'] || Postburner::ActiveJob::Payload.legacy_format?(payload)
+        if payload['tracked'] || Postburner::ActiveJob::Payload.native_format?(payload)
           handle_postburner_job_error(beanstalk_job, payload, error)
         else
           handle_default_job_error(beanstalk_job, payload, error)
@@ -705,7 +713,7 @@ module Postburner
     # @return [void]
     # @api private
     def handle_postburner_job_error(beanstalk_job, payload, error)
-      job_id = if Postburner::ActiveJob::Payload.legacy_format?(payload)
+      job_id = if Postburner::ActiveJob::Payload.native_format?(payload)
                  payload['args']&.first
                else
                  payload['postburner_job_id']

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: postburner
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.24
+  version: 1.0.0.rc.1
 platform: ruby
 authors:
 - Matt Smith