async 2.42.0 → 2.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4b0d66ab9efdfe8910e6eced080524be096c8f6b82b2d2fb5477f00bdb0a6da
-  data.tar.gz: a35b33bdb575b1c097ccc2fffc3d49eac0ae36054f8bb750d342c21c866961f2
+  metadata.gz: 22df54e052923ca32021242839e09cc7150e8d6f63830f697ef43539b68100a0
+  data.tar.gz: 3c0c69d9895f2b053550241d7987892b941d0ba2d6c45e98d30b57daf12bbb93
 SHA512:
-  metadata.gz: 926c49c93ba5541ee1d3ca5ee3b70024da00f77c71aaf388d604e167f09f664f6e49dc17647ec47ba395f1e9970d36d3e251cc544304caaa2ce37f25617b61f2
-  data.tar.gz: 2a07815c98380ec7fce0d4a262b5b06756d9379eb72d35edf8a46b06cc7fa34fa01ae81ff2aaba99731d75ba0bbd7deafc41744b27fce4d5e67d4d03e5c90c2e
+  metadata.gz: 83b16606c2c1384b38e76dea9ba1b1edbb56009f7088ec35f093df662e3652e7c89eb75a65338216a3ad1d11358fa5f75bb0674fcd5b21339b363beebc86b7c5
+  data.tar.gz: 7a68a7833652d477fb940f9fcc98fccc79d2934be1c0351b08e38bc255bf8c627a277d3475aa63df6c1e850938169feae526e9f9c3feae78af3067f7c74ffb73

data/lib/async/condition.rb

@@ -3,6 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2017-2025, by Samuel Williams.
 # Copyright, 2017, by Kent Gruber.
+# Copyright, 2026, by Robert Mosolgo.
 
 require "fiber"
 require_relative "list"

data/lib/async/node.rb

@@ -5,6 +5,7 @@
 # Copyright, 2017, by Kent Gruber.
 # Copyright, 2022, by Shannon Skipper.
 # Copyright, 2025-2026, by Shopify Inc.
+# Copyright, 2026, by Kyle Tate.
 
 require "fiber/annotation"
 
@@ -283,9 +284,10 @@ module Async
 		# Attempt to cancel the current node immediately, including all non-transient children. Invokes {#stop_children} to cancel all children.
 		#
 		# @parameter later [Boolean] Whether to defer cancelling until some point in the future.
-		def cancel(later = false)
+		# @parameter cause [Exception | Nil] The cause of the cancel operation.
+		def cancel(later = false, cause: $!)
 			# The implementation of this method may defer calling `stop_children`.
-			stop_children(later)
+			stop_children(later, cause: cause)
 		end
 		
 		# Backward compatibility alias for {#cancel}.
@@ -295,9 +297,9 @@ module Async
 		end
 		
 		# Attempt to stop all non-transient children.
-		private def stop_children(later = false)
+		private def stop_children(later = false, cause:)
 			@children&.each do |child|
-				child.cancel(later) unless child.transient?
+				child.cancel(later, cause: cause) unless child.transient?
 			end
 		end
 		

data/lib/async/promise.rb

@@ -3,6 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2025, by Shopify Inc.
 # Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Kyle Tate.
 
 require_relative "error"
 require_relative "deadline"
@@ -98,7 +99,9 @@ module Async
 			end
 			
 			# Wait with deadline tracking:
-			until @resolved
+			loop do
+				break if @resolved
+				
 				# Get remaining time for this wait iteration:
 				remaining = deadline.remaining
 				

data/lib/async/scheduler.rb

@@ -5,6 +5,7 @@
 # Copyright, 2020, by Jun Jiang.
 # Copyright, 2021, by Julien Portalier.
 # Copyright, 2025-2026, by Shopify Inc.
+# Copyright, 2026, by Kyle Tate.
 
 require_relative "clock"
 require_relative "task"
@@ -514,15 +515,19 @@ module Async
 		# Cancel all children, including transient children.
 		#
 		# @public Since *Async v1*.
-		def cancel
+		def cancel(later = false, cause: $!)
+			if @children and !cause
+				cause = Cancel::Cause.for("Cancelling task!")
+			end
+			
 			@children&.each do |child|
-				child.cancel
+				child.cancel(later, cause: cause)
 			end
 		end
 		
 		# Backward compatibility alias for cancel.
-		def stop
-			cancel
+		def stop(...)
+			cancel(...)
 		end
 		
 		# Run the event loop, until the scheduler is interrupted or finished.

data/lib/async/task.rb

@@ -8,6 +8,7 @@
 # Copyright, 2023, by Math Ieu.
 # Copyright, 2025, by Shigeru Nakajima.
 # Copyright, 2025-2026, by Shopify Inc.
+# Copyright, 2026, by Kyle Tate.
 
 require "fiber"
 require "console"
@@ -333,7 +334,7 @@ module Async
 			
 			if self.cancelled?
 				# If the task is already cancelled, a `cancel` state transition re-enters the same state which is a no-op. However, we will also attempt to cancel any running children too. This can happen if the children did not cancel correctly the first time around. Doing this should probably be considered a bug, but it's better to be safe than sorry.
-				return cancelled!
+				return cancelled!(cause)
 			end
 			
 			# If the fiber is alive, we need to cancel it:
