async 2.17.0 → 2.32.0

metadata

@@ -1,37 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 2.17.0
+  version: 2.32.0
 platform: ruby
 authors:
 - Samuel Williams
+- Shopify Inc.
 - Bruno Sutic
 - Jeremy Jung
 - Olle Jonsson
-- Devin Christensen
 - Patrik Wenger
+- Devin Christensen
 - Emil Tin
 - Jamie McCarthy
 - Kent Gruber
+- Alan Wu
 - Brian Morearty
 - Colin Kelley
 - Dimitar Peychinov
 - Gert Goet
+- Jahfer Husain
+- Jatin Goyal
 - Jiang Jinyang
+- Josh Teeter
 - Julien Portalier
 - Jun Jiang
 - Ken Muryoi
 - Leon Löchner
+- Mark Montroy
 - Masafumi Okura
 - Masayuki Yamamoto
 - Math Ieu
 - Ryan Musgrave
 - Salim Semaoune
 - Shannon Skipper
+- Shigeru Nakajima
 - Sokolov Yura
 - Stefan Wrobel
 - Trevor Turk
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -63,7 +69,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-09-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: console
@@ -71,14 +77,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.26'
+        version: '1.29'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.26'
+        version: '1.29'
 - !ruby/object:Gem::Dependency
   name: fiber-annotation
   requirement: !ruby/object:Gem::Requirement
@@ -99,50 +105,87 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
-    - - ">="
+        version: '1.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: metrics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.6.5
+        version: '0.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
-    - - ">="
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: traces
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.6.5
-description:
-email:
+        version: '0.18'
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- context/best-practices.md
+- context/debugging.md
+- context/getting-started.md
+- context/index.yaml
+- context/scheduler.md
+- context/tasks.md
+- context/thread-safety.md
 - lib/async.rb
 - lib/async/barrier.md
 - lib/async/barrier.rb
 - lib/async/clock.rb
 - lib/async/condition.md
 - lib/async/condition.rb
+- lib/async/console.rb
+- lib/async/deadline.rb
 - lib/async/idler.rb
+- lib/async/limited_queue.rb
 - lib/async/list.rb
 - lib/async/node.rb
 - lib/async/notification.rb
+- lib/async/priority_queue.rb
+- lib/async/promise.rb
 - lib/async/queue.rb
 - lib/async/reactor.rb
 - lib/async/scheduler.rb
 - lib/async/semaphore.md
 - lib/async/semaphore.rb
+- lib/async/stop.rb
 - lib/async/task.md
 - lib/async/task.rb
+- lib/async/timeout.rb
 - lib/async/variable.rb
 - lib/async/version.rb
-- lib/async/waiter.md
 - lib/async/waiter.rb
-- lib/async/wrapper.rb
 - lib/kernel/async.rb
 - lib/kernel/sync.rb
+- lib/metrics/provider/async.rb
+- lib/metrics/provider/async/task.rb
+- lib/traces/provider/async.rb
+- lib/traces/provider/async/barrier.rb
+- lib/traces/provider/async/task.rb
 - license.md
 - readme.md
 - releases.md
@@ -153,7 +196,6 @@ metadata:
   documentation_uri: https://socketry.github.io/async/
   funding_uri: https://github.com/sponsors/ioquatix/
   source_code_uri: https://github.com/socketry/async.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -161,15 +203,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.1
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A concurrency framework for Ruby.
 test_files: []

data/lib/async/waiter.md

@@ -1,50 +0,0 @@
-A synchronization primitive, which allows you to wait for tasks to complete in order of completion. This is useful for implementing a task pool, where you want to wait for the first task to complete, and then cancel the rest.
-
-If you try to wait for more things than you have added, you will deadlock.
-
-## Example
-
-~~~ ruby
-require 'async'
-require 'async/semaphore'
-require 'async/barrier'
-require 'async/waiter'
-
-Sync do
-	barrier = Async::Barrier.new
-	waiter = Async::Waiter.new(parent: barrier)
-	semaphore = Async::Semaphore.new(2, parent: waiter)
-	
-	# Sleep sort the numbers:
-	generator = Async do
-		while true
-			semaphore.async do |task|
-				number = rand(1..10)
-				sleep(number)
-			end
-		end
-	end
-	
-	numbers = []
-	
-	4.times do
-		# Wait for all the numbers to be sorted:
-		numbers << waiter.wait
-	end
-	
-	# Don't generate any more numbers:
-	generator.stop
-	
-	# Stop all tasks which we don't care about:
-	barrier.stop
-	
-	Console.info("Smallest", numbers)
-end
-~~~
-
-### Output
-
-~~~
-0.0s     info: Smallest
-             | [3, 3, 1, 2]
-~~~

data/lib/async/wrapper.rb

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2017-2024, by Samuel Williams.
-# Copyright, 2017, by Kent Gruber.
-
-module Async
-	# Represents an asynchronous IO within a reactor.
-	# @deprecated With no replacement. Prefer native interfaces.
-	class Wrapper
-		# An exception that occurs when the asynchronous operation was cancelled.
-		class Cancelled < StandardError
-		end
-		
-		# @parameter io the native object to wrap.
-		# @parameter reactor [Reactor] the reactor that is managing this wrapper, or not specified, it's looked up by way of {Task.current}.
-		def initialize(io, reactor = nil)
-			@io = io
-			@reactor = reactor
-			
-			@timeout = nil
-		end
-		
-		attr_accessor :reactor
-		
-		# Dup the underlying IO.
-		def dup
-			self.class.new(@io.dup)
-		end
-		
-		# The underlying native `io`.
-		attr :io
-		
-		# Wait for the io to become readable.
-		def wait_readable(timeout = @timeout)
-			@io.to_io.wait_readable(timeout) or raise TimeoutError
-		end
-		
-		# Wait for the io to become writable.
-		def wait_priority(timeout = @timeout)
-			@io.to_io.wait_priority(timeout) or raise TimeoutError
-		end
-		
-		# Wait for the io to become writable.
-		def wait_writable(timeout = @timeout)
-			@io.to_io.wait_writable(timeout) or raise TimeoutError
-		end
-		
-		# Wait fo the io to become either readable or writable.
-		# @parameter duration [Float] timeout after the given duration if not `nil`.
-		def wait_any(timeout = @timeout)
-			@io.to_io.wait(::IO::READABLE|::IO::WRITABLE|::IO::PRIORITY, timeout) or raise TimeoutError
-		end
-		
-		# Close the underlying IO.
-		def close
-			@io.close
-		end
-		
-		# Whether the underlying IO is closed.
-		def closed?
-			@io.closed?
-		end
-	end
-end