async 2.38.0 → 2.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 847417a49140235dad0d6e2b063dd6a3465247cb7b3000708d58bd01adbcffb1
-  data.tar.gz: f79a5b29cd8e10bdfe7f10ba24f0fb850bb0856e8612dffcecdd7882c133bc61
+  metadata.gz: 1d8427e86e8ab22c81e41dd6e7df7bd79087e3fa72ce786f07ae7b65d9d94545
+  data.tar.gz: 30e9e7e88b211aa21afe844e3f9510b5af39d2b4af1d97710ce533f581b5c57b
 SHA512:
-  metadata.gz: c0b69a0ff96474b52956268018bf8a08aa147aff8c0c80c60185cd070f7d3d36360f3b9f2f8ae1d082a0ee8d4fc172621323bd1e99de5a8ea946f7263761e120
-  data.tar.gz: 80c5f6e6e946b3675ad55cc40ae30ff860aeb08dd732a5d87e2350a4c6ac48d6619c434900e39f9012a76d398930debb56c8d183ef9e139a62138b060a0b24bc
+  metadata.gz: 337694b65547afc0d4c1568a02c0c08d03d0d70a8b2319b9b9a77660ad9f37c82ff3ab49a3856ebee477657df6b254d62e59ca6b31e9312484c02e696deab007
+  data.tar.gz: e9bc3a1a27f9ba9ea6004dee40df9b385d7959c30e7059521805e91d1f64e9ed16bbc0920b4eb3b1dae8a727ab52ed8258f95bb2605e219f311920bf3fe2b031

data/lib/async/barrier.rb

@@ -2,6 +2,7 @@
 
 # Released under the MIT License.
 # Copyright, 2019-2026, by Samuel Williams.
+# Copyright, 2026, by Tavian Barnes.
 
 require_relative "list"
 require_relative "task"
@@ -18,6 +19,7 @@ module Async
 		def initialize(parent: nil)
 			@tasks = List.new
 			@finished = Queue.new
+			@condition = Condition.new
 			
 			@parent = parent
 		end
@@ -42,18 +44,32 @@ module Async
 		
 		# Execute a child task and add it to the barrier.
 		# @asynchronous Executes the given block concurrently.
+		# @returns [Task] The task which was created to execute the block.
 		def async(*arguments, parent: (@parent or Task.current), **options, &block)
 			raise "Barrier is stopped!" if @finished.closed?
 			
 			waiting = nil
 			
-			parent.async(*arguments, **options) do |task, *arguments|
-				waiting = TaskNode.new(task)
-				@tasks.append(waiting)
+			task = parent.async(*arguments, **options) do |task, *arguments|
+				# Create a new list node for the task and add it to the list of waiting tasks:
+				node = TaskNode.new(task)
+				@tasks.append(node)
+				
+				# Signal the outer async block that we have added the task to the list of waiting tasks, and that it can now wait for it to finish:
+				waiting = node
+				@condition.signal
+				
+				# Invoke the block, which may raise an error. If it does, we will still signal that the task has finished:
 				block.call(task, *arguments)
 			ensure
-				@finished.signal(waiting) unless @finished.closed?
+				# Signal that the task has finished, which will unblock the waiting task:
+				@finished.signal(node) unless @finished.closed?
 			end
+			
+			# `parent.async` may yield before the child block executes, so we wait here until the child has appended itself to `@tasks`, ensuring `wait` cannot return early and miss tracking it:
+			@condition.wait while waiting.nil?
+			
+			return task
 		end
 		
 		# Whether there are any tasks being held by the barrier.
@@ -65,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)
@@ -85,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.0"
+	VERSION = "2.39.0"
 end

data/license.md

@@ -35,6 +35,7 @@ Copyright, 2025-2026, by Shopify Inc.
 Copyright, 2025, by Josh Teeter.  
 Copyright, 2025, by Jatin Goyal.  
 Copyright, 2025, by Yuhi Sato.  
+Copyright, 2026, by Tavian Barnes.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -35,6 +35,14 @@ 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.
+
 ### v2.38.0
 
   - Rename `Task#stop` to `Task#cancel` for better clarity and consistency with common concurrency terminology. The old `stop` method is still available as an alias for backward compatibility, but it is recommended to use `cancel` going forward.
@@ -71,14 +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.
-
-### v2.32.1
-
-  - Fix typo in documentation.
-
 ## See Also
 
   - [async-http](https://github.com/socketry/async-http) — Asynchronous HTTP client/server.

data/releases.md

@@ -1,5 +1,13 @@
 # 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.
+
 ## v2.38.0
 
   - Rename `Task#stop` to `Task#cancel` for better clarity and consistency with common concurrency terminology. The old `stop` method is still available as an alias for backward compatibility, but it is recommended to use `cancel` going forward.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 2.38.0
+  version: 2.39.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -37,6 +37,7 @@ authors:
 - Shigeru Nakajima
 - Sokolov Yura
 - Stefan Wrobel
+- Tavian Barnes
 - Trevor Turk
 - Yuhi Sato
 bindir: bin
@@ -215,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: []