@@ -369,7 +370,7 @@ module Async
 				end
 			else
 				# We are not running, but children might be, so transition directly into cancelled state:
-				cancel!
+				cancel!(cause)
 			end
 		end
 		
@@ -479,7 +480,7 @@ module Async
 			@promise.reject(exception)
 		end
 		
-		def cancelled!
+		def cancelled!(cause = $!)
 			# Console.info(self, status:) {"Task #{self} was cancelled with #{@children&.size.inspect} children!"}
 			
 			# Cancel the promise, specify nil here so that no exception is raised when waiting on the promise:
@@ -489,15 +490,16 @@ module Async
 			
 			begin
 				# We are not running, but children might be so we should stop them:
-				stop_children(true)
-			rescue Cancel
+				stop_children(true, cause: cause)
+			rescue Cancel => exception
 				cancelled = true
+				cause ||= exception.cause || exception
 				# If we are cancelling children, and one of them tries to cancel the current task, we should ignore it. We will be cancelled later.
 				retry
 			end
 			
 			if cancelled
-				raise Cancel, "Cancelling current task!"
+				raise Cancel, "Cancelling current task!", cause: cause
 			end
 		end
 		
@@ -505,8 +507,8 @@ module Async
 			cancelled!
 		end
 		
-		def cancel!
-			cancelled!
+		def cancel!(cause = $!)
+			cancelled!(cause)
 			
 			finish!
 		end
@@ -519,8 +521,8 @@ module Async
 			@fiber = Fiber.new(annotation: self.annotation) do
 				begin
 					completed!(yield)
-				rescue Cancel
-					cancelled!
+				rescue Cancel => exception
+					cancelled!(exception.cause || exception)
 				rescue StandardError => error
 					failed!(error)
 				rescue Exception => exception

data/lib/async/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Async
-	VERSION = "2.42.0"
+	VERSION = "2.43.0"
 end

data/lib/kernel/async.rb

@@ -2,6 +2,7 @@
 
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2026, by Shopify Inc.
 
 require_relative "../async/reactor"
 

data/lib/kernel/sync.rb

@@ -4,7 +4,7 @@
 # Copyright, 2019-2025, by Samuel Williams.
 # Copyright, 2020, by Brian Morearty.
 # Copyright, 2024, by Patrik Wenger.
-# Copyright, 2025, by Shopify Inc.
+# Copyright, 2025-2026, by Shopify Inc.
 
 require_relative "../async/reactor"
 

data/license.md

@@ -36,6 +36,8 @@ Copyright, 2025, by Josh Teeter.
 Copyright, 2025, by Jatin Goyal.  
 Copyright, 2025, by Yuhi Sato.  
 Copyright, 2026, by Tavian Barnes.  
+Copyright, 2026, by Robert Mosolgo.  
+Copyright, 2026, by Kyle Tate.  
 
 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,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.43.0
+
+  - Propagate cancellation causes through task trees so child tasks observe the original cancellation cause.
+
 ### v2.42.0
 
   - `Sync` and `Async` can now be invoked from a non-blocking fiber that has no scheduler (e.g. inside an `Enumerator` or a bare `Fiber.new`). Previously this raised `RuntimeError: Running scheduler on non-blocking fiber!`. The reactor is now run within `Fiber.blocking`, so the scheduler always runs on a blocking fiber.
@@ -74,11 +78,6 @@ Please see the [project releases](https://socketry.github.io/async/releases/inde
 
   - `Async::Clock` now implements `#as_json` and `#to_json` for nicer log formatting.
 
-### v2.35.2
-
-  - Improved handling of `Process.fork` on Ruby 4+.
-  - Improve `@promise` state handling in `Task#initialize`, preventing incomplete instances being visible to the scheduler.
-
 ## See Also
 
   - [async-http](https://github.com/socketry/async-http) — Asynchronous HTTP client/server.
@@ -97,6 +96,22 @@ We welcome contributions to this project.
 4.  Push to the branch (`git push origin my-new-feature`).
 5.  Create new Pull Request.
 
+### Running Tests
+
+To run the test suite:
+
+``` shell
+bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` shell
+bundle exec bake gem:release:patch # or minor or major
+```
+
 ### Developer Certificate of Origin
 
 In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v2.43.0
+
+  - Propagate cancellation causes through task trees so child tasks observe the original cancellation cause.
+
 ## v2.42.0
 
   - `Sync` and `Async` can now be invoked from a non-blocking fiber that has no scheduler (e.g. inside an `Enumerator` or a bare `Fiber.new`). Previously this raised `RuntimeError: Running scheduler on non-blocking fiber!`. The reactor is now run within `Fiber.blocking`, so the scheduler always runs on a blocking fiber.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 2.42.0
+  version: 2.43.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -26,11 +26,13 @@ authors:
 - Julien Portalier
 - Jun Jiang
 - Ken Muryoi
+- Kyle Tate
 - Leon Löchner
 - Mark Montroy
 - Masafumi Okura
 - Masayuki Yamamoto
 - Math Ieu
+- Robert Mosolgo
 - Ryan Musgrave
 - Salim Semaoune
 - Shannon Skipper
@@ -115,34 +117,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.11'
-- !ruby/object:Gem::Dependency
-  name: metrics
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.12'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        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: '0.18'
 executables: []
 extensions: []
 extra_rdoc_files: []