async-background 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b409d6d47d2a0fe38a1fdc22c77beb20051563dcd8aa382b394414dc08735a5
-  data.tar.gz: 1bb9c298d88b15369c45abd76555e319d2afb0f5e20895f470af44fe85b0eb18
+  metadata.gz: b412d31294adfc8d7a2586f31f42f47cd0a004e992016615dff81fc1828b7e90
+  data.tar.gz: 3d629e5272bd5f819e8fe2f3ed4507e73b720ce13c71c06433f1d7f3f9e9f563
 SHA512:
-  metadata.gz: 596ea84aeab91edae0d85c8361107fbbcbf431e0f76e11863958b7200db1d16258ae1fe73189f433042faa1fbf59ffe87d1e72484c4ca2da16fd45a23cf307f6
-  data.tar.gz: 3d48231e0018d95a707aff6eceeb569eb85565c251f026afb4b592c418300eeed84cb37c4c655d1520d7bed31d461551cb9be387c73e207912c44a61201059aa
+  metadata.gz: 9eab99f4c978281eea0689a96dfc45b356e82991fc177bf57ab919f688c397d6361f348fc0451c20b45207c124f15106e9b4bd6e637866103830fd64937266a0
+  data.tar.gz: 15b3e8677ec777ae4395d87fbfca81ce9b79fa67d3e2c1b425cbcdac17c12df5f382550a13593f1d71518e0f6ead48e31dd5e474c99634aedc7bea6fa4afe9ba

data/lib/async/background/runner.rb

@@ -12,13 +12,14 @@ module Async
     MAX_JITTER      = 5
 
     class Runner
-      attr_reader :logger, :semaphore, :heap, :worker_index, :total_workers
+      attr_reader :logger, :semaphore, :heap, :worker_index, :total_workers, :shutdown
 
       def initialize(config_path:, job_count: 2, worker_index:, total_workers:)
         @logger        = Console.logger
         @worker_index  = worker_index
         @total_workers = total_workers
         @running       = true
+        @shutdown      = ::Async::Condition.new
 
         logger.info { "Async::Background worker_index=#{worker_index}/#{total_workers}, job_count=#{job_count}" }
 
@@ -28,13 +29,15 @@ module Async
 
       def run
         Async do |task|
-          while true
+          setup_signal_handlers
+
+          loop do
             entry = heap.peek
             break unless entry
 
             now = monotonic_now
             wait = [entry.next_run_at - now, MIN_SLEEP_TIME].max
-            task.sleep wait
+            wait_with_shutdown(task, wait)
             break unless running?
 
             now = monotonic_now
@@ -47,7 +50,7 @@ module Async
                 logger.warn('Async::Background') { "#{entry.name}: skipped, previous run still active" }
               else
                 entry.running = true
-                semaphore.async(parent: task) do
+                semaphore.async do
                   run_job(task, entry)
                 ensure
                   entry.running = false
@@ -59,13 +62,16 @@ module Async
             end
           end
 
-          semaphore.wait
+          semaphore.acquire {}
         end
       end
 
       def stop
+        return unless @running
+
         @running = false
         logger.info { "Async::Background: stopping gracefully" }
+        shutdown.signal
       end
 
       def running?
@@ -74,6 +80,34 @@ module Async
 
       private
 
+      def setup_signal_handlers
+        @signal_r, @signal_w = IO.pipe
+
+        %w[INT TERM].each do |signal|
+          Signal.trap(signal) do
+            @running = false
+            @signal_w.write_nonblock('.') rescue nil
+          end
+        end
+      end
+
+      def wait_with_shutdown(task, duration)
+        timer = task.async(transient: true) do
+          task.sleep duration
+          shutdown.signal
+        end
+
+        watcher = task.async(transient: true) do
+          @signal_r.wait_readable
+          @signal_r.read_nonblock(256) rescue nil
+          shutdown.signal
+        end
+
+        shutdown.wait
+        timer.stop
+        watcher.stop
+      end
+
       def build_heap(config_path)
         raise ConfigError, "Schedule file not found: #{config_path}" unless File.exist?(config_path)
 

data/lib/async/background/version.rb

@@ -2,6 +2,6 @@
 
 module Async
   module Background
-    VERSION = '0.2.3'
+    VERSION = '0.2.5'
   end
 end

data/lib/async/background.rb

@@ -6,14 +6,6 @@ require 'console'
 require 'fugit'
 
 require_relative 'background/version'
-
-# Warn if using an unstable version
-unless ['0.1.0', '0.2.2', '0.2.3'].include?(Async::Background::VERSION)
-  warn "\n⚠️  WARNING: Async::Background v#{Async::Background::VERSION} is not a stable version!"
-  warn "⚠️  Stable versions are: 0.1.0, 0.2.2, and 0.2.3"
-  warn "⚠️  For production use, pin to one of these versions in your Gemfile\n\n"
-end
-
 require_relative 'background/min_heap'
 require_relative 'background/entry'
 require_relative 'background/runner'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: async-background
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.5
 platform: ruby
 authors:
 - Roman Hajdarov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-16 00:00:00.000000000 Z
+date: 2026-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -80,11 +80,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.12'
-description: "[STABLE VERSIONS: 0.1.0, 0.2.2, 0.2.3] 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 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.
 email:
 - romnhajdarov@gmail.com
 executables: []