solid-jobs 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c178515fb3c56d80f0380da9f25114cd44679135b4d3d39fb468c45760748a7
-  data.tar.gz: 94080a99ea85f351714722d4f4f073ab99f01b2e5096a8e304670138171cf1ab
+  metadata.gz: 7f95c0daf98dbfa77203eaa6d182f0b0a5ce4c22738a29f7d81b587c9f3abe3a
+  data.tar.gz: bf5524aa572a45f439732ec30e5ad12d5ad25b37a98462381d39bd90b5dd7c91
 SHA512:
-  metadata.gz: fc05837b46c971dfd517cedac8bd46960867160cce776384eced29d41fac3a787b1f45a1a8f2d21ebeddbdb828766087a01396f245a255e5e77443bfa5366a2f
-  data.tar.gz: af56380ec6a6e82470d4df8c477b0e87eec5dc9aaddb9d04fcad32f6d630f695254c77008b2c4cb4400b496a2a5a566a4b1e58fec2b93d536ad3447868146099
+  metadata.gz: cecbfb4efd3abe1598e66b1764ca07da25e4d103c5e59b66c14f84f5f8f3af6b45e91710d535b0b15ee69636a9396629a0e980451202f390a8aebb8a6b41091b
+  data.tar.gz: cf40a09b495d1ea62e0789ea8688b530b26bfc7414e77cd2d4cc30f8c874c1a8f6c19b20f2eb2c493c8ca27bbeb2a319a62024dff639d6748d720b1ab13c04d6

data/CHANGELOG.md

@@ -2,12 +2,51 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.0] - 2026-10-03
+
+### Changed
+
+- Keep the independent SolidJobs runtime, envelope, `solid_jobs:` keyspace,
+  interceptors, claims, and renamed component vocabulary from 0.3.0.
+- Remaining shared names with other Ruby job libraries are limited to
+  `version.rb`, Rails Active Job adapter contracts (`ActiveJob`,
+  `QueueAdapters`, `enqueue_at`), and generic Ruby methods.
+
+## [0.3.0] - 2026-10-03
+
+### Breaking
+
+- Rename the runtime components to SolidJobs-specific names:
+  `Config` to `Blueprint`, `Server` to `Conductor`, `Processor` to `Engine`,
+  `CLI` to `Console`, `Testing` to `Lab`, and `Metrics` to `Counters`.
+- Rename the task execution callback from `perform` to `execute_task`.
+- Rename `Task.enqueue_at` to `Task.schedule_at`. The Active Job adapter keeps
+  its Rails-required `enqueue_at` method.
+- Rename the Active Job execution task from `ActiveJob::Wrapper` to
+  `RailsAdapter::AdapterTask`.
+- Rename generic implementation files to match the new component vocabulary.
+  `version.rb` remains unchanged as the standard Ruby gem version entry point.
+- Remove the remaining generic internal constants `ClassMethods`,
+  `EmptyQueueError`, and `Shutdown` in favor of `TaskMethods`,
+  `NoCapturedTask`, and `ExecutionHalt`.
+- Replace `Node#quiet`, `Node#stop`, and `Node#dump_threads` with
+  `Node#request_control(:pause)`, `:shutdown`, or `:backtraces`.
+
+### Changed
+
+- Update the executable, Rails adapter, documentation, benchmarks, and test
+  suite to use the new vocabulary consistently.
+- Keep the SolidJobs task API, envelope, `solid_jobs:` Redis keyspace, claims,
+  interceptors, and failure model introduced in 0.2.0.
+- Convert configuration keys using Ruby hash transformations, preserving
+  nested values and leaving the original input unchanged.
+
 ## [0.2.0] - 2026-10-03
 
 ### Breaking
 
 - Replace the previous job API with the independent `SolidJobs::Task` API:
-  `enqueue`, `enqueue_after`, `enqueue_at`, `enqueue_many`, `execute`, and
+  `enqueue`, `enqueue_after`, `schedule_at`, `enqueue_many`, `execute`, and
   `with_options`.
 - Replace the previous payload with a SolidJobs envelope using `id`, `task`,
   `arguments`, `channel`, `run_at`, `created_ms`, and `queued_ms`.
@@ -15,7 +54,7 @@ All notable changes to this project will be documented in this file.
   not read or migrated automatically.
 - Replace middleware chains with `publish_interceptors` and
   `execute_interceptors`, whose interceptors implement `around(context)`.
