core-async 0.2.1 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1361dd8d8fafb99718c6891dc52ec337871557417c924599dbb06eba31bf98bf
-  data.tar.gz: 863a6748e6af4b6d1e79eb73c7e2fb91305a020694262824080de059a4f3b761
+  metadata.gz: ff90fa7ad80389d797bf7890df85843e32a6312eabee3ba15e62ff29eafe8d68
+  data.tar.gz: 60d9229247f2a98fb08eea3961019bb2304dff3d9bb056676647923ea21628af
 SHA512:
-  metadata.gz: e4c7aba95f41c4da1d44c6f395b7c7c849d0162796b43a7a98aa99550edde255f4f0f09e5d22a1230886c2adf63c54deed36e5987a2d2c3776a6bc9624d310b7
-  data.tar.gz: 30a459f1b57bb2dd135bd7417df2775364375f76c5065b91722e23b2c2a94906d0dd3605412aa685b75825b847338860d63016ef1c0a0136e7bd5382b072228a
+  metadata.gz: f4fddf435f4246ef8094317f658064e8e45e6ca8a30257b0bb4b9afea1658d429b0d87daf5a142a695228c1f85c61c5de33a3c0d3414edfa15b1a4504da79ebc
+  data.tar.gz: b888a83b7fba674b0a1e3555295f1052d7044770df9f52bb06f9840160b5f65acfa0383f48bbe045349a950a8624ee4e85f0511c5ed62a7ab60b3dd815d59860

data/CHANGELOG.md

@@ -1,3 +1,37 @@
+## [v0.6.1](https://github.com/metabahn/corerb/releases/tag/2021-05-20.1)
+
+*released on 2021-05-20*
+
+  * `fix` [#29](https://github.com/metabahn/corerb/pull/29) Actually disable the console logger ([bryanp](https://github.com/bryanp))
+
+## [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*

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_LEVEL"] ||= "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/version.rb

@@ -2,7 +2,7 @@
 
 module Core
   module Async
-    VERSION = "0.2.1"
+    VERSION = "0.6.1"
 
     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.1
+  version: 0.6.1
 platform: ruby
 authors:
 - Bryan Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-06 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.