Add bin and edit workflow

bin/gems/async-2.23.0/lib/async/barrier.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2019-2024, by Samuel Williams.
+
+require_relative "list"
+require_relative "task"
+
+module Async
+	# A general purpose synchronisation primitive, which allows one task to wait for a number of other tasks to complete. It can be used in conjunction with {Semaphore}.
+	#
+	# @public Since *Async v1*.
+	class Barrier
+		# Initialize the barrier.
+		# @parameter parent [Task | Semaphore | Nil] The parent for holding any children tasks.
+		# @public Since *Async v1*.
+		def initialize(parent: nil)
+			@tasks = List.new
+			
+			@parent = parent
+		end
+		
+		class TaskNode < List::Node
+			def initialize(task)
+				@task = task
+			end
+			
+			attr :task
+		end
+		
+		private_constant :TaskNode
+		
+		# Number of tasks being held by the barrier.
+		def size
+			@tasks.size
+		end
+		
+		# All tasks which have been invoked into the barrier.
+		attr :tasks
+		
+		# Execute a child task and add it to the barrier.
+		# @asynchronous Executes the given block concurrently.
+		def async(*arguments, parent: (@parent or Task.current), **options, &block)
+			task = parent.async(*arguments, **options, &block)
+			
+			@tasks.append(TaskNode.new(task))
+			
+			return task
+		end
+		
+		# Whether there are any tasks being held by the barrier.
+		# @returns [Boolean]
+		def empty?
+			@tasks.empty?
+		end
+		
+		# 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.
+		# @asynchronous Will wait for tasks to finish executing.
+		def wait
+			@tasks.each do |waiting|
+				task = waiting.task
+				begin
+					task.wait
+				ensure
+					@tasks.remove?(waiting) unless task.alive?
+				end
+			end
+		end
+		
+		# Stop all tasks held by the barrier.
+		# @asynchronous May wait for tasks to finish executing.
+		def stop
+			@tasks.each do |waiting|
+				waiting.task.stop
+			end
+		end
+	end
+end