-- Replace the administrative API with `Metrics`, `Channel`, `StoredTask`,
+- Replace the administrative API with `Counters`, `Channel`, `StoredTask`,
   `PlannedTasks`, `RetryingTasks`, `DiscardedTasks`, `Node`, `Nodes`,
   `Execution`, and `Claims`.
 - Replace queue configuration with channels and the `:weighted`, `:priority`,
@@ -28,7 +67,7 @@ All notable changes to this project will be documented in this file.
   and requeue operations.
 - Failure handling uses `max_failures`, `retry_within`, `retry_delay`, and
   `after_final_failure`.
-- Testing modes are now `:capture` and `:execute`.
+- Lab modes are now `:capture` and `:execute`.
 
 ## [0.1.3] - 2026-10-01
 
@@ -41,9 +80,9 @@ All notable changes to this project will be documented in this file.
 
 ### Added
 
-- `Server#start` logs a warning on Ruby < 4 when `concurrency > 1`, pointing
+- `Conductor#start` logs a warning on Ruby < 4 when `concurrency > 1`, pointing
   to the Ruby 3.4 Ractor GC-barrier deadlock and the recommended setups.
-- `Server#stop` is bounded: components get `shutdown_timeout + STOP_GRACE`
+- `Conductor#stop` is bounded: components get `shutdown_timeout + STOP_GRACE`
   to return, `:stop` is re-sent up to `STOP_RESENDS` times, then the
   component is abandoned with an error log instead of hanging shutdown.
 - `test/support/ractor_barrier_repro.rb`: standalone reproducer of the Ruby
@@ -51,7 +90,7 @@ All notable changes to this project will be documented in this file.
 
 ### Changed
 
-- Server-based stress tests are skipped on Ruby < 4: Ruby 3.4's Ractor
+- Conductor-based stress tests are skipped on Ruby < 4: Ruby 3.4's Ractor
   scheduler deadlocks the VM on a GC barrier under cross-Ractor `move:`
   traffic. Multi-Ractor servers are recommended on Ruby ≥ 4.0 (see
   `docs/reliability.md`). CI jobs now time out after 20 minutes.
@@ -74,7 +113,7 @@ All notable changes to this project will be documented in this file.
 
 ### Added
 
-- Ractor-oriented client, Processor, Scheduler, Heartbeat, and Server runtime.
+- Ractor-oriented client, Engine, Scheduler, Heartbeat, and Conductor runtime.
 - Sidekiq-compatible Redis queue keys and open-source job payload format.
 - Immediate, scheduled, retry, and dead-job handling.
 - At-least-once reservations with atomic journaling, generation-fenced ACK
@@ -89,6 +128,7 @@ All notable changes to this project will be documented in this file.
 - Reliable-hot-path and CPU-scaling profilers plus the independent Sidekiq
   comparison benchmark.
 
+[0.3.0]: https://github.com/nicolasva/solid-jobs/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/nicolasva/solid-jobs/compare/v0.1.3...v0.2.0
 [0.1.3]: https://github.com/nicolasva/solid-jobs/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/nicolasva/solid-jobs/compare/v0.1.1...v0.1.2

data/README.md

@@ -27,14 +27,14 @@ class RecalculateAccount
 
   task_options channel: "critical", max_failures: 10
 
-  def perform(account_id)
+  def execute_task(account_id)
     Account.find(account_id).recalculate!
   end
 end
 
 RecalculateAccount.enqueue(42)
 RecalculateAccount.enqueue_after(30, 42)
-RecalculateAccount.enqueue_at(Time.now + 300, 42)
+RecalculateAccount.schedule_at(Time.now + 300, 42)
 RecalculateAccount.enqueue_many([[42], [43], [44]])
 ```
 
@@ -131,7 +131,7 @@ override, SolidJobs uses capped exponential backoff with equal jitter.
 ## Delivery semantics
 
 SolidJobs provides **at-least-once** delivery. An executor atomically claims a
-task before execution and completes the claim only after `perform` returns.
+task before execution and completes the claim only after `execute_task` returns.
 Graceful shutdown requeues unfinished tasks. Claims owned by a crashed node are
 recovered into their original channels.
 
@@ -142,7 +142,19 @@ application-level deduplication when duplicate effects are unsafe.
 See [docs/reliability.md](docs/reliability.md) for the state machine, claim
 fencing, recovery rules, and Ruby Ractor caveats.
 
-## Testing
+## Node control
+
+```ruby
+node = SolidJobs::Nodes.new.first
+node.request_control(:pause)
+node.request_control(:backtraces)
+node.request_control(:shutdown)
+```
+
+Control requests are asynchronous and use the selected node's namespaced Redis
+mailbox. Unknown actions raise `KeyError` without writing a request.
+
+## Lab
 
 ```ruby
 SolidJobs.testing!(:capture) do

