async 2.38.1 → 2.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 775f7308b78b3544dca24cb0db4c79bbb952fc6446c25bb77e8edb78ece4a090
-  data.tar.gz: dfbb05706b19dd0b47269d73dc6acb28194ef9ff4b9ce6c9d7e19eb30ccf9170
+  metadata.gz: 1d8427e86e8ab22c81e41dd6e7df7bd79087e3fa72ce786f07ae7b65d9d94545
+  data.tar.gz: 30e9e7e88b211aa21afe844e3f9510b5af39d2b4af1d97710ce533f581b5c57b
 SHA512:
-  metadata.gz: 02f8bb5e3e57798f7af1901ea1b6fdab323a957634f2b8bb644cc5942dc32d5808cbce18eb68953ba6e2e764c861c040705821e690ae3dd09f902f5d9e25e3b5
-  data.tar.gz: fe7e1c8fc1d166a6d8c55b1c1fb56645db4b742c9203392b6fb668ca58d50d65303f2998077363a83078f2ab0fd9429d097ea86d8013eb22a43eb2a275262305
+  metadata.gz: 337694b65547afc0d4c1568a02c0c08d03d0d70a8b2319b9b9a77660ad9f37c82ff3ab49a3856ebee477657df6b254d62e59ca6b31e9312484c02e696deab007
+  data.tar.gz: e9bc3a1a27f9ba9ea6004dee40df9b385d7959c30e7059521805e91d1f64e9ed16bbc0920b4eb3b1dae8a727ab52ed8258f95bb2605e219f311920bf3fe2b031

data/lib/async/barrier.rb

@@ -81,12 +81,17 @@ module Async
 		# Wait for all tasks to complete by invoking {Task#wait} on each waiting task, which may raise an error. As long as the task has completed, it will be removed from the barrier.
 		#
 		# @yields {|task| ...} If a block is given, the unwaited task is yielded. You must invoke {Task#wait} yourself. In addition, you may `break` if you have captured enough results.
+		# @returns [Integer | Nil] The number of tasks which were waited for, or `nil` if there were no tasks to wait for.
 		#
 		# @asynchronous Will wait for tasks to finish executing.
 		def wait
-			while !@tasks.empty?
+			return nil if @tasks.empty?
+			count = 0
+			
+			while true
 				# Wait for a task to finish (we get the task node):
-				return unless waiting = @finished.wait
+				break unless waiting = @finished.wait
+				count += 1
 				
 				# Remove the task as it is now finishing:
 				@tasks.remove?(waiting)
@@ -101,7 +106,11 @@ module Async
 					# Wait for it to either complete or raise an error:
 					task.wait
 				end
+				
+				break if @tasks.empty?
 			end
+			
+			return count
 		end
 		
 		# Cancel all tasks held by the barrier.

data/lib/async/task.rb

@@ -456,6 +456,9 @@ module Async
 		
 		# Finish the current task, moving any children to the parent.
 		def finish!
+			# Break the cycle:
+			@fiber&.async_task = nil
+			
 			# Don't hold references to the fiber or block after the task has finished:
 			@fiber = nil
 			@block = nil # If some how we went directly from initialized to finished.

data/lib/async/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Async
-	VERSION = "2.38.1"
+	VERSION = "2.39.0"
 end

data/readme.md

@@ -35,6 +35,10 @@ Please see the [project documentation](https://socketry.github.io/async/) for mo
 
 Please see the [project releases](https://socketry.github.io/async/releases/index) for all releases.
 
+### v2.39.0
+
+  - `Async::Barrier#wait` now returns the number of tasks that were waited for, or `nil` if there were no tasks to wait for. This provides better feedback about the operation, and allows you to know how many tasks were involved in the wait.
+
 ### v2.38.1
 
   - Fix `Barrier#async` when `parent.async` yields before the child block executes. Previously, `Barrier#wait` could return early and miss tracking the task entirely, because the task had not yet appended itself to the barrier's task list.
@@ -75,10 +79,6 @@ Please see the [project releases](https://socketry.github.io/async/releases/inde
 
   - [`Kernel::Barrier` Convenience Interface](https://socketry.github.io/async/releases/index#kernel::barrier-convenience-interface)
 
-### v2.33.0
-
-  - Introduce `Async::Promise.fulfill` for optional promise resolution.
-
 ## See Also
 
   - [async-http](https://github.com/socketry/async-http) — Asynchronous HTTP client/server.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v2.39.0
+
+  - `Async::Barrier#wait` now returns the number of tasks that were waited for, or `nil` if there were no tasks to wait for. This provides better feedback about the operation, and allows you to know how many tasks were involved in the wait.
+
 ## v2.38.1
 
   - Fix `Barrier#async` when `parent.async` yields before the child block executes. Previously, `Barrier#wait` could return early and miss tracking the task entirely, because the task had not yet appended itself to the barrier's task list.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 2.38.1
+  version: 2.39.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -216,7 +216,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A concurrency framework for Ruby.
 test_files: []