core-async 0.2.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36564cdb777065399358b390e554b89b367902f9d065ed3def243a0816b17049
-  data.tar.gz: ec4cb82ad1b7a97d60af94fc4be07aca732f03f9fe5db91367d7628631d79bc7
+  metadata.gz: 32453e0ff3a28813b566b881be5fc88da0143249ac9164a332218a4c94799574
+  data.tar.gz: cb436adf5261d76f982b032996044ac379b1487b8e504a80641cc6c80aa5ba7a
 SHA512:
-  metadata.gz: 7cf03e8b149e9e0d5185d907025fd833c6d63074be1461970862ae138f3f3744e361422068d8bd4e8696f28fe459d65d7f3e2caa153c2b0f5b374f8d550e21da
-  data.tar.gz: 11b9a8ea0a25975bbf9f92ca7b41c1f0db6b2a7ae2ab0a16bbf6d3057d6d6add5875b30b3646e4028747f4eebb8863769fe8403a825c6e5a8a71cd25e677de22
+  metadata.gz: 55253a5d64873e32794e5fa9fbc7497e1db49c99eeb0f673ce4ebdc70f33360ef547d5f676c1f13b3bef1f376493659305d1329753d758e5e3fd9ea0c20794c8
+  data.tar.gz: 80a4872f6d51426a1518f5b904413f5ed6296382a3d508268c04df3011bc7e28feb11f01f9df58e3998bc41db9afc53597a7d117df484f8eba35011aff019ce2

data/CHANGELOG.md

