rm-extensions 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7edd41307de1d5c1e865bbb76ea316389c1a2712
-  data.tar.gz: 382ea7eb32aca95c7d872f948511806d8651bc0b
+  metadata.gz: 3cf1c7466015bfa9d247a7331ea115b3e2488fe2
+  data.tar.gz: ab4897b30918931ff43d2f78a753b37f2dcce110
 SHA512:
-  metadata.gz: e407a9a1676903d3b5e0b87278667257bfba115b54ea7d10e9c83fe05659f868be16fcd25bd582c05b5fd685e6fe4d3779b703f4657accc215697d2f464038df
-  data.tar.gz: 4e201aceefe215907ef2b7c1a25fd34d2ffb8d2167735547dfd38fd2e0e03b8b2937388a9446890d95f384bb794229cfea44b6c59d9b4a43ba7cde5c1597de1e
+  metadata.gz: a1dd632b69fe168f2fa6aea6d46966b4658eae245689037b7b45bb08607266af6eb6bac8fcd0937d6fcd871efc0937cfac74b06758731d23a4a05e1e80c9139c
+  data.tar.gz: d259f115de70b69418eb5a1b38ff62a33d33600b9613e9223b7e855e7e814dba03a598324aac0c8fc132972f463fe1af26fbe50ef6e1568b092f4f989ff7fc29

data/lib/motion/observation.rb

@@ -34,12 +34,29 @@ module RMExtensions
         end
       end
 
-      # register a callback when an event is trigger on this object
+      # register a callback when an event is triggered on this object.
+      #
+      # `inContext` should be passed the object context that the block was originally
+      # created in.  if you are writing the block inline, this would be self.  if
+      # you have a more complicated situation where you are passing the block around as
+      # an argument from another scope or method, you should take care to also keep
+      # track of it's context, so you can pass it correctly here.
+      #
+      # the context is needed to properly manage memory and let the block "drop out"
+      # when it's context deallocates, instead of creating leaks.
+      #
       def rmext_on(event, inContext:context, withBlock:block)
         rmext_observation_proxy.on(event, inContext:context, withBlock:block)
       end
 
+      # register a callback when an event is triggered on this object and remove it after it fires once
+      # see `#rmext_on` for notes about `inContext`
+      def rmext_once(event, inContext:context, withBlock:block)
+        rmext_observation_proxy.once(event, inContext:context, withBlock:block)
+      end
+
       # remove a specific callback for an event on this object
+      # see `#rmext_on` for notes about `inContext`
       def rmext_off(event, inContext:context, withBlock:block)
         if @rmext_observation_proxy
           @rmext_observation_proxy.off(event, inContext:context, withBlock:block)
@@ -225,6 +242,15 @@ module RMExtensions
       nil
     end
 
+    def once(event, inContext:context, withBlock:block)
+      block.weak!
+      once_block = lambda do |opts|
+        off(event, inContext:context, withBlock:once_block)
+        block.call(opts)
+      end
+      on(event, inContext:context, withBlock:once_block)
+    end
+
     def off_all
       @events.removeAllObjects
     end

data/lib/motion/util.rb

@@ -8,6 +8,48 @@ module RMExtensions
     @debug = bool
   end
 
+  # LongTask encapsulates beginBackgroundTaskWithExpirationHandler/endBackgroundTask:
+  #
+  # RMExtensions::BackgroundTask.new("my long task") do |task|
+  #   do_something_long
+  #   task.end!
+  # end
+  #
+  # RMExtensions::BackgroundTask.new("my long task") do |task|
+  #   do_something_long_async do
+  #     # later this long task finishes...
+  #     task.end!
+  #   end
+  # end
+  #
+  class LongTask
+    attr_accessor :bgTask, :desc
+
+    # RMExtensions::BackgroundTask.new("my long task") { |task| task.end! }
+    def initialize(desc=nil, &block)
+      @desc = desc
+      @bgTask = UIApplication.sharedApplication.beginBackgroundTaskWithExpirationHandler(lambda do
+        if ::RMExtensions.debug?
+          p "ERROR: #{self.inspect} #{@desc} didn't call #end! in time!"
+        end
+        UIApplication.sharedApplication.endBackgroundTask(@bgTask)
+      end.weak!)
+      block.call(self)
+      self
+    end
+
+    def end!
+      if ::RMExtensions.debug?
+        p "SUCCESS: #{self.inspect} #{@desc} ended successfully."
+      end
+      if @bgTask != UIBackgroundTaskInvalid
+        UIApplication.sharedApplication.endBackgroundTask(@bgTask)
+        @bgTask = UIBackgroundTaskInvalid
+      end
+    end
+
+  end
+
   module ObjectExtensions
 
     module Util

data/lib/rm-extensions/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rm-extensions
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Joe Noon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-13 00:00:00.000000000 Z
+date: 2014-01-16 00:00:00.000000000 Z
 dependencies: []
 description: Extensions and helpers for dealing with various areas of rubymotion
 email: