postburner 1.0.0.pre.20 → 1.0.0.pre.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8b142c8e0e5a1f5ed9235d5514f262b2ca899900a359d4a0372a7dc484031cc
-  data.tar.gz: dcaa400529791fef277deba18df58fb1bbf92f306d3b08c1b0ccc8f48f86e927
+  metadata.gz: 0cea7097e8d2f498dcf2c63fefa199fa1926399e93d773acb3b6527f4309d7a0
+  data.tar.gz: 98133fa630e92291a5c36c327693b7f1b0b1602e2d1ca1a62977f85b5e654ae3
 SHA512:
-  metadata.gz: 3668f883407fb9671ab430c99a0d1dadda83e89c24bfa6ed336dd9e180ae3c4d32178f985c9d95ee244c380dc74d131990383e294af4ce5d5794a5fa180a5453
-  data.tar.gz: 676d4fd685ddf5cdd7be6ab1693231eb1bf4311d7707dcd85fc968b756eeda0b448bc6c4e6899c7032c17f684d2f4678503113cf50a52173851864ecd0e187d8
+  metadata.gz: e170a612372e0687405a1e4bb61a5b71e159c256fe258b889a76d9b0d8b35adaef2e362666db70b51045becf1d125b3d115e0fb86cbf021f0e085a7a5f16e3b3
+  data.tar.gz: 7754802face80f7e39de89ffc5be7e44197376a53c5ac1bc78f890230ecd840ff0211fce3f489ff8ce9a4298e35084171064ae73882060025c40494371e4075d

data/README.md

@@ -2079,7 +2079,20 @@ end
 
 ### Tube Statistics and Management
 
-Postburner provides methods to inspect and manage Beanstalkd tubes:
+Postburner provides methods to inspect and manage Beanstalkd tubes.
+
+**Note:** Beanstalkd tubes are created lazily - they only exist when jobs have been put into them. This means configured queues (e.g., `default`, `mailers`) won't appear in stats until at least one job has been enqueued to them. The scheduler tube appears immediately because the watchdog job is created on worker startup.
+
+**Example worker startup output:**
+
+```
+[Postburner::Worker] Starting worker 'default'...
+[Postburner::Worker] Queues: default, mailers
+[Postburner::Worker] Startup stats: ready=1 delayed=0 buried=0 reserved=0 total=1
+  postburner.development.scheduler: ready=1 delayed=0 buried=0 reserved=0 total=1
+```
+
+Note that `default` and `mailers` queues are configured but don't appear in stats yet - they'll appear once jobs are enqueued to them.
 
 **View tube statistics:**
 
