async-background 1.0.2 → 1.1.0

data/lib/async/background/web/sql.rb

@@ -9,79 +9,73 @@ module Async
         ROLLBACK = 'ROLLBACK'.freeze
         QUERY_ONLY = 'PRAGMA query_only = ON'.freeze
         BUSY_TIMEOUT = 'PRAGMA busy_timeout = 2000'.freeze
+        BASE_COLUMNS = %w[id class_name args options].freeze
 
-        OVERVIEW_EXECUTING = "SELECT COUNT(*) FROM jobs WHERE status = 'running' AND started_at IS NOT NULL".freeze
-        OVERVIEW_CLAIMED   = "SELECT COUNT(*) FROM jobs WHERE status = 'running' AND started_at IS NULL".freeze
-        OVERVIEW_PENDING   = "SELECT COUNT(*) FROM jobs WHERE status = 'pending'".freeze
-        OVERVIEW_DONE      = "SELECT COUNT(*) FROM jobs WHERE status = 'done'".freeze
-        OVERVIEW_FAILED    = "SELECT COUNT(*) FROM jobs WHERE status = 'failed'".freeze
-        OVERVIEW_NEXT_PENDING = "SELECT MIN(run_at) FROM jobs WHERE status = 'pending'".freeze
+        STATUS_PREDICATE = {
+          executing: "status = 'running' AND started_at IS NOT NULL",
+          claimed: "status = 'running' AND started_at IS NULL",
+          pending: "status = 'pending'",
+          done: "status = 'done'",
+          failed: "status = 'failed'"
+        }.freeze
 
-        EXECUTING = <<~SQL.freeze
-          SELECT id, class_name, args, options, started_at, locked_by, locked_at
-          FROM jobs
-          WHERE status = 'running' AND started_at IS NOT NULL
-          ORDER BY started_at, id
-          LIMIT ?
-        SQL
+        EXTRA_COLUMNS = {
+          executing: %w[started_at locked_by locked_at],
+          claimed: %w[locked_at locked_by],
+          pending: %w[created_at run_at],
+          done: %w[finished_at duration_ms],
+          failed: %w[finished_at duration_ms last_error_class last_error_message]
+        }.freeze
 
-        CLAIMED = <<~SQL.freeze
-          SELECT id, class_name, args, options, locked_at, locked_by
-          FROM jobs
-          WHERE status = 'running' AND started_at IS NULL
-          ORDER BY locked_at, id
-          LIMIT ?
-        SQL
+        KEYSET = {
+          executing: ['started_at', :asc],
+          claimed: ['locked_at', :asc],
+          pending: ['run_at', :asc],
+          done: ['finished_at', :desc],
+          failed: ['finished_at', :desc]
+        }.freeze
 
-        DONE = <<~SQL.freeze
-          SELECT id, class_name, args, options, finished_at, duration_ms
-          FROM jobs
-          WHERE status = 'done'
-          ORDER BY finished_at DESC, id DESC
-          LIMIT ?
-        SQL
+        ORDER_SQL = {asc: 'ORDER BY %<column>s, id', desc: 'ORDER BY %<column>s DESC, id DESC'}.freeze
+        SEEK_SQL = {asc: '(%<column>s, id) > (?, ?)', desc: '(%<column>s, id) < (?, ?)'}.freeze
 
-        DONE_AFTER = <<~SQL.freeze
-          SELECT id, class_name, args, options, finished_at, duration_ms
-          FROM jobs
-          WHERE status = 'done' AND (finished_at, id) < (?, ?)
-          ORDER BY finished_at DESC, id DESC
-          LIMIT ?
-        SQL
+        def self.columns_for(status)
+          (BASE_COLUMNS + EXTRA_COLUMNS.fetch(status)).join(', ')
+        end
 
-        FAILED = <<~SQL.freeze
-          SELECT id, class_name, args, options, finished_at, duration_ms,
-                 last_error_class, last_error_message
-          FROM jobs
-          WHERE status = 'failed'
-          ORDER BY finished_at DESC, id DESC
-          LIMIT ?
-        SQL
+        def self.count_query(status)
+          "SELECT COUNT(*) FROM jobs WHERE #{STATUS_PREDICATE.fetch(status)}".freeze
+        end
 
