async 1.30.0 → 1.30.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5d9fe2eaa3012c11c39abb23dc7482ec2a224123ed4ef4424bb630b50f8d462
-  data.tar.gz: 113adfafc25504e6f330f36dbd46707dc883e197c36d8530f0a58555ac55b8d4
+  metadata.gz: f7bcca0b0eba6eebe85dd32baa0ffd67059bcdb0623416b818182bf779e38809
+  data.tar.gz: 061a086ae31c238f1d2c3d17598400f3efc01a500de746105255f7582b90251c
 SHA512:
-  metadata.gz: 973e99f9ff361ad1cdf62f074fd6897c6691304ea004dae58aece3309fddd713c5921bf02ff42bd748999f18e2ebf172bd1505a8af318e9cb5c70e23a858145c
-  data.tar.gz: 88001bc4a38cd8a7fec4748ee89ee4b779c77eb925ed6e93923807fd57d4bc0227feffe43e54de55056c48b1705c1b551b1d26529525318d70a61986788919c0
+  metadata.gz: 455f569e561177f4f2e11e5f5713c6e04c5b30b54b01e860bca5e84770095b7f80c0d05d6afa7865773fbfb58c4170103a905ce9c3517c08fb9eec32f5a191a9
+  data.tar.gz: b142a77817fcf868fa68f117d68fe05cf3d0ce34329855a2ef19be198924604b366deaa0ac0ec7bcaa151eaf244bb1e521908515aca44b5be1d82f794288f313

data/lib/async/barrier.rb

@@ -50,17 +50,29 @@ module Async
 			@tasks.empty?
 		end
 		
-		# Wait for tasks in FIFO order.
+		# Wait for all tasks.
+		# @asynchronous Will wait for tasks to finish executing.
 		def wait
-			while task = @tasks.shift
-				task.wait
+			# TODO: This would be better with linked list.
+			while @tasks.any?
+				task = @tasks.first
+				
+				begin
+					task.wait
+				ensure
+					# We don't know for sure that the exception was due to the task completion.
+					unless task.running?
+						# Remove the task from the waiting list if it's finished:
+						@tasks.shift if @tasks.first == task
+					end
+				end
 			end
 		end
 		
 		def stop
-			while task = @tasks.shift
-				task.stop
-			end
+			# We have to be careful to avoid enumerating tasks while adding/removing to it:
+			tasks = @tasks.dup
+			tasks.each(&:stop)
 		end
 	end
 end

data/lib/async/condition.rb

@@ -21,7 +21,6 @@
 # THE SOFTWARE.
 
 require 'fiber'
-require 'forwardable'
 require_relative 'node'
 
 module Async

data/lib/async/queue.rb

@@ -42,13 +42,17 @@ module Async
 			@items.empty?
 		end
 		
-		def enqueue(item)
-			@items.push(item)
+		def <<(item)
+			@items << item
 			
 			self.signal unless self.empty?
 		end
 		
-		alias << enqueue
+		def enqueue(*items)
+			@items.concat(items)
+			
+			self.signal unless self.empty?
+		end
 		
 		def dequeue
 			while @items.empty?
@@ -87,7 +91,7 @@ module Async
 			@items.size >= @limit
 		end
 		
-		def enqueue item
+		def <<(item)
 			while limited?
 				@full.wait
 			end
@@ -95,6 +99,19 @@ module Async
 			super
 		end
 		
+		def enqueue *items
+			while !items.empty?
+				while limited?
+					@full.wait
+				end
+				
+				available = @limit - @items.size
+				@items.concat(items.shift(available))
+				
+				self.signal unless self.empty?
+			end
+		end
+		
 		def dequeue
 			item = super
 			

data/lib/async/task.rb

@@ -230,18 +230,19 @@ module Async
 		private
 		
 		# This is a very tricky aspect of tasks to get right. I've modelled it after `Thread` but it's slightly different in that the exception can propagate back up through the reactor. If the user writes code which raises an exception, that exception should always be visible, i.e. cause a failure. If it's not visible, such code fails silently and can be very difficult to debug.
-		# As an explcit choice, the user can start a task which doesn't propagate exceptions. This only applies to `StandardError` and derived tasks. This allows tasks to internally capture their error state which is raised when invoking `Task#result` similar to how `Thread#join` works. This mode makes {ruby Async::Task} behave more like a promise, and you would need to ensure that someone calls `Task#result` otherwise you might miss important errors.
-		def fail!(exception = nil, propagate = true)
+		def fail!(exception = false, propagate = true)
 			@status = :failed
 			@result = exception
 			
-			if propagate
-				raise
-			elsif @finished.nil?
-				# If no one has called wait, we log this as an error:
-				Console.logger.error(self) {$!}
-			else
-				Console.logger.debug(self) {$!}
+			if exception
+				if propagate
+					raise exception
+				elsif @finished.nil?
+					# If no one has called wait, we log this as a warning:
+					Console.logger.warn(self, "Task may have ended with unhandled exception.", exception)
+				else
+					Console.logger.debug(self, exception)
+				end
 			end
 		end
 		

data/lib/async/variable.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'condition'
+
+module Async
+	class Variable
+		def initialize(condition = Condition.new)
+			@condition = condition
+			@value = nil
+		end
+		
+		def resolve(value = true)
+			@value = value
+			condition = @condition
+			@condition = nil
+			
+			self.freeze
+			
+			condition.signal(value)
+		end
+		
+		def resolved?
+			@condition.nil?
+		end
+		
+		def value
+			@condition&.wait
+			return @value
+		end
+		
+		def wait
+			self.value
+		end
+	end
+end

data/lib/async/version.rb

@@ -21,5 +21,5 @@
 # THE SOFTWARE.
 
 module Async
-	VERSION = "1.30.0"
+	VERSION = "1.30.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 1.30.0
+  version: 1.30.3
 platform: ruby
 authors:
 - Samuel Williams
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-21 00:00:00.000000000 Z
+date: 2022-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: console
@@ -156,6 +156,7 @@ files:
 - lib/async/scheduler.rb
 - lib/async/semaphore.rb
 - lib/async/task.rb
+- lib/async/variable.rb
 - lib/async/version.rb
 - lib/async/wrapper.rb
 - lib/kernel/async.rb
@@ -179,7 +180,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: A concurrency framework for Ruby.