@@ -1,3 +1,37 @@
+## [v0.6.0](https://github.com/metabahn/corerb/releases/tag/2021-05-20)
+
+*released on 2021-05-20*
+
+  * `fix` [#28](https://github.com/metabahn/corerb/pull/28) Turn off the console logger in all contexts ([bryanp](https://github.com/bryanp))
+  * `chg` [#27](https://github.com/metabahn/corerb/pull/27) Propagate throws from async contexts ([bryanp](https://github.com/bryanp))
+
+## [v0.5.0](https://github.com/metabahn/corerb/releases/tag/2021-03-26)
+
+*released on 2021-03-26*
+
+  * `chg` [#25](https://github.com/metabahn/corerb/pull/25) Privatize async behavior ([bryanp](https://github.com/bryanp))
+  * `add` [#24](https://github.com/metabahn/corerb/pull/24) Add Is::Async#cancel ([bryanp](https://github.com/bryanp))
+  * `fix` [#23](https://github.com/metabahn/corerb/pull/23) Improve control flow during async enumeration / collection building ([bryanp](https://github.com/bryanp))
+  * `fix` [#22](https://github.com/metabahn/corerb/pull/22) Expose errors that occur when building a collection ([bryanp](https://github.com/bryanp))
+
+## [v0.4.0](https://github.com/metabahn/corerb/releases/tag/2021-03-17.1)
+
+*released on 2021-03-17*
+
+  * `chg` [#21](https://github.com/metabahn/corerb/pull/21) Cancel async futures without waiting ([bryanp](https://github.com/bryanp))
+
+## [v0.3.0](https://github.com/metabahn/corerb/releases/tag/2021-03-17)
+
+*released on 2021-03-17*
+
+  * `add` [#20](https://github.com/metabahn/corerb/pull/20) Allow futures to be canceled ([bryanp](https://github.com/bryanp))
+
+## [v0.2.1](https://github.com/metabahn/corerb/releases/tag/2021-03-05)
+
+*released on 2021-03-05*
+
+  * `fix` [#18](https://github.com/metabahn/corerb/pull/18) Surface errors that occur in tasks running within an async reactor ([bryanp](https://github.com/bryanp))
+
 ## [v0.2.0](https://github.com/metabahn/corerb/releases/tag/2021-03-05)
 
 *released on 2021-03-05*

data/lib/core/async/bootstrap.rb

@@ -1,4 +1,7 @@
 # frozen_string_literal: true
 
 require "async"
-Console.logger.off!
+
+# Turn the console logger off everywhere.
+#
+ENV["CONSOLE_LOGGER"] ||= "5"

data/lib/core/async/collection.rb

@@ -12,17 +12,26 @@ module Core
         #
         def build(object)
           aware do
+            errored, stopped = false
+
             values = object.map { |value|
+              break if errored || stopped
+
               async do
                 if block_given?
                   yield value
                 else
                   value
                 end
+              rescue LocalJumpError
+                stopped = true
+              rescue => error
+                errored = true
+                raise error
               end
             }
 
-            new(values)
+            new(values) if values
           end
         end
       end

data/lib/core/async/enumerator.rb

@@ -24,20 +24,19 @@ module Core
         end
 
         await do
-          errored = false
+          errored, stopped = false
+
           @object.each do |value|
-            break if errored
-
-            async {
-              begin
-                yield value
-              rescue => error
-                errored = true
-                raise error
-              ensure
-                defer
-              end
-            }
+            break if errored || stopped
+
+            async do
+              yield value
+            rescue LocalJumpError
+              stopped = true
+            rescue => error
+              errored = true
+              raise error
+            end
           end
         end
       end

data/lib/core/async/future.rb

@@ -10,7 +10,7 @@ module Core
         @error = nil
       end
 
-      # [public] Wait on the task to complete, returning self.
+      # [public] Wait on the future to resolve, returning self.
       #
       def wait
         unless @error
@@ -20,6 +20,16 @@ module Core
         self
       end
 
+      # [public] Attempt to cancel the future, returns true if successful.
+      #
+      def cancel
+        if pending?
+          @task.stop
+        end
+
+        self
+      end
+
       # [public] Return the result, blocking until available.
       #
       def result
@@ -30,6 +40,8 @@ module Core
         wait_all(@task)
 
         resolve_value(@task.result)
+      rescue UncaughtThrowError => error
+        throw error.tag, error.value
       rescue => error
         @error = error
 
@@ -68,6 +80,8 @@ module Core
         case @task.status
         when :running
           :pending
+        when :stopped
+          :canceled
         when :failed
           :failed
         when :complete
@@ -91,6 +105,12 @@ module Core
         status == :failed
       end
 
+      # [public] Return `true` if canceled.
+      #
+      def canceled?
+        status == :canceled
+      end
+
       # [public] Return `true` if complete.
       #
       def complete?

data/lib/core/async/reactor.rb

@@ -33,7 +33,9 @@ module Core
           @runnable = ::Async::Reactor.new
 
           @runnable.run {
-            yield self
+            async {
+              yield self
+            }.result
           }.wait
         end
       end

data/lib/core/async/version.rb

@@ -2,7 +2,7 @@
 
 module Core
   module Async
-    VERSION = "0.2.0"
+    VERSION = "0.6.0"
 
     def self.version
       VERSION

data/lib/is/async.rb

@@ -29,7 +29,7 @@ module Is
 
     # [public] Call behavior synchronously but within an async context, waiting on the result.
     #
-    def await
+    private def await
       if (task = ::Async::Task.current?)
         reference = task.async { |current|
           begin
@@ -47,11 +47,13 @@ module Is
           }.result
         }.wait
       end
+    rescue UncaughtThrowError => error
+      throw error.tag, error.value
     end
 
     # [public] Call behavior within an async context without additional nesting.
     #
-    def aware
+    private def aware
       if ::Async::Task.current?
         yield
       else
@@ -63,7 +65,7 @@ module Is
 
     # [public] Sleeps for `seconds` in a proper async context.
     #
-    def sleep(seconds)
+    private def sleep(seconds)
       internal_await do |task|
         task.sleep(seconds)
       end
@@ -73,29 +75,45 @@ module Is
     #
     # Raises `Core::Async::Timeout` if execution exceeds `seconds`.
     #
-    def timeout(seconds, &block)
+    private def timeout(seconds)
       internal_await do |task|
+        timed_task = internal_async {
+          yield
+        }
+
         if seconds && seconds > 0
           task.with_timeout(seconds, Core::Async::Timeout) do
-            yield
+            timed_task.wait
           end
         else
-          yield
+          timed_task.wait
         end
+      ensure
+        timed_task&.stop
       end
+    rescue UncaughtThrowError => error
+      throw error.tag, error.value
     end
 
     # [public] Yields control to allow other fibers to execute.
     #
-    def defer
+    private def defer
       if (task = ::Async::Task.current?)
         task.yield
       end
     end
 
+    # [public] Cancels the current async behavior if in progress.
+    #
+    private def cancel
+      if (task = ::Async::Task.current?)
+        task.stop
+      end
+    end
+
     # [public] Resolves a potential future to a final result.
     #
-    def resolve(value)
+    private def resolve(value)
       case value
       when Core::Async::Future
         value.result

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: core-async
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Bryan Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-05 00:00:00.000000000 Z
+date: 2021-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -54,14 +54,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.7
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.4
+rubygems_version: 3.2.15
 signing_key:
 specification_version: 4
 summary: Makes Ruby objects async-aware.