opal-async 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc5f4a757a39dabc8a7bc7efcb87631a7dd6809f0fd7da29b5b40ec23d436ea8
-  data.tar.gz: b7c60f66044d9e0f49c2b0a49c18046bccfbd89364fbbdb18d62323cf5351991
+  metadata.gz: bcf44d0cb1a3c702b3c60521a2e173b7a3824fd8a37e80cd0fb18d5c4e0ffc2c
+  data.tar.gz: 28e4364132c94e690752669a3211796ec2b3423314a0db4892348d92fb0beb46
 SHA512:
-  metadata.gz: bc8669beff060d5f91ffad0b6f1ee68d4708124bb5be87d6759eb67ee7c84211c9a6c6a624a73c1eca170ccb305817d13f6472c9c9986c5488b4afbf918929c1
-  data.tar.gz: cf3fe071bb8e549e76e447a5bfd1e28afceb6385a6f005dbef96a8a2b0c77596fbcbeeb05e9901933f151da36d307353dc4c8c13f02fedb39302f2015a2b6d35
+  metadata.gz: 695a85e00e549b7616d7bf120e8651d574c8d42cf58e4483fd7e0a7a36581942836457ad2bdb08a03232217f7bb92434a6fa75cbac217f5498e545186ae66430
+  data.tar.gz: e4a46e19095d1017f93574d52f40a47ff5dfd85b290ce0acb5a885e2500eec44813acdb2f3ea683ef6813711e0f8ccbb4c5beaae0969e3a908e0cb7bd51cf1ab

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## 1.4.0
+
+- Drop `Array#cycle` and `Array#each` overrides and re-implement as `Array#async_cycle` and `Array#async_each`
+- Asynchronous `Kernel#async_loop` alternative to `Kernel#loop`
+
 ## 1.3.0
 
 - Asynchronous `Array#each` method that is web browser event loop friendly

data/README.md

@@ -185,9 +185,9 @@ end
 
 #### Array
 
-The follow `Array` methods have been amended to work asynchronously via `Async::Task` when triggered inside another `Async::Task` (auto-detects it):
-- `Array#cycle`
-- `Array#each`
+The follow `Array` methods have been added to work asynchronously via `Async::Task`:
+- `Array#async_cycle`
+- `Array#async_each`
 
 This makes them not block the web browser event loop, thus allowing other tasks to update the DOM unhindered while running.
 
@@ -197,12 +197,34 @@ Example:
 require 'async/ext/array' # not needed if you called `require 'async/ext'`
 
 Async::Task.new do
-  [1,2,3,4].cycle do |n|
+  [1,2,3,4].async_cycle do |n|
     puts n
     Async::Task.new do
-      # make a DOM update
+      # make a DOM update that is not blocked
     end
-    sleep(1) # this does not block the event loop since it is transparently happening inside an Async::Task
+    sleep(1)
+  end
+end
+```
+
+#### Kernel
+
+The follow `Kernel` method has been added to work asynchronously via `Async::Task`:
+- `Array#async_loop`
+
+This makes it not block the web browser event loop, thus allowing other tasks to update the DOM unhindered while running.
+
+Example:
+
+```ruby
+require 'async/ext/kernel' # not needed if you called `require 'async/ext'`
+
+Async::Task.new do
+  async_loop do
+    Async::Task.new do
+      # make a DOM update that is not blocked
+    end
+    sleep(1)
   end
 end
 ```

data/VERSION

@@ -1 +1 @@
-1.3.0
+1.4.0

data/opal/async/ext.rb

@@ -1,2 +1,3 @@
 require 'async/ext/thread'
 require 'async/ext/array'
+require 'async/ext/kernel'

data/opal/async/ext/array.rb

@@ -1,40 +1,30 @@
 require 'async/task'
 
 class Array
-  alias cycle_without_opal_async cycle
-  def cycle(n=nil, &block)
-    if Async::Task.started? && block_given?
-      array = self * n unless n.nil?
-      index = 0
-      looper = lambda do
-        if n.nil?
-          block.call(self[index])
-          index += 1
-          index = index % self.size
-          Async::Task.new(&looper)
-        else
-          block.call(array.shift)
-          Async::Task.new(&looper) unless array.empty?
-        end
+  def async_cycle(n=nil, &block)
+    array = self * n unless n.nil?
+    index = 0
+    looper = lambda do
+      if n.nil?
+        block.call(self[index])
+        index += 1
+        index = index % self.size
+        Async::Task.new(&looper)
+      else
+        block.call(array.shift)
+        Async::Task.new(&looper) unless array.empty?
       end
-      Async::Task.new(&looper)
-    else
-      cycle_without_opal_async(n, &block)
     end
+    Async::Task.new(&looper)
   end
   
-  alias each_without_opal_async each
-  def each(&block)
-    if Async::Task.started? && block_given?
-      array = self
-      index = 0
-      looper = lambda do
-        block.call(array.shift)
-        Async::Task.new(&looper) unless array.empty?
-      end
-      Async::Task.new(&looper)
-    else
-      each_without_opal_async(&block)
+  def async_each(&block)
+    array = self
+    index = 0
+    looper = lambda do
+      block.call(array.shift)
+      Async::Task.new(&looper) unless array.empty?
     end
+    Async::Task.new(&looper)
   end
 end

data/opal/async/ext/kernel.rb

@@ -0,0 +1,11 @@
+require 'async/task'
+
+module Kernel
+  def async_loop(&block)
+    looper = lambda do
+      block.call
+      Async::Task.new(&looper)
+    end
+    Async::Task.new(&looper)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opal-async
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Ravenstine
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-08-18 00:00:00.000000000 Z
+date: 2021-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opal
@@ -137,6 +137,7 @@ files:
 - opal/async/enumerator.rb
 - opal/async/ext.rb
 - opal/async/ext/array.rb
+- opal/async/ext/kernel.rb
 - opal/async/ext/thread.rb
 - opal/async/interval.rb
 - opal/async/task.rb