rm-extensions 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3cf1c7466015bfa9d247a7331ea115b3e2488fe2
-  data.tar.gz: ab4897b30918931ff43d2f78a753b37f2dcce110
+  metadata.gz: 4638058073ecd449cd49a4ae5d0b2c0bcea20304
+  data.tar.gz: fda67c1392046c93f1c7de0c6de830cf68cd733b
 SHA512:
-  metadata.gz: a1dd632b69fe168f2fa6aea6d46966b4658eae245689037b7b45bb08607266af6eb6bac8fcd0937d6fcd871efc0937cfac74b06758731d23a4a05e1e80c9139c
-  data.tar.gz: d259f115de70b69418eb5a1b38ff62a33d33600b9613e9223b7e855e7e814dba03a598324aac0c8fc132972f463fe1af26fbe50ef6e1568b092f4f989ff7fc29
+  metadata.gz: d78724ff4f31f6014c7dc9732cc3a6a80919f3ccc38c0abc2668f51eb21c822b2eafb3e098488a7c12acbb2d708d6b33fca5662ad253c1034d9f34474052263d
+  data.tar.gz: ea9fb77064f3fb6904c8ec56ab0a50fac3f61b23d41dfeeec5d7ee4051442bb869b2c7a53664d0615dbdbe3f2aae6345cea99572b9f8cd4d8de92e16a34f0086

data/lib/motion/util.rb

@@ -90,6 +90,124 @@ module RMExtensions
         true
       end
 
+      # call the block immediately if called on the main thread,
+      # otherwise call it async on the main queue
+      def rmext_inline_or_on_main_q(&block)
+        if NSThread.currentThread.isMainThread
+          block.call
+        else
+          rmext_on_main_q(&block)
+        end
+      end
+
+      # call the block immediately if called on the main thread with the given args,
+      # otherwise call it async on the main queue.
+      # silently ignores nil blocks to avoid if !block.nil? checks, useful for async callbacks
+      # that optionally take a callback
+      def rmext_block_on_main_q(block, *args)
+        unless block.nil?
+          rmext_inline_or_on_main_q do
+            block.call(*args)
+          end
+        end
+      end
+
+      ### EXPERIMENTAL
+
+      # takes a unique_id, run_immediately bool, and block
+      # if run_immediately is true, the block is executed immediately and not counted
+      # on the next run loop, the block will be called IF it has been counted at least once.
+      # examples:
+      #
+      # # CALLED will be printed twice.  Onces immediately, and once on the next runloop:
+      # 10.times do
+      #   rmext_debounce_on_next_runloop(:my_unique_id, true) do
+      #     p "CALLED"
+      #   end
+      # end
+      #
+      # # CALLED will be printed once, on the next runloop:
+      # 10.times do
+      #   rmext_debounce_on_next_runloop(:my_unique_id, false) do
+      #     p "CALLED"
+      #   end
+      # end
+      #
+      # useful for queuing up something that should happen on the next runloop,
+      # but not every time its called.  for example, reloadData.  the goal was
+      # to get a similar behavior to how setNeedsDisplay/setNeedsLayout scheduled
+      # display/layout rendering on the next UI runloop pass
+      #
+      def rmext_debounce_on_next_runloop(unique_id, run_immediately, &block)
+        Thread.current["rmext_debounce_on_next_runloop"] ||= {}
+        lookup = Thread.current["rmext_debounce_on_next_runloop"]
+        if lookup.key?(unique_id)
+          lookup[unique_id][0] += 1
+        else
+          lookup[unique_id] = [ 0, lambda do
+            if (debounced_times = lookup[unique_id][0]) > 0
+              # p "we have", debounced_times, "debounced_times queued for unique_id", unique_id
+              block.call
+            else
+              # p "no debounced_times queued for unique_id", unique_id
+            end
+            lookup.delete(unique_id)
+          end ]
+          if run_immediately
+            block.call
+          else
+            lookup[unique_id][0] += 1
+          end
+          # p NSRunLoop.currentRunLoop, NSRunLoop.currentRunLoop.currentMode, lookup[unique_id][1]
+          NSRunLoop.currentRunLoop.performSelector('call', target:lookup[unique_id][1], argument:nil, order:0, modes:[NSRunLoop.currentRunLoop.currentMode])
+        end
+      end
+
+      def rmext_debounce_selector_on_next_runloop(selector, run_immediately)
+        Thread.current["rmext_debounce_selector_on_next_runloop"] ||= {}
+        lookup = Thread.current["rmext_debounce_selector_on_next_runloop"]
+        if lookup.key?(selector)
+          lookup[selector] += 1
+        else
+          lookup[selector] = 0
+          if run_immediately
+            send(selector)
+          else
+            lookup[selector] += 1
+          end
+          # p NSRunLoop.currentRunLoop, NSRunLoop.currentRunLoop.currentMode, self, selector, lookup[selector]
+          block = lambda do
+            if (debounced_times = lookup[selector]) > 0
+              # p "we have", debounced_times, "debounced_times queued for", self, selector
+              send(selector)
+            else
+              # p "no debounced_times queued for", self, selector
+            end
+            lookup.delete(selector)
+          end
+          NSRunLoop.currentRunLoop.performSelector('call', target:block, argument:nil, order:0, modes:[NSRunLoop.currentRunLoop.currentMode])
+        end
+      end
+
+      # more typical debouncing behavior
+      def rmext_debounced(method_name, seconds, *args)
+        new_method_name = "#{method_name}_#{seconds}"
+        unless respond_to?(new_method_name)
+          self.class.send(:define_method, new_method_name) do |*xargs|
+            xargs.unshift(method_name)
+            send(*xargs)
+          end
+        end
+        args.unshift(new_method_name)
+        NSObject.cancelPreviousPerformRequestsWithTarget(self, selector:"rmext_dispatch__send__", object:args)
+        performSelector("rmext_dispatch__send__", withObject:args, afterDelay:seconds)
+      end
+
+      # used internally by `rmext_debounced`
+      def rmext_dispatch__send__(*args)
+        send(*args)
+      end
+
     end
 
   end

data/lib/rm-extensions/version.rb

@@ -1,3 +1,3 @@
 module RMExtensions
-  VERSION = "0.3.2"
+  VERSION = "0.3.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rm-extensions
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - Joe Noon