postburner 0.9.0.rc.1 → 1.0.0.pre.2

data/lib/postburner.rb

@@ -1,4 +1,14 @@
 require "postburner/version"
+require "postburner/configuration"
+require "postburner/connection"
+require "postburner/queue_config"
+require "postburner/beanstalkd"
+require "postburner/tracked"
+require "postburner/active_job/payload"
+require "postburner/active_job/execution"
+require "postburner/active_job/adapter"
+require "postburner/workers/base"
+require "postburner/workers/worker"
 require "postburner/engine"
 require "postburner/strategies/queue"
 require "postburner/strategies/nice_queue"
@@ -294,12 +304,12 @@ module Postburner
 
   # Returns a cached Beanstalkd connection.
   #
-  # Creates a new {Backburner::Connection} using the configured Beanstalkd
+  # Creates a new {Postburner::Connection} using the configured Beanstalkd
   # URL and caches it. Automatically reconnects if the connection is stale.
   #
   # For most use cases, prefer {#connected} which handles connection cleanup.
   #
-  # @return [Backburner::Connection] Beanstalkd connection object
+  # @return [Postburner::Connection] Beanstalkd connection object
   #
   # @raise [Beaneater::NotConnected] if connection fails
   #
@@ -313,9 +323,7 @@ module Postburner
   # @see #connected
   #
   def self.connection
-    @_connection ||= Backburner::Connection.new(
-      Backburner.configuration.beanstalk_url
-    )
+    @_connection ||= Postburner::Connection.new
     @_connection.reconnect! unless @_connection.connected?
     @_connection
   end
@@ -328,11 +336,11 @@ module Postburner
   #
   # @overload connected
   #   Returns the cached Beanstalkd connection.
-  #   @return [Backburner::Connection] Beanstalkd connection
+  #   @return [Postburner::Connection] Beanstalkd connection
   #
   # @overload connected {|conn| ... }
   #   Yields connection and ensures cleanup.
-  #   @yieldparam conn [Backburner::Connection] Beanstalkd connection
+  #   @yieldparam conn [Postburner::Connection] Beanstalkd connection
   #   @return [void]
   #
   # @example With block (recommended)
@@ -387,4 +395,67 @@ module Postburner
 
     # TODO
   end
+
+  # Returns array of watched tube names with environment prefix.
+  #
+  # Expands configured queue names to full tube names and memoizes the result.
+  #
+  # @return [Array<String>] Array of expanded tube names
+  #
+  # @example
+  #   Postburner.watched_tube_names
+  #   # => ['postburner.production.default', 'postburner.production.critical']
+  #
+  def self.watched_tube_names
+    @__watched_tube_names ||= configuration.queue_names.map { |q| configuration.expand_tube_name(q) }
+  end
+
+  # Returns array of watched Beaneater::Tube instances.
+  #
+  # Creates Beaneater tube instances for all configured queues and memoizes the result.
+  #
+  # @return [Array<Beaneater::Tube>] Array of tube instances
+  #
+  # @example
+  #   Postburner.watched_tubes.each { |tube| puts tube.stats }
+  #
+  def self.watched_tubes
+    @__watched_tubes ||= watched_tube_names.map { |tube_name| connection.tubes[tube_name] }
+  end
+
+  # Returns statistics and introspection data about Beanstalkd and configured queues.
+  #
+  # Provides Beaneater tube instances for configured tubes and all tubes that exist
+  # on the Beanstalkd server. Tube instances support introspection methods:
+  #
+  # - tube.name - Tube name
+  # - tube.stats - Tube statistics hash (current-jobs-ready, current-jobs-buried, etc.)
+  # - tube.peek_ready - Next ready job
+  # - tube.peek_delayed - Next delayed job
+  # - tube.peek_buried - Next buried job
+  # - tube.kick(n) - Kick n buried jobs back to ready
+  # - tube.pause(delay) - Pause tube for delay seconds
+  # - tube.clear - Delete all jobs in tube
+  #
+  # @return [Hash] Statistics hash with the following keys:
+  #   - watched_tubes: Array of configured/watched Beaneater::Tube instances
+  #   - tubes: Array of all Beaneater::Tube instances on the server
+  #
+  # @raise [Beaneater::NotConnected] if connection to Beanstalkd fails
+  #
+  # @example
+  #   stats = Postburner.stats
+  #   stats[:watched_tubes].each { |tube| puts "#{tube.name}: #{tube.stats}" }
+  #   stats[:tubes].first.peek_ready
+  #
+  def self.stats
+    connected do |conn|
+
+      {
+        watched_tubes: self.watched_tubes,
+        # Get all tube instances that exist on Beanstalkd
+        tubes: conn.beanstalk.tubes.all
+      }
+    end
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: postburner
 version: !ruby/object:Gem::Version
-  version: 0.9.0.rc.1
+  version: 1.0.0.pre.2
 platform: ruby
 authors:
 - Matt Smith
 bindir: bin
 cert_chain: []
-date: 2025-11-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -24,19 +24,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '7.2'
 - !ruby/object:Gem::Dependency
-  name: backburner
+  name: beaneater
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.0
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.0
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -79,10 +79,27 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.1
-description: Queue background jobs, inspect them, and audit them afterwards.
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+description: 'Fast Beanstalkd-backed job queue with optional PostgreSQL audit trail.
+  Dual-mode execution: lite jobs (Beanstalkd only) or tracked jobs (full audit with
+  logs, timing, errors).'
 email:
 - matt@nearapogee.com
-executables: []
+executables:
+- postburner
 extensions: []
 extra_rdoc_files: []
 files:
@@ -102,23 +119,39 @@ files:
 - app/models/postburner/application_record.rb
 - app/models/postburner/job.rb
 - app/models/postburner/mailer.rb
+- app/models/postburner/tracked_job.rb
 - app/views/layouts/postburner/application.html.haml
 - app/views/postburner/jobs/index.html.haml
 - app/views/postburner/jobs/show.html.haml
+- bin/postburner
+- bin/rails
 - config/environment.rb
+- config/postburner.yml
+- config/postburner.yml.example
 - config/routes.rb
 - lib/generators/postburner/install/USAGE
 - lib/generators/postburner/install/install_generator.rb
+- lib/generators/postburner/install/templates/config/postburner.yml
 - lib/generators/postburner/install/templates/migrations/create_postburner_jobs.rb.erb
 - lib/postburner.rb
+- lib/postburner/active_job/adapter.rb
+- lib/postburner/active_job/execution.rb
+- lib/postburner/active_job/payload.rb
+- lib/postburner/beanstalkd.rb
+- lib/postburner/configuration.rb
+- lib/postburner/connection.rb
 - lib/postburner/engine.rb
+- lib/postburner/queue_config.rb
 - lib/postburner/strategies/immediate_test_queue.rb
 - lib/postburner/strategies/nice_queue.rb
 - lib/postburner/strategies/null_queue.rb
 - lib/postburner/strategies/queue.rb
 - lib/postburner/strategies/test_queue.rb
 - lib/postburner/time_helpers.rb
+- lib/postburner/tracked.rb
 - lib/postburner/version.rb
+- lib/postburner/workers/base.rb
+- lib/postburner/workers/worker.rb
 - lib/tasks/postburner_tasks.rake
 homepage: https://gitlab.nearapogee.com/opensource/postburner
 licenses:
@@ -141,7 +174,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
-summary: Postgres backed beanstalkd queue via backburner
+summary: PostgreSQL-backed job queue with optional audit trail for ActiveJob
 test_files: []