async-container 0.27.7 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e0f77eb0f6eb3e7e8f8971af4d653e5ff2c3243ecc12f8dd06b27ae27e09d45
-  data.tar.gz: 869aaa117d285f6f407b482b5fcd5b3bb19edcba215202d2faefe159195eed38
+  metadata.gz: b600b0cd62cf8c6ba832a6022ba2e2aeca1709264b696277fe11055074d36ea3
+  data.tar.gz: 456e1cfb343619036dfb70ac693f302b3a0dc61c0a1e3d698544c5632fabb7f8
 SHA512:
-  metadata.gz: f1eb59fda7b292a5ca70b15ea0b70af9d6f41551d9a4818f5820dbc9b078f3008d37f646e8cbcdc74428d3c359c9ec9e731b3b0b008a74922f379b700eda32e4
-  data.tar.gz: 301401ff8bcd736d2e41d1816110625ce038ff65b0a675d11e0ec900feb5550c73e6e754af9e5123dd12b692e4980deac1d197cbdad38e3a48213b38dd938171
+  metadata.gz: e72593aa02a1ad84c7223d178cf6f89bd9dbd8387539a0c77c50bcec9ac03a118a978cc3e87544b850cdeebb6a1d3925ddcee01e3866129cd8a395aae586f056
+  data.tar.gz: 24e370fbd183a791179cb7fbd6089e513bbdf1767af8fc955cf3e6690c937f075a2cb255915172bb46d1dc08d6995595deaf3e6d3fc39cf643a558d21e14bd7d

data/lib/async/container/controller.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2025, by Samuel Williams.
+# Copyright, 2018-2026, by Samuel Williams.
 
 require_relative "error"
 require_relative "best"
@@ -160,7 +160,7 @@ module Async
 			def reload
 				@notify&.reloading!
 				
-				Console.info(self) {"Reloading container: #{@container}..."}
+				Console.info(self){"Reloading container: #{@container}..."}
 				
 				begin
 					self.setup(@container)

data/lib/async/container/forked.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2025, by Samuel Williams.
+# Copyright, 2017-2026, by Samuel Williams.
 
 require_relative "error"
 
@@ -101,9 +101,9 @@ module Async
 					self.new(**options) do |process|
 						::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)}
-							Signal.trap(:TERM) {::Thread.current.raise(Terminate)}
-							Signal.trap(:HUP) {::Thread.current.raise(Restart)}
+							Signal.trap(:INT){::Thread.current.raise(Interrupt)}
+							Signal.trap(:TERM){::Thread.current.raise(Terminate)}
+							Signal.trap(:HUP){::Thread.current.raise(Restart)}
 							
 							# This could be a configuration option:
 							::Thread.handle_interrupt(SignalException => :immediate) do

data/lib/async/container/generic.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, 2025, by Marc-André Cournoyer.
 
 require "etc"
@@ -163,12 +163,20 @@ module Async
 				child.kill!
 			end
 			
+			protected def startup_failed!(child, age_clock, startup_timeout)
+				Console.warn(self, "Child failed startup!", child: child, age: age_clock.total, startup_timeout: startup_timeout)
+				
+				# If the child has failed the startup, we assume the worst and kill it immediately:
+				child.kill!
+			end
+			
 			# Spawn a child instance into the container.
 			# @parameter name [String] The name of the child instance.
 			# @parameter restart [Boolean] Whether to restart the child instance if it fails.
 			# @parameter key [Symbol] A key used for reloading child instances.
 			# @parameter health_check_timeout [Numeric | Nil] The maximum time a child instance can run without updating its state, before it is terminated as unhealthy.
-			def spawn(name: nil, restart: false, key: nil, health_check_timeout: nil, &block)
+			# @parameter startup_timeout [Numeric | Nil] The maximum time a child instance can run without becoming ready, before it is terminated as unhealthy.
+			def spawn(name: nil, restart: false, key: nil, health_check_timeout: nil, startup_timeout: nil, &block)
 				name ||= UNNAMED
 				
 				if mark?(key)
@@ -187,8 +195,8 @@ module Async
 						
 						Console.debug(self, "Started child.", child: child, spawn: {key: key, restart: restart, health_check_timeout: health_check_timeout}, statistics: @statistics)
 						
