async-container 0.28.0 → 0.29.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b600b0cd62cf8c6ba832a6022ba2e2aeca1709264b696277fe11055074d36ea3
-  data.tar.gz: 456e1cfb343619036dfb70ac693f302b3a0dc61c0a1e3d698544c5632fabb7f8
+  metadata.gz: 3d92a0a4336ea40b938ef0b8b54c7dd695f8814df486fd7d80064dbb6a131722
+  data.tar.gz: f944972f872903ce0552b72e506888f84ad9dde40c980cbd4893f59019604eef
 SHA512:
-  metadata.gz: e72593aa02a1ad84c7223d178cf6f89bd9dbd8387539a0c77c50bcec9ac03a118a978cc3e87544b850cdeebb6a1d3925ddcee01e3866129cd8a395aae586f056
-  data.tar.gz: 24e370fbd183a791179cb7fbd6089e513bbdf1767af8fc955cf3e6690c937f075a2cb255915172bb46d1dc08d6995595deaf3e6d3fc39cf643a558d21e14bd7d
+  metadata.gz: 8ae6df190c3ea6e654604bc545f07e1b76af03c3ff02dd236997a9c09035c482b060244ba349d831f74138338d72be307b214c292915185035b38de173eb6b98
+  data.tar.gz: 4f7a6913143f38ec54a9f727f3bf1c738d2f7f79bd777a90fd4302689ae0c67c15faf528f1a171387a35a07cd9e168101d928ffe062749d5f0ab71e6b0e1a05f

data/lib/async/container/generic.rb

@@ -91,7 +91,8 @@ module Async
 				@group.running?
 			end
 			
-			# Sleep until some state change occurs.
+			# Sleep until some state change occurs or the specified duration elapses.
+			#
 			# @parameter duration [Numeric] the maximum amount of time to sleep for.
 			def sleep(duration = nil)
 				@group.sleep(duration)
@@ -140,7 +141,7 @@ module Async
 			# Stop the children instances.
 			# @parameter timeout [Boolean | Numeric] Whether to stop gracefully, or a specific timeout.
 			def stop(timeout = true)
-				Console.info(self, "Stopping container...", timeout: timeout, caller: caller_locations)
+				Console.debug(self, "Stopping container...", timeout: timeout)
 				@running = false
 				@group.stop(timeout)
 				

data/lib/async/container/notify/client.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.
 
 module Async
 	module Container
@@ -17,6 +17,12 @@ module Async
 					send(ready: true, **message)
 				end
 				
+				# Notify the parent controller that the child is healthy.
+				# @parameters message [Hash] Additional details to send with the message.
+				def healthy!(**message)
+					send(healthy: true, **message)
+				end
+				
 				# Notify the parent controller that the child is reloading.
 				# @parameters message [Hash] Additional details to send with the message.
 				def reloading!(**message)

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

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2025, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 # Copyright, 2020, by Olle Jonsson.
 
 require "tmpdir"
 require "socket"
 require "securerandom"
+require "set"
 
 module Async
 	module Container
@@ -15,6 +16,20 @@ module Async
 			class Server
 				MAXIMUM_MESSAGE_SIZE = 4096
 				
+				# Fields from the systemd sd_notify protocol that use "0"/"1" for boolean values.
+				# See: https://www.freedesktop.org/software/systemd/man/sd_notify.html
+				BOOLEAN_FIELDS = Set[
+					:ready,
+					:reloading,
+					:stopping,
+					:fdstore,
+					:fdstoreremove,
+					:fdpoll,
+					:barrier,
+					:watchdog, # Note: also accepts "trigger" as a string value.
+					:healthy, # Extension: not in standard systemd protocol.
+				].freeze
+				
 				# Parse a message, according to the `sd_notify` protocol.
 				#
 				# @parameter message [String] The message to parse.
@@ -29,11 +44,15 @@ module Async
 						
 						key = key.downcase.to_sym
 						
-						if value == "0"
-							value = false
-						elsif value == "1"
-							value = true
+						if BOOLEAN_FIELDS.include?(key)
+							# Convert "0"/"1" to boolean for known systemd boolean fields:
+							if value == "0"
+								value = false
+							elsif value == "1"
+								value = true
+							end
 						elsif key == :errno and value =~ /\A\-?\d+\z/
+							# Convert errno to integer:
 							value = Integer(value)
 						end
 						

data/lib/async/container/version.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2025, by Samuel Williams.
+# Copyright, 2017-2026, by Samuel Williams.
 
 module Async
 	module Container
-		VERSION = "0.28.0"
+		VERSION = "0.29.1"
 	end
 end

data/readme.md

@@ -26,6 +26,10 @@ 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.29.0
+
+  - Introduce `Client#healthy!` for sending health check messages.
+
 ### v0.28.0
 
   - Add `startup_timeout` parameter to `spawn` and `run` methods for detecting processes that hang during startup and never become ready.
@@ -65,10 +69,6 @@ Please see the [project releases](https://socketry.github.io/async-container/rel
 
   - Introduce `async:container:notify:log:ready?` task for detecting process readiness.
 
-### v0.24.0
-
-  - Add support for health check failure metrics.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.29.0
+
+  - Introduce `Client#healthy!` for sending health check messages.
+
 ## v0.28.0
 
   - Add `startup_timeout` parameter to `spawn` and `run` methods for detecting processes that hang during startup and never become ready.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-container
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.29.1
 platform: ruby
 authors:
 - Samuel Williams