async-container 0.36.0 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b7c79f742eb9268bd10341606d71dcb98855a5112ba7022d35a38618185c3ea
-  data.tar.gz: 37a766f7e70db3d39ae22af3a4c1e0edfc92470f7d34bc0030791d3f23d8feea
+  metadata.gz: 2afc84589d803bb2b4205a0da9397039659626c90e88b6b530cba4e1f1e51414
+  data.tar.gz: 8f1d086baf92d980511ed2f7ce1e165a32bd92aec8302673ee67489200e87519
 SHA512:
-  metadata.gz: 6d538e1db3f7483707fb77b7012b293eb51e89ae7c25be6f8af738e0e5ae0f43528c2e437a322f1180fe12425560280341428e5b4264eeacda2396766b687c46
-  data.tar.gz: 2f405c30b3037e15c132e390bb3df865a2bfbe191d665511d9321c4ef0777245ef6146f914134addfece8fc0b279f194621bfd70c1952738b0c6e5bb461ecac8
+  metadata.gz: 8c3bf95bc47ca93403e14f6c517f77f1b7c48f033d63e451fd6ee7f731b793d6220cff578cda76446055badb75281ea9517f3da26c4abae4cb49e6a87a275e5b
+  data.tar.gz: ca937e711802c41d6f397d02e267308b5123385369e739b52fd6cda74aca3f3a4af1f9d0d12643759ee325db76e8247f6fd1b35741b4b592200086dfc5f22c90

data/lib/async/container/controller.rb

@@ -12,6 +12,18 @@ require_relative "policy"
 
 module Async
 	module Container
+		# The default graceful stop policy for controllers.
+		GRACEFUL_STOP = ENV.fetch("ASYNC_CONTAINER_GRACEFUL_STOP", "true").then do |value|
+			case value
+			when "true"
+				true # Default timeout for graceful termination.
+			when "false"
+				false # Immediately kill the processes.
+			else
+				value.to_f
+			end
+		end
+		
 		# Manages the life-cycle of one or more containers in order to support a persistent system.
 		# e.g. a web server, job server or some other long running system.
 		class Controller
@@ -23,7 +35,7 @@ module Async
 			
 			# Initialize the controller.
 			# @parameter notify [Notify::Client] A client used for process readiness notifications.
-			def initialize(notify: Notify.open!, container_class: Container, graceful_stop: true)
+			def initialize(notify: Notify.open!, container_class: Container, graceful_stop: GRACEFUL_STOP)
 				@notify = notify
 				@container_class = container_class
 				@graceful_stop = graceful_stop

data/lib/async/container/forked.rb

@@ -101,7 +101,8 @@ module Async
 				def self.fork(**options)
 					# $stderr.puts fork: caller
 					self.new(**options) do |process|
-						::Thread.new do
+						# CRuby makes the currently executing fiber the root fiber in the child process and clears its resuming fiber, so the caller's stack can be collected without forking from a separate native thread:
+						::Fiber.new(blocking: true) do
 							::Process.fork do
 								# We use `Thread.current.raise(...)` so that exceptions are filtered through `Thread.handle_interrupt` correctly.
 								Signal.trap(:INT){::Thread.current.raise(Interrupt)}
@@ -119,7 +120,7 @@ module Async
 									exit!(1)
 								end
 							end
-						end.value
+						end.resume
 					end
 				end
 				

data/lib/async/container/group.rb

@@ -10,19 +10,7 @@ require_relative "error"
 
 module Async
 	module Container
-		# The default timeout for terminating processes, before escalating to killing.
-		GRACEFUL_TIMEOUT = ENV.fetch("ASYNC_CONTAINER_GRACEFUL_TIMEOUT", "true").then do |value|
-			case value
-			when "true"
-				true # Default timeout for graceful termination.
-			when "false"
-				false # Immediately kill the processes.
-			else
-				value.to_f
-			end
-		end
-		
-		# The default timeout for graceful termination.
+		# The default timeout for graceful termination, used when the `graceful` argument is true.
 		DEFAULT_GRACEFUL_TIMEOUT = 10.0
 		
 		# Manages a group of running processes.
@@ -163,7 +151,7 @@ module Async
 			# If `graceful` is false, skip the SIGINT phase and go directly to SIGKILL.
 			#
 			# @parameter graceful [Boolean | Numeric] Whether to send SIGINT first or skip directly to SIGKILL.
-			def stop(graceful = GRACEFUL_TIMEOUT)
+			def stop(graceful = true)
 				Console.debug(self, "Stopping all processes...", graceful: graceful)
 				
 				# If a timeout is specified, interrupt the children first:

data/lib/async/container/hybrid.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 # Copyright, 2022, by Anton Sozontov.
 
 require_relative "forked"

data/lib/async/container/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module Container
-		VERSION = "0.36.0"
+		VERSION = "0.38.0"
 	end
 end

data/readme.md

@@ -28,6 +28,14 @@ Please see the [project documentation](https://socketry.github.io/async-containe
 
 Please see the [project releases](https://socketry.github.io/async-container/releases/index) for all releases.
 
+### v0.38.0
+
+  - Fork child processes from a clean fiber stack rather than a short-lived native thread, preserving child garbage collection while improving compatibility with native libraries.
+
+### v0.37.0
+
+  - Rename `ASYNC_CONTAINER_GRACEFUL_TIMEOUT` to `ASYNC_CONTAINER_GRACEFUL_STOP` and apply it at the controller level as `GRACEFUL_STOP`. `Group#stop` now only applies the shutdown policy it is given.
+
 ### v0.36.0
 
   - Forked containers now fork child processes from a short-lived thread, reducing inherited scheduler and parent stack state in children.
@@ -60,14 +68,6 @@ Please see the [project releases](https://socketry.github.io/async-container/rel
 
   - Add `Async::Container::Generic#stopping?` so that policies can more accurately track the state of the container.
 
-### v0.33.0
-
-  - Add `Policy#make_statistics` to allow policies to customize statistics initialization.
-
-### v0.32.1
-
-  - Expose `Async::Container::Controller` `#notify`, `#container_class`, and `#graceful_stop` for testing.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.38.0
+
+  - Fork child processes from a clean fiber stack rather than a short-lived native thread, preserving child garbage collection while improving compatibility with native libraries.
+
+## v0.37.0
+
+  - Rename `ASYNC_CONTAINER_GRACEFUL_TIMEOUT` to `ASYNC_CONTAINER_GRACEFUL_STOP` and apply it at the controller level as `GRACEFUL_STOP`. `Group#stop` now only applies the shutdown policy it is given.
+
 ## v0.36.0
 
   - Forked containers now fork child processes from a short-lived thread, reducing inherited scheduler and parent stack state in children.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-container
 version: !ruby/object:Gem::Version
-  version: 0.36.0
+  version: 0.38.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -49,14 +49,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.22'
+        version: '2.44'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.22'
+        version: '2.44'
 executables: []
 extensions: []
 extra_rdoc_files: []