data/docs/reliability.md

@@ -40,7 +40,7 @@ age alone, so a legitimate long-running task is not stolen.
 ## Failure boundaries
 
 - Before claim: the task remains in `solid_jobs:channel:<name>`.
-- After claim or during `perform`: the task remains claimed.
+- After claim or during `execute_task`: the task remains claimed.
 - After the application effect but before completion: recovery replays it.
 - Redis unavailable during completion: the task remains claimed and is replayed.
 - Graceful shutdown: the active task may finish within the configured timeout;
@@ -53,7 +53,7 @@ effects require application-level idempotency.
 ## Startup isolation
 
 The server does not claim work while components are booting. Heartbeat,
-Processor, and Timer Ractors initialize their local configuration and Redis
+Engine, and Timer Ractors initialize their local configuration and Redis
 pool, report `READY` exactly once, and wait behind
 `SolidJobs::StartupBarrier`:
 
@@ -74,14 +74,14 @@ barrier runs while several Ractors exchange moved messages.
 Redis. Ruby 4.0.1 completes the equivalent reproducer.
 
 Run multi-Ractor SolidJobs servers on Ruby >= 4.0. On Ruby 3.4, prefer one
-process per Processor (`concurrency: 1`). Server stress tests are skipped on
-Ruby versions affected by this runtime issue, and `Server#start` warns when it
+process per Engine (`concurrency: 1`). Conductor stress tests are skipped on
+Ruby versions affected by this runtime issue, and `Conductor#start` warns when it
 detects a multi-Ractor configuration there.
 
 ## Bounded shutdown
 
-`Server#stop` never waits forever for a component. Each Ractor gets
-`shutdown_timeout + Server::STOP_GRACE` to return after `:stop`; the signal is
+`Conductor#stop` never waits forever for a component. Each Ractor gets
+`shutdown_timeout + Conductor::STOP_GRACE` to return after `:stop`; the signal is
 re-sent up to `STOP_RESENDS` times before the component is abandoned with an
 error log.
 
@@ -111,7 +111,7 @@ retains it so recovery increments the same attempt sequence.
 
 ## Backpressure and channels
 
-Each Processor owns at most one claim and claims only immediately before
+Each Engine owns at most one claim and claims only immediately before
 execution. A node with concurrency `N` therefore holds at most `N` active
 claims, regardless of channel depth.
 

data/exe/solid-jobs

@@ -2,7 +2,6 @@
 # frozen_string_literal: true
 
 require "solid_jobs"
-require "solid_jobs/cli"
-
-exit SolidJobs::CLI.new.run
+require "solid_jobs/console"
 
+exit SolidJobs::Console.new.run

data/lib/active_job/queue_adapters/solid_jobs_adapter.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "solid_jobs"
-require "solid_jobs/active_job"
+require "solid_jobs/rails_adapter"
 
 module ActiveJob
   module QueueAdapters
