async-container 0.31.1 → 0.32.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46675ed8724779375aeccabec88625bb5f404c7f3ace7348c89acd5809133d8f
-  data.tar.gz: 697d47779954d8856ed75be18c60cb4907fc119c3bcbdecdbb95dcf2d6154d12
+  metadata.gz: 77daf5246650362c76300eb71c5cf11459ff18967e273ba5de5ec6da3816a0f7
+  data.tar.gz: 9083168708fbce12c26900c2f4fa725845db8c67d7c94016c48ad3adbbdb5b5b
 SHA512:
-  metadata.gz: e3151ea8a4abeaef64fa4b884587b0d0dd4a85ad8e041d5c912762bde0816ab4415e4f8ed7725f86606923f13e6630810e81ae3d74bfdfe4b92b1575ab8b948c
-  data.tar.gz: 6e07e869a01ecf5039a07de3a9b4a0ae1fce59d0bf498a9faadc3e94d4c3b6dc3bfa049ea166d5efc766e0a3bf4328f7c05f36a685e0acedcf078baa20887315
+  metadata.gz: d293fd77c34c01ca982bdaf3be8f1c8216eed1552364b036782ecd12c259053270e837a95027374c9e8973d590043329bd00b31d1efe33743f0e5bf0e8af89a8
+  data.tar.gz: 7a7073417f66670f9bc686816bfdf35a290f3bc590a9396b1465f6dd1a7c2f27a679145dbbd487c2547ae69d0ae440f65b85a5d7fc63f72cb4cba5df1ea824ed

data/lib/async/container/controller.rb

@@ -24,19 +24,30 @@ 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)
-				@container = nil
+				@notify = notify
 				@container_class = container_class
+				@graceful_stop = graceful_stop
 				
-				@notify = notify
+				@container = nil
 				@signals = {}
 				
 				self.trap(SIGHUP) do
 					self.restart
 				end
-				
-				@graceful_stop = graceful_stop
 			end
 			
+			# The notify client used by the controller.
+			attr :notify
+			
+			# The container class used by the controller.
+			attr :container_class
+			
+			# The graceful stop flag used by the controller.
+			attr :graceful_stop
+			
+			# The current container being managed by the controller.
+			attr :container
+			
 			# The state of the controller.
 			# @returns [String]
 			def state_string
@@ -60,9 +71,6 @@ module Async
 				@signals[signal] = block
 			end
 			
-			# The current container being managed by the controller.
-			attr :container
-			
 			# Create a policy for managing child lifecycle events.
 			# Can be overridden by a sub-class to provide a custom policy.
 			# @returns [Policy] The policy to use for the container.

data/lib/async/container/generic.rb

@@ -271,7 +271,7 @@ module Async
 						
 						# Notify policy of exit (after statistics are updated):
 						begin
-							@policy.child_exit(self, child, status: status, name: name, key: key)
+							@policy.child_exit(self, child, status, name: name, key: key)
 						rescue => error
 							Console.error(self, "Policy error in child_exit!", exception: error)
 						end

data/lib/async/container/policy.rb

@@ -12,7 +12,8 @@ module Async
 			# @parameter child [Child] The child process.
 			# @parameter name [String] The name of the child.
 			# @parameter key [Symbol] An optional key for the child.
-			def child_spawn(container, child, name:, key:)
+			# @parameter options [Hash] Additional options for future extensibility.
+			def child_spawn(container, child, name:, key:, **options)
 			end
 			
 			# Called when a child exits.
@@ -21,7 +22,8 @@ module Async
 			# @parameter status [Process::Status] The exit status.
 			# @parameter name [String] The name of the child.
 			# @parameter key [Symbol] An optional key for the child.
-			def child_exit(container, child, status:, name:, key:)
+			# @parameter options [Hash] Additional options for future extensibility.
+			def child_exit(container, child, status, name:, key:, **options)
 			end
 			
 			# Called when a health check fails.
@@ -30,8 +32,9 @@ module Async
 			# @parameter child [Child] The child process.
 			# @parameter age [Numeric] How long the child has been running.
 			# @parameter timeout [Numeric] The health check timeout that was exceeded.
-			def health_check_failed(container, child, age:, timeout:)
-				Console.warn(container, "Health check failed!", child: child, age: age, timeout: timeout)
+			# @parameter options [Hash] Additional options for future extensibility.
+			def health_check_failed(container, child, age:, timeout:, **options)
+				Console.warn(self, "Health check failed!", child: child, age: age, timeout: timeout)
 				child.kill!
 			end
 			
@@ -41,8 +44,9 @@ module Async
 			# @parameter child [Child] The child process.
 			# @parameter age [Numeric] How long the child has been running.
 			# @parameter timeout [Numeric] The startup timeout that was exceeded.
-			def startup_failed(container, child, age:, timeout:)
-				Console.warn(container, "Startup failed!", child: child, age: age, timeout: timeout)
+			# @parameter options [Hash] Additional options for future extensibility.
+			def startup_failed(container, child, age:, timeout:, **options)
+				Console.warn(self, "Startup failed!", child: child, age: age, timeout: timeout)
 				child.kill!
 			end
 			

data/lib/async/container/statistics.rb

@@ -20,6 +20,9 @@ module Async
 					@last_update = Array.new(@window, 0)
 				end
 				
+				# The time window in seconds for rate calculations.
+				attr :window
+				
 				# Get the current time in seconds.
 				# @returns [Integer] The current monotonic time in seconds.
 				def now

data/lib/async/container/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module Container
-		VERSION = "0.31.1"
+		VERSION = "0.32.1"
 	end
 end

data/readme.md

@@ -28,6 +28,15 @@ 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.32.1
+
+  - Expose `Async::Container::Controller` `#notify`, `#container_class`, and `#graceful_stop` for testing.
+
+### v0.32.0
+
+  - Minor **breaking** changes to `Async::Container::Policy` interface.
+  - Expose `Async::Container::Statistics::Rate#window`.
+
 ### v0.31.0
 
   - Introduce `Async::Container::Policy` for managing child lifecycle events and implementing custom failure handling strategies.
@@ -65,15 +74,6 @@ Please see the [project releases](https://socketry.github.io/async-container/rel
 
   - More logging, especially around failure cases.
 
-### v0.27.1
-
-  - Log caller and timeout when waiting on a child instance to exit, if it blocks.
-
-### v0.27.0
-
-  - Increased default interrupt timeout and terminate timeout to 10 seconds each.
-  - Expose `ASYNC_CONTAINER_INTERRUPT_TIMEOUT` and `ASYNC_CONTAINER_TERMINATE_TIMEOUT` environment variables for configuring default timeouts.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,14 @@
 # Releases
 
+## v0.32.1
+
+  - Expose `Async::Container::Controller` `#notify`, `#container_class`, and `#graceful_stop` for testing.
+
+## v0.32.0
+
+  - Minor **breaking** changes to `Async::Container::Policy` interface.
+  - Expose `Async::Container::Statistics::Rate#window`.
+
 ## v0.31.0
 
   - Introduce `Async::Container::Policy` for managing child lifecycle events and implementing custom failure handling strategies.

metadata

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