async-signals 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 969ede7a2ae47c0fe9599becb2508e5c967fae6f9794724441b0c26bb206d94c
-  data.tar.gz: 7498cf8e1e038d238655cfb86d942990d41fa1bd8defde3e31d746c05b7229b1
+  metadata.gz: 8f6e3d24ea8368c2e4dff801e3dc6d284a5e668bf494cfd8c896012832229356
+  data.tar.gz: 40f7897eb02e1fd4e5fb8647bac3e5534ed5ae764aafd0a47b946d04015b5fa4
 SHA512:
-  metadata.gz: 5fa34ee6b5d702e0da640a56654f57c1dee5e3d6190ed37d9d78d5d3ea249d7acba78c5d7ad3c01c7e08cd882ab49b08e4dcbba0bf5e9914218c6fd954df6574
-  data.tar.gz: 9861c7a96dbbd194ccf2243599e77e66bf50b949ce593d0f4b369da238d7e0b6b69aaebbabd25979b2e8187af2a66e692312618f86635ae747d588767bcc8f6e
+  metadata.gz: 27ea87c8781794e16d00e2f9c2b4b0329fcd647355be0b798a949a2d80aedf7ee2a94c3c2b7346543b1885a03e808b1412a04410d5ddfd7f4d82938218980876
+  data.tar.gz: dc8f749f9206d40a2244c0fa22821dee0b2122497db18a83d0d865316bd9b0fd89c147c55120379162a3f0d479c0b4528ff14ffb7cc2ce21938126114f0d43a4

data/lib/async/signals/graceful.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+module Async
+	module Signals
+		# Installs default signal handlers for graceful shutdown.
+		#
+		# Ruby's built-in handling for `SIGINT` can bypass `Thread.handle_interrupt`, which makes graceful shutdown unreliable for event loops and other code that needs to defer interruption while cleaning up. This file also maps `SIGTERM` to `Interrupt`, so both termination signals follow the same graceful shutdown path when they are still using Ruby's default handler.
+		#
+		# See <https://bugs.ruby-lang.org/issues/22133> for more details.
+		module Graceful
+			SIGNALS = ["INT", "TERM"].freeze
+			
+			SIGNALS.each do |signal|
+				previous = ::Signal.trap(signal) do
+					::Thread.main.raise(::Interrupt)
+				end
+				
+				unless previous == "DEFAULT"
+					::Signal.trap(signal, previous)
+				end
+			end
+		end
+	end
+end

data/lib/async/signals/version.rb

@@ -7,6 +7,6 @@
 module Async
 	# @namespace
 	module Signals
-		VERSION = "0.5.0"
+		VERSION = "0.6.0"
 	end
 end

data/readme.md

@@ -24,6 +24,10 @@ Please see the [project documentation](https://socketry.github.io/async-signals/
 
 Please see the [project releases](https://socketry.github.io/async-signals/releases/index) for all releases.
 
+### v0.6.0
+
+  - Add `async/signals/graceful` for installing default `SIGINT` and `SIGTERM` handlers that raise `Interrupt`.
+
 ### v0.5.0
 
   - Change `Async::Signals.default` to select process signal handling only on the main thread when no fiber scheduler is installed.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.6.0
+
+  - Add `async/signals/graceful` for installing default `SIGINT` and `SIGTERM` handlers that raise `Interrupt`.
+
 ## v0.5.0
 
   - Change `Async::Signals.default` to select process signal handling only on the main thread when no fiber scheduler is installed.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-signals
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -49,6 +49,7 @@ files:
 - lib/async/signals.rb
 - lib/async/signals/context.rb
 - lib/async/signals/controller.rb
+- lib/async/signals/graceful.rb
 - lib/async/signals/handlers.rb
 - lib/async/signals/ignore.rb
 - lib/async/signals/version.rb