@@ -28,7 +28,7 @@ module ActiveJob
 
       def push(job, at: nil)
         envelope = {
-          "task" => SolidJobs::ActiveJob::Wrapper,
+          "task" => SolidJobs::RailsAdapter::AdapterTask,
           "wrapped" => job.class.name,
           "channel" => job.queue_name,
           "arguments" => [job.serialize],

data/lib/solid_jobs/{config.rb → blueprint.rb}

@@ -3,7 +3,7 @@
 require "logger"
 
 module SolidJobs
-  class Config
+  class Blueprint
     DEFAULT_TASK_OPTIONS = {
       "channel" => "default",
       "max_failures" => 25,

data/lib/solid_jobs/{api.rb → catalog.rb}

@@ -3,7 +3,7 @@
 require "json"
 
 module SolidJobs
-  class Metrics
+  class Counters
     attr_reader :config
 
     def initialize(config: SolidJobs.config)
@@ -245,6 +245,12 @@ module SolidJobs
   end
 
   class Node
+    CONTROL_SIGNALS = {
+      pause: "TSTP",
+      shutdown: "TERM",
+      backtraces: "TTIN",
+    }.freeze
+
     attr_reader :identity
 
     def initialize(identity, config: SolidJobs.config)
@@ -283,16 +289,10 @@ module SolidJobs
       Time.at(Float(@attributes["beat"])) if @attributes["beat"]
     end
 
-    def quiet
-      signal("TSTP")
-    end
-
-    def stop
-      signal("TERM")
-    end
-
-    def dump_threads
-      signal("TTIN")
+    def request_control(action)
+      name = CONTROL_SIGNALS.fetch(action)
+      @config.redis_pool.call("LPUSH", Keyspace.node_signals(identity), name)
+      true
     end
 
     def executions
@@ -301,13 +301,6 @@ module SolidJobs
         Execution.new(identity, executor_id, raw)
       end
     end
-
-    private
-
-    def signal(name)
-      @config.redis_pool.call("LPUSH", Keyspace.node_signals(identity), name)
-      true
-    end
   end
 
   class Nodes

data/lib/solid_jobs/{server.rb → conductor.rb}

@@ -5,7 +5,7 @@ require "socket"
 require "timeout"
 
 module SolidJobs
-  class Server
+  class Conductor
     # Extra time granted beyond shutdown_timeout before a component is
     # considered stuck, and how many times :stop is re-sent before giving up.
     STOP_GRACE = 5.0
@@ -25,7 +25,7 @@ module SolidJobs
     end
 
     def start
-      raise Error, "Server is already running" if @started
+      raise Error, "Conductor is already running" if @started
 
       warn_ruby34_multi_ractor
       snapshot = Utilities.shareable_copy(
@@ -38,7 +38,7 @@ module SolidJobs
         local_config = heartbeat = nil
         begin
           started = SolidJobs::StartupBarrier.boot(ready) do
-            local_config = SolidJobs::Config.from_ractor_snapshot(settings)
+            local_config = SolidJobs::Blueprint.from_ractor_snapshot(settings)
             SolidJobs.use_config(local_config)
             heartbeat = SolidJobs::Heartbeat.new(
               local_config,
@@ -119,9 +119,9 @@ module SolidJobs
           local_config = processor = nil
           begin
             started = SolidJobs::StartupBarrier.boot(ready_port) do
-              local_config = SolidJobs::Config.from_ractor_snapshot(settings)
+              local_config = SolidJobs::Blueprint.from_ractor_snapshot(settings)
               SolidJobs.use_config(local_config)
-              processor = SolidJobs::Processor.new(
+              processor = SolidJobs::Engine.new(
                 local_config,
                 identity: settings.fetch(:identity),
                 processor_id: id,
@@ -161,7 +161,7 @@ module SolidJobs
         local_config = scheduler = nil
         begin
           started = SolidJobs::StartupBarrier.boot(ready) do
-            local_config = SolidJobs::Config.from_ractor_snapshot(settings)
+            local_config = SolidJobs::Blueprint.from_ractor_snapshot(settings)
             SolidJobs.use_config(local_config)
             scheduler = SolidJobs::Timer.new(local_config)
             local_config.redis_pool.call("PING")
@@ -227,8 +227,8 @@ module SolidJobs
 
     RUBY34_MULTI_RACTOR_WARNING =
       "SolidJobs: Ruby %s can deadlock the whole VM on a Ractor GC barrier " \
-      "under multi-Processor load (see docs/reliability.md). Run multi-Ractor " \
-      "servers on Ruby >= 4.0, or use concurrency: 1 (one process per Processor)."
+      "under multi-Engine load (see docs/reliability.md). Run multi-Ractor " \
+      "servers on Ruby >= 4.0, or use concurrency: 1 (one process per Engine)."
 
     def warn_ruby34_multi_ractor
       return if RUBY_VERSION >= "4" || config.concurrency <= 1

data/lib/solid_jobs/{cli.rb → console.rb}

@@ -4,7 +4,7 @@ require "optparse"
 require "yaml"
 
 module SolidJobs
-  class CLI
+  class Console
     SIGNALS = %w[INT TERM TSTP TTIN INFO].freeze
 
     def initialize
@@ -16,7 +16,7 @@ module SolidJobs
       load_configuration
       load_application
       apply_options
-      server = Server.new(config: SolidJobs.config).start
+      server = Conductor.new(config: SolidJobs.config).start
       read_io, write_io = IO.pipe
       handlers = install_signal_handlers(write_io)
       wait_for_shutdown(server, read_io)
@@ -38,7 +38,7 @@ module SolidJobs
         options.banner = "Usage: solid-jobs [options]"
         options.on("-r", "--require PATH", "Require an application file") { |value| @options[:require] = value }
         options.on("-C", "--config PATH", "Load YAML configuration") { |value| @options[:config] = value }
-        options.on("-c", "--concurrency N", Integer, "Processor Ractor count") { |value| @options[:concurrency] = value }
+        options.on("-c", "--concurrency N", Integer, "Engine Ractor count") { |value| @options[:concurrency] = value }
         options.on("--channel CHANNEL", "Channel name or name,weight") do |value|
           @options[:channels] << channel(value)
         end

data/lib/solid_jobs/{processor.rb → engine.rb}

@@ -3,7 +3,7 @@
 require "json"
 
 module SolidJobs
-  class Processor
+  class Engine
     def initialize(config, identity: nil, processor_id: nil, heartbeat: nil)
       @config = config
       @claims = Claim.new(config, identity: identity, processor_id: processor_id)
@@ -46,7 +46,7 @@ module SolidJobs
           register_work(claim, envelope)
           begin
             @executor.execute(envelope)
-          rescue Shutdown
+          rescue ExecutionHalt
             requeue(claim)
             break
           rescue StandardError => error
@@ -73,7 +73,7 @@ module SolidJobs
 
     def interrupt_current
       runner = @state_mutex.synchronize { @runner if @busy }
-      runner&.raise(Shutdown, "SolidJobs shutdown timeout exceeded")
+      runner&.raise(ExecutionHalt, "SolidJobs shutdown timeout exceeded")
     end
 
     private

data/lib/solid_jobs/errors.rb

@@ -5,5 +5,5 @@ module SolidJobs
   class InvalidJobError < ArgumentError; end
   class InvalidArgumentError < InvalidJobError; end
   class ConfigurationError < Error; end
-  class Shutdown < Error; end
+  class ExecutionHalt < Error; end
 end

data/lib/solid_jobs/executor.rb

@@ -9,7 +9,7 @@ module SolidJobs
     attr_reader :config
 
     def initialize(redis_config:, config: nil)
-      @config = config || Config.new(redis: redis_config)
+      @config = config || Blueprint.new(redis: redis_config)
     end
 
     def execute(envelope)
@@ -25,7 +25,7 @@ module SolidJobs
 
       task = Utilities.constantize(task_name).new
       task.task_id = envelope["id"] if task.respond_to?(:task_id=)
-      operation = -> { task.perform(*envelope.fetch("arguments")) }
+      operation = -> { task.execute_task(*envelope.fetch("arguments")) }
       return operation.call if config.execute_interceptors.empty?
 
       config.execute_interceptors.call(Execution.new(task, envelope), &operation)

data/lib/solid_jobs/{testing.rb → lab.rb}

@@ -3,7 +3,7 @@
 require "securerandom"
 
 module SolidJobs
-  module Testing
+  module Lab
     MODES = %i[disable capture execute].freeze
     STORAGE_KEY = :solid_jobs_testing_captured
     MODE_KEY = :solid_jobs_testing_mode

data/lib/solid_jobs/publisher.rb

@@ -19,7 +19,7 @@ module SolidJobs
 
     def initialize(config: nil, configuration: nil)
       selected = config || configuration || SolidJobs.config
-      @config = selected.is_a?(SolidRedis::Config) ? Config.new(redis: selected) : selected
+      @config = selected.is_a?(SolidRedis::Config) ? Blueprint.new(redis: selected) : selected
     end
 
     def publish(envelope)
@@ -88,15 +88,15 @@ module SolidJobs
     def persist(envelopes)
       return true if envelopes.empty?
 
-      if defined?(Testing)
-        case Testing.mode
+      if defined?(Lab)
+        case Lab.mode
         when :capture
           envelopes.each do |envelope|
-            Testing.captured_for(Utilities.constantize(envelope.fetch("task"))) << envelope
+            Lab.captured_for(Utilities.constantize(envelope.fetch("task"))) << envelope
           end
           return true
         when :execute
-          envelopes.each { |envelope| Testing.execute(envelope) }
+          envelopes.each { |envelope| Lab.execute(envelope) }
           return true
         end
       end

data/lib/solid_jobs/{active_job.rb → rails_adapter.rb}

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 module SolidJobs
-  module ActiveJob
-    class Wrapper
+  module RailsAdapter
+    class AdapterTask
       include SolidJobs::Task
 
-      def perform(job_data)
+      def execute_task(job_data)
         ::ActiveJob::Base.execute(job_data.merge("provider_job_id" => task_id))
       end
     end

data/lib/solid_jobs/{rails.rb → railtie.rb}

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "active_job"
+require_relative "rails_adapter"
 
 if defined?(Rails::Railtie)
   module SolidJobs
@@ -13,4 +13,3 @@ if defined?(Rails::Railtie)
     end
   end
 end
-

data/lib/solid_jobs/task.rb

@@ -3,7 +3,7 @@
 module SolidJobs
   module Task
     def self.included(base)
-      base.extend(ClassMethods)
+      base.extend(TaskMethods)
       base.include(InstanceMethods)
       base.task_options
     end
@@ -25,7 +25,7 @@ module SolidJobs
       end
     end
 
-    module ClassMethods
+    module TaskMethods
       def task_options(options = nil)
         if options
           merged = current_task_options.merge(Utilities.stringify_keys(options))
@@ -64,16 +64,16 @@ module SolidJobs
       end
 
       def enqueue_after(delay, *arguments)
-        enqueue_at(Time.now.to_f + Float(delay), *arguments)
+        schedule_at(Time.now.to_f + Float(delay), *arguments)
       end
 
-      def enqueue_at(time, *arguments)
+      def schedule_at(time, *arguments)
         timestamp = time.is_a?(Time) ? time.to_f : Float(time)
         publish("task" => self, "arguments" => arguments, "run_at" => timestamp)
       end
 
       def execute(*arguments)
-        Testing.execute(current_task_options.merge("task" => self, "arguments" => arguments))
+        Lab.execute(current_task_options.merge("task" => self, "arguments" => arguments))
       end
 
       def with_options(options)
@@ -81,7 +81,7 @@ module SolidJobs
       end
 
       def captured
-        Testing.captured_for(self)
+        Lab.captured_for(self)
       end
 
       def clear_captured
@@ -90,9 +90,9 @@ module SolidJobs
 
       def execute_next
         envelope = captured.shift
-        raise EmptyQueueError, "No captured task for #{name}" unless envelope
+        raise NoCapturedTask, "No captured task for #{name}" unless envelope
 
-        Testing.execute(envelope)
+        Lab.execute(envelope)
       end
 
       private
@@ -114,17 +114,17 @@ module SolidJobs
         if (delay = @options.delete("delay"))
           enqueue_after(delay, *arguments)
         elsif (time = @options.delete("run_at"))
-          enqueue_at(time, *arguments)
+          schedule_at(time, *arguments)
         else
           publish(arguments)
         end
       end
 
       def enqueue_after(delay, *arguments)
-        enqueue_at(Time.now.to_f + Float(delay), *arguments)
+        schedule_at(Time.now.to_f + Float(delay), *arguments)
       end
 
-      def enqueue_at(time, *arguments)
+      def schedule_at(time, *arguments)
         timestamp = time.is_a?(Time) ? time.to_f : Float(time)
         publish(arguments, "run_at" => timestamp)
       end
@@ -143,5 +143,5 @@ module SolidJobs
     end
   end
 
-  class EmptyQueueError < Error; end
+  class NoCapturedTask < Error; end
 end

data/lib/solid_jobs/utilities.rb

@@ -5,20 +5,14 @@ module SolidJobs
     module_function
 
     def stringify_keys(value)
-      case value
-      when Hash
-        value.each_with_object({}) do |(key, nested), result|
-          result[key.to_s] = stringify_keys(nested)
-        end
-      when Array
-        value.map { |nested| stringify_keys(nested) }
-      else
-        value
-      end
+      return stringify_hash_keys(value).transform_values { |nested| stringify_keys(nested) } if value.is_a?(Hash)
+      return value.map { |nested| stringify_keys(nested) } if value.is_a?(Array)
+
+      value
     end
 
     def stringify_hash_keys(hash)
-      hash.each_with_object({}) { |(key, value), result| result[key.to_s] = value }
+      hash.transform_keys(&:to_s)
     end
 
     def shareable_copy(value)

data/lib/solid_jobs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolidJobs
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

data/lib/solid_jobs.rb

@@ -11,22 +11,22 @@ require_relative "solid_jobs/keyspace"
 require_relative "solid_jobs/ractor_support"
 require_relative "solid_jobs/startup_barrier"
 require_relative "solid_jobs/interceptor_registry"
-require_relative "solid_jobs/config"
+require_relative "solid_jobs/blueprint"
 require_relative "solid_jobs/publisher"
-require_relative "solid_jobs/testing"
+require_relative "solid_jobs/lab"
 require_relative "solid_jobs/task"
 require_relative "solid_jobs/executor"
 require_relative "solid_jobs/claim"
 require_relative "solid_jobs/failure_policy"
 require_relative "solid_jobs/timer"
-require_relative "solid_jobs/processor"
+require_relative "solid_jobs/engine"
 require_relative "solid_jobs/heartbeat"
 require_relative "solid_jobs/recovery"
 require_relative "solid_jobs/integrity_check"
-require_relative "solid_jobs/server"
-require_relative "solid_jobs/api"
-require_relative "solid_jobs/active_job" if defined?(::ActiveJob::Base)
-require_relative "solid_jobs/rails" if defined?(::Rails::Railtie)
+require_relative "solid_jobs/conductor"
+require_relative "solid_jobs/catalog"
+require_relative "solid_jobs/rails_adapter" if defined?(::ActiveJob::Base)
+require_relative "solid_jobs/railtie" if defined?(::Rails::Railtie)
 
 module SolidJobs
   CONFIG_KEY = :solid_jobs_config
@@ -36,7 +36,7 @@ module SolidJobs
   # Configuration is Ractor-local: every thread and fiber inside a Ractor
   # shares it, while each Ractor keeps its own isolated configuration.
   def config
-    Ractor.current[CONFIG_KEY] ||= Config.new
+    Ractor.current[CONFIG_KEY] ||= Blueprint.new
   end
 
   def configure
@@ -51,11 +51,11 @@ module SolidJobs
 
   def reset!
     Ractor.current[CONFIG_KEY]&.close
-    Ractor.current[CONFIG_KEY] = Config.new
+    Ractor.current[CONFIG_KEY] = Blueprint.new
   end
 
   def testing!(mode, &block)
-    Testing.testing!(mode, &block)
+    Lab.testing!(mode, &block)
   end
 
   def enqueue(task, arguments, channel: "default", **options)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid-jobs
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Nicolas Vandenbogaerde
@@ -119,11 +119,12 @@ files:
 - exe/solid-jobs
 - lib/active_job/queue_adapters/solid_jobs_adapter.rb
 - lib/solid_jobs.rb
-- lib/solid_jobs/active_job.rb
-- lib/solid_jobs/api.rb
+- lib/solid_jobs/blueprint.rb
+- lib/solid_jobs/catalog.rb
 - lib/solid_jobs/claim.rb
-- lib/solid_jobs/cli.rb
-- lib/solid_jobs/config.rb
+- lib/solid_jobs/conductor.rb
+- lib/solid_jobs/console.rb
+- lib/solid_jobs/engine.rb
 - lib/solid_jobs/errors.rb
 - lib/solid_jobs/executor.rb
 - lib/solid_jobs/failure_policy.rb
@@ -131,15 +132,14 @@ files:
 - lib/solid_jobs/integrity_check.rb
 - lib/solid_jobs/interceptor_registry.rb
 - lib/solid_jobs/keyspace.rb
-- lib/solid_jobs/processor.rb
+- lib/solid_jobs/lab.rb
 - lib/solid_jobs/publisher.rb
 - lib/solid_jobs/ractor_support.rb
-- lib/solid_jobs/rails.rb
+- lib/solid_jobs/rails_adapter.rb
+- lib/solid_jobs/railtie.rb
 - lib/solid_jobs/recovery.rb
-- lib/solid_jobs/server.rb
 - lib/solid_jobs/startup_barrier.rb
 - lib/solid_jobs/task.rb
-- lib/solid_jobs/testing.rb
 - lib/solid_jobs/timer.rb
 - lib/solid_jobs/utilities.rb
 - lib/solid_jobs/version.rb