async 2.44.0 → 2.44.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7ec9caa7a2e151195fa3da29d96fb2fe0f02399b89d17d93eeb7507667596ad
-  data.tar.gz: ed1548c91c789ef1ffbc268a1470cde4f1d1dc1ffed12678825e1d253b0a8d67
+  metadata.gz: 0a98ba175586bacb13a3f00ccb770083208e4c8381cbaf17ce4f59fdfc56a85a
+  data.tar.gz: 6a8614f33cbfa4230e66e12750308a1a339d9a2d6fe8a624b015498c5bc60928
 SHA512:
-  metadata.gz: d8cc76cc2cc6f3a19ce94383b4123e83b9274a3431b9dc2fc71bfff62946ef3dbad0b4c8f4c607b3071d219b5efc73315d589b10e4467c26e60bbd48eb2c6103
-  data.tar.gz: b914c7f81337ce52ae1aadb42b43f0d702c94847ae0052d326ee510a57c87517b957b5c0fd70988d9b08d4d9f061348b93dceaaf194b3d19ab809eb45c0387f7
+  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/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Async
-	VERSION = "2.44.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.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 2.44.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