-        FAILED_AFTER = <<~SQL.freeze
-          SELECT id, class_name, args, options, finished_at, duration_ms,
-                 last_error_class, last_error_message
-          FROM jobs
-          WHERE status = 'failed' AND (finished_at, id) < (?, ?)
-          ORDER BY finished_at DESC, id DESC
-          LIMIT ?
-        SQL
+        def self.list_query(status, seek: false)
+          column, direction = KEYSET.fetch(status)
+          predicate = STATUS_PREDICATE.fetch(status)
+          predicate += " AND #{format(SEEK_SQL.fetch(direction), column: column)}" if seek
 
-        PENDING = <<~SQL.freeze
-          SELECT id, class_name, args, options, created_at, run_at
-          FROM jobs
-          WHERE status = 'pending'
-          ORDER BY run_at, id
-          LIMIT ?
-        SQL
+          <<~SQL.freeze
+            SELECT #{columns_for(status)}
+            FROM jobs
+            WHERE #{predicate}
+            #{format(ORDER_SQL.fetch(direction), column: column)}
+            LIMIT ?
+          SQL
+        end
 
-        PENDING_AFTER = <<~SQL.freeze
-          SELECT id, class_name, args, options, created_at, run_at
-          FROM jobs
-          WHERE status = 'pending' AND (run_at, id) > (?, ?)
-          ORDER BY run_at, id
-          LIMIT ?
-        SQL
+        OVERVIEW_EXECUTING = count_query(:executing)
+        OVERVIEW_CLAIMED = count_query(:claimed)
+        OVERVIEW_PENDING = count_query(:pending)
+        OVERVIEW_DONE = count_query(:done)
+        OVERVIEW_FAILED = count_query(:failed)
+        OVERVIEW_NEXT_PENDING = "SELECT MIN(run_at) FROM jobs WHERE #{STATUS_PREDICATE.fetch(:pending)}".freeze
+
+        EXECUTING = list_query(:executing)
+        CLAIMED = list_query(:claimed)
+        DONE = list_query(:done)
+        FAILED = list_query(:failed)
+        PENDING = list_query(:pending)
+
+        DONE_AFTER = list_query(:done, seek: true)
+        FAILED_AFTER = list_query(:failed, seek: true)
+        PENDING_AFTER = list_query(:pending, seek: true)
       end
     end
   end

data/lib/async/background.rb

@@ -1,12 +1,11 @@
 # frozen_string_literal: true
 
-require 'async'
-require 'async/semaphore'
 require 'console'
 require 'fugit'
 require 'tmpdir'
 
 require_relative 'background/version'
+require_relative 'background/runtime'
 require_relative 'background/clock'
 require_relative 'background/min_heap'
 require_relative 'background/entry'

metadata

@@ -1,31 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: async-background
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Roman Hajdarov
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: async
+  name: console
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: console
+  name: fugit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -39,33 +38,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: fugit
+  name: base64
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
-  name: base64
+  name: async
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :runtime
+        version: '2.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -128,10 +127,11 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '0.5'
-description: A production-grade lightweight scheduler built on top of Async. Single
-  event loop with min-heap timer, skip-overlapping execution, jitter, monotonic clock
-  intervals, semaphore concurrency control, and deterministic worker sharding. Designed
-  for Falcon but works with any Async-based application.
+description: 'A production-grade lightweight background job scheduler built on the
+  Fiber::Scheduler interface itself, not on any one implementation: it runs under
+  Async/Falcon, Itsi, or anything else that installs a scheduler. Single event loop
+  with min-heap timer, skip-overlapping execution, jitter, monotonic clock intervals,
+  semaphore concurrency control, and deterministic worker sharding.'
 email:
 - romnhajdarov@gmail.com
 executables: []
@@ -159,6 +159,12 @@ files:
 - lib/async/background/runner.rb
 - lib/async/background/runner/queue_execution.rb
 - lib/async/background/runner/schedule.rb
+- lib/async/background/runtime.rb
+- lib/async/background/runtime/notification.rb
+- lib/async/background/runtime/semaphore.rb
+- lib/async/background/runtime/task.rb
+- lib/async/background/runtime/task_group.rb
+- lib/async/background/scheduler.rb
 - lib/async/background/version.rb
 - lib/async/background/web.rb
 - lib/async/background/web/app.rb
@@ -183,7 +189,6 @@ metadata:
   source_code_uri: https://github.com/roman-haidarov/async-background
   changelog_uri: https://github.com/roman-haidarov/async-background/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/roman-haidarov/async-background/issues
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -198,8 +203,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
-summary: Lightweight heap-based cron/interval scheduler for Async.
+summary: Lightweight heap-based cron/interval scheduler for any Fiber scheduler.
 test_files: []