async-container 0.33.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 540ced6fa47f3b7a289c62b426b58e9bf0269573eec8b886ce3a97748e2050fe
-  data.tar.gz: 188bd801df86b8819989f679e66a4036761a77fe3f438e7121f065cb932c087a
+  metadata.gz: a0502d4a235533958f93fd6b4791479f056e42761394741af2427bfe027055bc
+  data.tar.gz: f4c07612adf5e21c1a7b5e86b0be8410e284f9606dad0daa5a4a3da9a94c7237
 SHA512:
-  metadata.gz: 9da0dde241b6b11e5635e4dc899ea3112b64d789602f5d76a26d7596fad0d63596c8e3ffe7dd209a254ea3b8e27693d2345e9725d86bf3bcb5af5630dedd29bb
-  data.tar.gz: 27db38943290ce92173ec0df1262f8803032f0068ad0ca17c5551d919f5a71d6f555bbc5be9b6d074df9bd23da94da8be042d13d24e4755b606087543167d93b
+  metadata.gz: 1a29ea78a23485e75e30a6e552bc8dcb18b3361844a8346e57eceec6d0db473747240f3c7818c1d6e6ceeb2cf59ac46d0115c11f13a1fded65dcfbfaef2d0d87
+  data.tar.gz: 26bbb632a633a15f18a32bd76ada51524e9671123e5d45f17721fb0a5eda22aa88d851f3b32c27272dfcf52279a2729fca909ba980839557ee50abab7426a3e7

data/lib/async/container/generic.rb

@@ -47,7 +47,7 @@ module Async
 			# @parameter options [Hash] Options passed to the {Group} instance.
 			def initialize(policy: Policy::DEFAULT, **options)
 				@group = Group.new(**options)
-				@running = true
+				@stopping = false
 				
 				@state = {}
 				
@@ -97,6 +97,12 @@ module Async
 				@group.running?
 			end
 			
+			# Whether the container is currently stopping.
+			# @returns [Boolean]
+			def stopping?
+				@stopping
+			end
+			
 			# Sleep until some state change occurs or the specified duration elapses.
 			#
 			# @parameter duration [Numeric] the maximum amount of time to sleep for.
@@ -147,8 +153,13 @@ module Async
 			# Stop the children instances.
 			# @parameter timeout [Boolean | Numeric] Whether to stop gracefully, or a specific timeout.
 			def stop(timeout = true)
+				if @stopping
+					Console.warn(self, "Container is already stopping!")
+					return
+				end
+				
 				Console.info(self, "Stopping container...", timeout: timeout)
-				@running = false
+				@stopping = true
 				@group.stop(timeout)
 				
 				if @group.running?
@@ -160,7 +171,7 @@ module Async
 				Console.error(self, "Error while stopping container!", exception: error)
 				raise
 			ensure
-				@running = true
+				@stopping = false
 			end
 			
 			protected def health_check_failed(child, age_clock, health_check_timeout)
@@ -206,7 +217,7 @@ module Async
 				@statistics.spawn!
 				
 				fiber do
-					while @running
+					until @stopping
 						Console.debug(self, "Starting child...", child: {key: key, name: name, restart: restart, health_check_timeout: health_check_timeout}, statistics: @statistics)
 						
 						child = self.start(name, &block)
@@ -257,16 +268,16 @@ module Async
 								end
 							end
 						rescue => error
-							Console.error(self, "Error during child process management!", exception: error, running: @running)
+							Console.error(self, "Error during child process management!", exception: error, stopping: @stopping)
 						ensure
 							delete(key, child)
 						end
 						
 						if status&.success?
-							Console.debug(self, "Child exited successfully.", status: status, running: @running)
+							Console.debug(self, "Child exited successfully.", status: status, stopping: @stopping)
 						else
 							@statistics.failure!
-							Console.error(self, "Child exited with error!", status: status, running: @running)
+							Console.error(self, "Child exited with error!", status: status, stopping: @stopping)
 						end
 						
 						# Notify policy of exit (after statistics are updated):
@@ -276,7 +287,7 @@ module Async
 							Console.error(self, "Policy error in child_exit!", exception: error)
 						end
 						
-						if restart && @running
+						if restart && !@stopping
 							@statistics.restart!
 						else
 							break

data/lib/async/container/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module Container
-		VERSION = "0.33.0"
+		VERSION = "0.34.0"
 	end
 end

data/readme.md

@@ -28,6 +28,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.34.0
+
+  - 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.
@@ -69,11 +73,6 @@ Please see the [project releases](https://socketry.github.io/async-container/rel
 
   - Fix race condition where `wait_for` could modify `@running` while it was being iterated over (`each_value`) during health checks.
 
-### v0.27.3
-
-  - Add log for starting child, including container statistics.
-  - Don't try to (log) "terminate 0 child processes" if there are none.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.34.0
+
+  - 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.

metadata

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