@@ -2099,6 +2112,31 @@ stats = Postburner.stats(['postburner.production.critical'])
 # => { tubes: [...], totals: {...} }
 ```
 
+**Understanding lazy tube creation:**
+
+```ruby
+# Fresh Beanstalkd, no jobs queued yet - only scheduler tube exists
+stats = Postburner.stats
+# => {
+#   tubes: [
+#     { name: "postburner.development.scheduler", ready: 1, delayed: 0, ... }
+#   ],
+#   totals: { ready: 1, delayed: 0, buried: 0, reserved: 0, total: 1 }
+# }
+# Note: 'default' and 'mailers' tubes don't appear yet!
+
+# After queueing a job to 'default':
+MyJob.perform_later(123)
+stats = Postburner.stats
+# => {
+#   tubes: [
+#     { name: "postburner.development.default", ready: 1, ... },
+#     { name: "postburner.development.scheduler", ready: 1, ... }
+#   ],
+#   totals: { ready: 2, ... }
+# }
+```
+
 **Clear jobs from tubes:**
 
 For safety, `clear_jobs!` requires you to explicitly specify which tubes to clear. This prevents accidentally clearing tubes from other applications sharing the same Beanstalkd server.

data/lib/postburner/runner.rb

@@ -61,6 +61,16 @@ module Postburner
     # @api private
     def load_configuration
       config_path = File.expand_path(options[:config], root_directory)
+
+      unless File.exist?(config_path)
+        logger.warn "[Postburner] Configuration missing: #{config_path}"
+        logger.debug "[Postburner] No configuration file found. (Use --config to specify a different path)"
+        config = Postburner::Configuration.new
+        Postburner.configuration = config
+        return config
+      end
+
+      logger.info "[Postburner] Configuration loaded: #{config_path}"
       config = Postburner::Configuration.load_yaml(config_path, options[:env], options[:worker])
       Postburner.configuration = config
       config
@@ -97,8 +107,6 @@ module Postburner
     # @return [void]
     # @api private
     def log_configuration(config)
-      config_path = File.expand_path(options[:config], root_directory)
-      config.logger.info "[Postburner] Configuration: #{config_path}"
       config.logger.info "[Postburner] Environment: #{options[:env]}"
       if options[:worker] || options[:queues].nil?
         worker_label = options[:worker] || "(auto-selected: #{config.worker_config[:name]})"

data/lib/postburner/version.rb

@@ -1,3 +1,3 @@
 module Postburner
-  VERSION = '1.0.0.pre.20'
+  VERSION = '1.0.0.pre.21'
 end

data/lib/postburner/worker.rb

@@ -140,13 +140,17 @@ module Postburner
 
     # Checks if this process has been orphaned (parent died).
     #
-    # When the parent process dies, the kernel re-parents children to init (PID 1).
-    # Detecting this allows forked children to exit gracefully instead of running
-    # indefinitely as orphans.
+    # When the parent process dies, the kernel re-parents children to init (PID 1)
+    # or a subreaper. Detecting this allows forked children to exit gracefully
+    # instead of running indefinitely as orphans.
     #
-    # @return [Boolean] true if parent PID is 1, false otherwise
+    # Compares current parent PID against the PID recorded at fork time
+    # (@parent_pid), which handles the case where the parent process itself
+    # is PID 1 (e.g., running as a container entrypoint).
+    #
+    # @return [Boolean] true if parent PID changed since fork, false otherwise
     def orphaned?
-      Process.ppid == 1
+      @parent_pid && Process.ppid != @parent_pid
     end
 
     # Calculates exponential backoff sleep duration for reconnection attempts.
@@ -390,7 +394,11 @@ module Postburner
     # @return [void]
     # @api private
     def spawn_fork(fork_num)
-      pid = fork { run_fork(fork_num) }
+      parent_pid = Process.pid
+      pid = fork do
+        @parent_pid = parent_pid
+        run_fork(fork_num)
+      end
       @children[pid] = fork_num
       logger.info "[Postburner::Worker] Spawned fork #{fork_num} (pid: #{pid})"
     end
@@ -880,6 +888,11 @@ module Postburner
     # Shows aggregate totals on first line, followed by per-tube breakdown.
     # Used at worker startup and shutdown to track job backlog.
     #
+    # @note Only tubes that exist in Beanstalkd are shown. Beanstalkd tubes are
+    #   created lazily when jobs are first enqueued, so configured queues like
+    #   'default' or 'mailers' won't appear until jobs have been queued to them.
+    #   The scheduler tube typically appears because the watchdog is created on startup.
+    #
     # @param label [String] Label for the stats (e.g., "Startup", "Shutdown")
     # @return [void]
     # @api private

data/lib/postburner.rb

@@ -528,6 +528,11 @@ module Postburner
   # Collects job counts (ready, delayed, buried, reserved) for each tube
   # and provides aggregate totals across all tubes.
   #
+  # @note Beanstalkd tubes are created lazily - they only exist when jobs have been
+  #   put into them. Tubes that don't exist yet are silently skipped and won't appear
+  #   in the results. This means configured queues (e.g., 'default', 'mailers') won't
+  #   appear in stats until at least one job has been enqueued to them.
+  #
   # @param tube_names [Array<String>, nil] Specific tube names to inspect, or nil for all tubes
   #
   # @return [Hash] Statistics hash with keys:
@@ -543,7 +548,17 @@ module Postburner
   #
   # @example Get stats for specific tubes
   #   stats = Postburner.stats(Postburner.watched_tube_names)
-  #   stats[:tubes].size  # => 3
+  #   stats[:tubes].size  # => 3 (only tubes that exist)
+  #
+  # @example Understanding lazy tube creation
+  #   # Fresh Beanstalkd with no jobs queued yet:
+  #   Postburner.stats(Postburner.watched_tube_names)
+  #   # => { tubes: [], totals: { ready: 0, delayed: 0, ... } }
+  #
+  #   # After queueing a job to 'default':
+  #   MyJob.perform_later(123)
+  #   Postburner.stats(Postburner.watched_tube_names)
+  #   # => { tubes: [{ name: "postburner.development.default", ready: 1, ... }], ... }
   #
   def self.stats(tube_names = nil)
     connected do |conn|

metadata

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