-						# If a health check is specified, we will monitor the child process and terminate it if it does not update its state within the specified time.
-						if health_check_timeout
+						# If a health check or startup timeout is specified, we will monitor the child process and terminate it if it does not update its state within the specified time.
+						if health_check_timeout || startup_timeout
 							age_clock = state[:age] = Clock.start
 						end
 						
@@ -198,12 +206,28 @@ module Async
 							status = @group.wait_for(child) do |message|
 								case message
 								when :health_check!
-									if health_check_timeout&.<(age_clock.total)
-										health_check_failed!(child, age_clock, health_check_timeout)
+									if state[:ready]
+										# If a health check timeout is specified, we will monitor the child process and terminate it if it does not update its state within the specified time.
+										if health_check_timeout
+											if health_check_timeout < age_clock.total
+												health_check_failed!(child, age_clock, health_check_timeout)
+											end
+										end
+									else
+										# If a startup timeout is specified, we will monitor the child process and terminate it if it does not become ready within the specified time.
+										if startup_timeout
+											if startup_timeout < age_clock.total
+												startup_failed!(child, age_clock, startup_timeout)
+											end
+										end
 									end
 								else
 									state.update(message)
-									age_clock&.reset!
+									
+									# Reset the age clock if the child has become ready:
+									if state[:ready]
+										age_clock&.reset!
+									end
 								end
 							end
 						rescue => error

data/lib/async/container/notify/console.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
 require_relative "client"
 
@@ -25,7 +25,7 @@ module Async
 				
 				# Send a message to the console.
 				def send(level: :info, **message)
-					@logger.public_send(level, self) {message}
+					@logger.public_send(level, self){message}
 				end
 				
 				# Send an error message to the console.

data/lib/async/container/notify/pipe.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2025, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 # Copyright, 2020, by Juan Antonio Martín Lucas.
 
 require_relative "client"
@@ -22,7 +22,7 @@ module Async
 						self.new(::IO.for_fd(descriptor.to_i))
 					end
 				rescue Errno::EBADF => error
-					Console.error(self) {error}
+					Console.error(self){error}
 					
 					return nil
 				end

data/lib/async/container/threaded.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2025, by Samuel Williams.
+# Copyright, 2017-2026, by Samuel Williams.
 
 require_relative "generic"
 require_relative "channel"
@@ -274,7 +274,7 @@ module Async
 				# Invoked by the @waiter thread to indicate the outcome of the child thread.
 				def finished(error = nil)
 					if error
-						Console.error(self) {error}
+						Console.error(self){error}
 					end
 					
 					@status ||= Status.new(error)

data/lib/async/container/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module Container
-		VERSION = "0.27.7"
+		VERSION = "0.28.0"
 	end
 end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2017-2025, by Samuel Williams.  
+Copyright, 2017-2026, by Samuel Williams.  
 Copyright, 2019, by Yuji Yaginuma.  
 Copyright, 2020, by Olle Jonsson.  
 Copyright, 2020, by Juan Antonio Martín Lucas.  

data/readme.md

@@ -26,6 +26,11 @@ 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.28.0
+
+  - Add `startup_timeout` parameter to `spawn` and `run` methods for detecting processes that hang during startup and never become ready.
+  - Health check timeout now only applies after a process becomes ready, preventing premature timeouts for slow-starting applications.
+
 ### v0.27.5
 
   - Make the child handling more robust in the face of exceptions.
@@ -64,10 +69,6 @@ Please see the [project releases](https://socketry.github.io/async-container/rel
 
   - Add support for health check failure metrics.
 
-### v0.23.0
-
-  - [Add support for `NOTIFY_LOG` for Kubernetes readiness probes.](https://socketry.github.io/async-container/releases/index#add-support-for-notify_log-for-kubernetes-readiness-probes.)
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,10 @@
 # Releases
 
+## v0.28.0
+
+  - Add `startup_timeout` parameter to `spawn` and `run` methods for detecting processes that hang during startup and never become ready.
+  - Health check timeout now only applies after a process becomes ready, preventing premature timeouts for slow-starting applications.
+
 ## v0.27.5
 
   - Make the child handling more robust in the face of exceptions.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-container
 version: !ruby/object:Gem::Version
-  version: 0.27.7
+  version: 0.28.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -106,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Abstract container-based parallelism using threads and processes where appropriate.
 test_files: []