async 2.43.0 → 2.44.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22df54e052923ca32021242839e09cc7150e8d6f63830f697ef43539b68100a0
-  data.tar.gz: 3c0c69d9895f2b053550241d7987892b941d0ba2d6c45e98d30b57daf12bbb93
+  metadata.gz: 0a98ba175586bacb13a3f00ccb770083208e4c8381cbaf17ce4f59fdfc56a85a
+  data.tar.gz: 6a8614f33cbfa4230e66e12750308a1a339d9a2d6fe8a624b015498c5bc60928
 SHA512:
-  metadata.gz: 83b16606c2c1384b38e76dea9ba1b1edbb56009f7088ec35f093df662e3652e7c89eb75a65338216a3ad1d11358fa5f75bb0674fcd5b21339b363beebc86b7c5
-  data.tar.gz: 7a68a7833652d477fb940f9fcc98fccc79d2934be1c0351b08e38bc255bf8c627a277d3475aa63df6c1e850938169feae526e9f9c3feae78af3067f7c74ffb73
+  metadata.gz: 0d3c4cd7e58f0eb601e37ffbf8d415c6b66349f268f2b9bec37ed4a945744409ecdb21f13e101cacba2794ea1dd3e6dd3be7a5cf7ca6cc5e67cd557bd65cd11e
+  data.tar.gz: dc2c1d73dc53df633260e279a20f8cbcb4c40c94b362fc383495e020f750807624c2de5bff446732585b5e2b4121b0ec382de65983db3af23301e937b96b4074

data/context/getting-started.md

@@ -74,6 +74,42 @@ end
 puts "The number was: #{task.wait}"
 ```
 
+### Comparing `Async` and `Sync`
+
+If you are familiar with JavaScript's `async`/`await`, `Async{...}` is similar to calling an asynchronous function: it starts the work and returns a promise-like {ruby Async::Task} that you can wait on later.
+
+```ruby
+task = Async do
+	bar
+end
+
+task.wait # Returns the value of bar.
+```
+
+This is similar to JavaScript code that keeps the promise:
+
+```javascript
+const promise = bar();
+
+await promise; // Returns the value of bar.
+```
+
+`Sync{...}` is similar to immediately awaiting that work: it runs the block in an event loop and returns the block's value directly.
+
+```ruby
+result = Sync do
+	bar
+end
+```
+
+This is similar to:
+
+```javascript
+const result = await bar();
+```
+
+The main difference is that JavaScript starts with an event loop already available, while Ruby code needs one to be provided by a fiber scheduler. `Sync{...}` is the usual way to create or reuse that event loop when the caller wants a direct return value instead of a task.
+
 ## Creating a Fiber Scheduler
 
 The first (top level) async block will also create an instance of {ruby Async::Reactor} which is a subclass of {ruby Async::Scheduler} to handle the event loop. You can also do this directly using {ruby Fiber.set_scheduler}:

data/context/index.yaml

@@ -3,6 +3,8 @@
 ---
 description: A concurrency framework for Ruby.
 metadata:
+  bug_tracker_uri: https://github.com/socketry/async/issues
+  changelog_uri: https://github.com/socketry/async/blob/main/releases.md
   documentation_uri: https://socketry.github.io/async/
   funding_uri: https://github.com/sponsors/ioquatix/
   source_code_uri: https://github.com/socketry/async.git

data/lib/async/condition.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017-2025, by Samuel Williams.
+# Copyright, 2017-2026, by Samuel Williams.
 # Copyright, 2017, by Kent Gruber.
 # Copyright, 2026, by Robert Mosolgo.
 

data/lib/async/scheduler.rb

@@ -685,6 +685,7 @@ module Async
 			@children = nil
 			@selector = nil
 			@timers = nil
+			@blocked = 0
 			
 			# Close the scheduler:
 			Fiber.set_scheduler(nil)

data/lib/async/version.rb

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

data/lib/kernel/async.rb

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

data/lib/kernel/sync.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 # Copyright, 2020, by Brian Morearty.
 # Copyright, 2024, by Patrik Wenger.
 # Copyright, 2025-2026, by Shopify Inc.

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.44.0
+
+  - Fixed scheduler cleanup after forking while other fibers are blocked.
+
 ### v2.43.0
 
   - Propagate cancellation causes through task trees so child tasks observe the original cancellation cause.
@@ -74,10 +78,6 @@ Please see the [project releases](https://socketry.github.io/async/releases/inde
   - Introduce `Task#wait_all` which recursively waits for all children and self, excepting the current task.
   - Introduce `Task#join` as an alias for `Task#wait` for compatibility with `Thread#join` and similar interfaces.
 
-### v2.35.3
-
-  - `Async::Clock` now implements `#as_json` and `#to_json` for nicer log formatting.
-
 ## See Also
 
   - [async-http](https://github.com/socketry/async-http) — Asynchronous HTTP client/server.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v2.44.0
+
+  - Fixed scheduler cleanup after forking while other fibers are blocked.
+
 ## v2.43.0
 
   - Propagate cancellation causes through task trees so child tasks observe the original cancellation cause.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 2.43.0
+  version: 2.44.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -173,6 +173,8 @@ homepage: https://github.com/socketry/async
 licenses:
 - MIT
 metadata:
+  bug_tracker_uri: https://github.com/socketry/async/issues
+  changelog_uri: https://github.com/socketry/async/blob/main/releases.md
   documentation_uri: https://socketry.github.io/async/
   funding_uri: https://github.com/sponsors/ioquatix/
   source_code_uri: https://github.com/socketry/async.git