elevate 0.3.3 → 0.4.0

data/.gitignore

@@ -4,3 +4,4 @@ pkg
 resources/*.nib
 resources/*.momd
 resources/*.storyboardc
+.rvmrc

data/.travis.yml

@@ -0,0 +1 @@
+language: objective-c

data/Gemfile

@@ -1,3 +1,3 @@
-source :rubygems
+source 'https://rubygems.org'
 
 gemspec

data/Gemfile.lock

@@ -1,10 +1,10 @@
 PATH
   remote: .
   specs:
-    elevate (0.3.3)
+    elevate (0.4.0)
 
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
     coderay (1.0.8)
     guard (1.6.2)

data/README.md

@@ -1,111 +1,77 @@
-Elevate
+Elevate  [![Code Climate](https://codeclimate.com/github/mattgreen/elevate.png)](https://codeclimate.com/github/mattgreen/elevate)
 ======
-How do we convey the intent of our application?
 
-**Status:** beta quality. Feedback desired!
-
- [![Code Climate](https://codeclimate.com/github/mattgreen/elevate.png)](https://codeclimate.com/github/mattgreen/elevate)
-
-
-Background
------------
-iOS applications employ the MVC architecture to delineate responsibilities:
-
-* Models represent the entities important to our app
-* Views display those entities
-* Controllers react to user input, adjusting the model
-
-However, iOS view controllers seem to attract complexity: not only do they coordinate models, but they also coordinate boundary objects (persistence mechanisms, backend APIs) and view-related concerns. This conflation of responsibilities shrouds the domain logic (that is, what your application does), making it harder to reason about and test. Pure model-related logic can be tested easily on its own, the difficulty arises when models interact with boundaries. Asynchronous behavior only makes it worse.
-
-Elevate posits that the essence of your system are the use cases. They constitute the unique value that your application delivers. Their correctness is too important to be mixed in with presentation-level concerns. This results in a bit more code (one class per use case), but it allows the view controller to be relentlessly focused on view-related concerns.
-
-Extracting use cases into their own class has several benefits:
-
-* Consolidates domain and boundary interactions (read: all non-UI code) to a single conceptual unit
-* Clarifies the intent of the code, both within the view controller and the use case
-* Simplifies IO within the use case, allowing it feel blocking, while remaining interruptible (see below)
-* Eases testing, allow you to employ either mock-based tests or acceptance tests
-
-Implementation
---------------
-Use cases are executed one at a time in a single, global `NSOperationQueue`. Each use case invocation is contained within a `NSOperation` subclass called `ElevateOperation`. `ElevateOperation` sets up an execution environment enabling compliant IO libraries to use traditional blocking control flows, rather than the traditional asynchronous style employed by iOS. Calls may be interrupted by invoking `cancel` on the `ElevateOperation`, triggering a `CancelledError` to be raised within the use case.
-
-The `Elevate::HTTP` module wraps NSURLRequest to work with this control flow. (Unfortunately, most iOS HTTP libraries do not work well with this paradigm.)
+Stop scattering your domain logic across your view controller. Consolidate it to a single conceptual unit with Elevate.
 
 Example
-------------
-Synchronizing data between a remote API and a local DB:
+-------
 
 ```ruby
-class SyncArtists < Action
-  def execute
-    stale_artists.each do |stale_artist|
-      artist = api.get_artist(stale_artist.name)
-      tracked_artists.add(artist)
+@login_task = async username: username.text, password: password.text do
+  task do
+    # This block runs on a background thread.
+    #
+    # The @username and @password instance variables correspond to the args
+    # passed into async. API is a thin wrapper class over Elevate::HTTP,
+    # which blocks until the request returns, yet can be interrupted.
+    credentials = API.login(@username, @password)
+    if credentials
+      UserRegistration.store(credentials.username, credentials.token)
     end
 
-    tracked_artists.all
+    # Return value of block is passed back to on_completed
+    credentials != nil
   end
 
-  private
-  def stale_artists
-    stale = []
-
-    current = api.get_artists()
-    current.each do |artist|
-      if stale?(artist)
-        stale << artist
-      end
-    end
-
-    stale
+  on_started do
+    # This block runs on the UI thread after the operation has been queued.
+    SVProgressHUD.showWithStatus("Logging In...")
   end
 
-  def stale?(artist)
-    existing = tracked_artists.find_by_name(artist.name)
-    if existing.nil?
-      return true
-    end
+  on_completed do |result, exception|
+    # This block runs on the UI thread after the task block has finished.
+    SVProgressHUD.dismiss
 
-    existing.updated_at < artist.updated_at
+    if exception == nil
+      if result
+        alert("Logged in successfully!")
+      else
+        alert("Invalid username/password!")
+      end
+    else
+      alert(exception)
+    end
   end
 end
 ```
 
-Notice the use case (`SyncArtists`) describes the algorithm at a high level. It is not concerned with the UI, and it depends on abstractions. 
+Background
+-----------
+Many iOS apps have fairly simple domain logic that is obscured by several programming 'taxes':
 
-The view controller retains a similar focus. In fact, it is completely ignorant of how the sync algorithm operates. It only knows that it will return a list of artists to display:
+* UI management
+* asynchronous network requests
+* I/O-heavy operations, such as storing large datasets to disk
 
-```ruby
-class ArtistsViewController < UITableViewController
-  include Elevate
+These are necessary to ensure a good user experience, but they splinter your domain logic (that is, what your application does) through your view controller. Gross.
 
-  def artists
-    @artists ||= []
-  end
+Elevate is a mini task queue for your iOS app, much like Resque or Sidekiq. Rather than defining part of an operation to run on the UI thread, and a CPU-intensive portion on a background thread, Elevate is designed so you run the *entire* operation in the background, and receive notifications when it starts and finishes. This has a nice side effect of consolidating all the interaction for a particular task to one place. The UI code is cleanly isolated from the non-UI code. When your tasks become complex, you can elect to extract them out to a service object.
 
-  def artists=(artists)
-    @artists = artists
-    view.reloadData()
-  end
+In a sense, Elevate is almost a control-flow library: it bends the rules of iOS development a bit to ensure that the unique value your application provides is as clear as possible. This is most apparent with how Elevate handles network I/O: it provides a blocking HTTP client built from NSURLRequest for use within your tasks. This lets you write your tasks in a simple, blocking manner, while letting Elevate handle concerns relating to cancellation, and errors. 
 
-  def viewWillAppear(animated)
-    super
+Features
+--------
 
-    async SyncArtists.new do
-      on_completed do |operation|
-        self.artists = operation.result
-      end
-    end
-  end
-end
-```
+* Small, beautiful DSL for describing your tasks
+* Actor-style concurrency
+* Simplifies asynchronous HTTP requests when used with Elevate::HTTP
+* Built atop of NSOperationQueue
 
 Installation
 ------------
 Update your Gemfile:
 
-    gem "elevate", "~> 0.3.0"
+    gem "elevate", "~> 0.4.0"
 
 Bundle:
 
@@ -114,27 +80,6 @@ Bundle:
 Usage
 -----
 
-Write a use case. Use case classes must respond to `execute`. Anything returned from `execute` is made available to the controller callbacks:
-```ruby
-class TrackArtist < Action
-  def initialize(artist_name)
-    @artist_name = artist_name
-  end
-
-  def execute
-    unless registration.completed?
-      user = api.register()
-      registration.save(user)
-    end
-
-    artist = api.track(@artist_name)
-    tracked_artists.add(artist)
-
-    artist
-  end
-end
-```
-
 Include the module in your view controller:
 
 ```ruby
@@ -142,39 +87,50 @@ class ArtistsSearchViewController < UIViewController
   include Elevate
 ```
 
-Execute a use case:
+Launch an async task with the `async` method:
+
+* Pass all the data the task needs to operate (such as credentials or search terms) in to the `async` method.
+* Define a block that contains a `task` block. The `task` block should contain all of your non-UI code. It will be run on a background thread. Any data passed into the `async` method will be available as instance variables, keyed by the provided hash key.
+* Optionally, define `on_started` and `on_completed` blocks to run as the task starts and finishes. These are run in the UI thread, and should contain all of your UI code.
 
 ```ruby
-async TrackArtist.new(artist_name) do
-  on_started do |operation|
-    SVProgressHUD.showWithStatus("Adding...", maskType:SVProgressHUDMaskTypeGradient)
+@track_task = async artist: searchBar.text do
+  task do
+    artist = API.track(@artist)
+    ArtistDB.update(artist)
+  end
+
+  on_started do
+    SVProgressHUD.showWithStatus("Adding...")
   end
 
-  # operation.result contains the return value of #execute
-  # operation.exception contains the raised exception (if any)
-  on_completed do |operation|
-    SVProgressHUD.dismiss()
+  on_completed do |result, exception|
+    SVProgressHUD.dismiss
   end
 end
 ```
 
+To cancel a task (like when the view controller is being dismissed), call `cancel` on the task returned by the `async` method. This causes a `CancelledError` to be raised within the task itself, which is handled by the Elevate runtime. This also prevents any callbacks you have defined from running.
+
+**NOTE: Within tasks, do not access the UI or containing view controller! It is extremely dangerous to do so. You must pass data into the `async` method to use it safely.**
+
+To Do
+-----
+* Need ability to set timeout for tasks
+* More thought on the semantics
+
 Caveats
 ---------
-* **DSL is not finalized**
-* Sending CoreData entities across threads is dangerous
-* The callback DSL is clunky to try to avoid retain issues
 * Must use Elevate's HTTP client instead of other iOS networking libs
 * No way to report progress (idea: `execute` could yield status information via optional block)
 
 Inspiration
 -----------
-* [PoEAA: Transaction Script](http://martinfowler.com/eaaCatalog/transactionScript.html)
-* [The Clean Architecture](http://blog.8thlight.com/uncle-bob/2012/08/13/the-clean-architecture.html)
 * [Hexagonal Architecture](http://alistair.cockburn.us/Hexagonal+architecture)
-* [Architecture: The Lost Years](http://www.youtube.com/watch?v=WpkDN78P884)
 * [Android SDK's AsyncTask](http://developer.android.com/reference/android/os/AsyncTask.html)
 * Go (asynchronous IO done correctly)
 
 License
 ---------
 MIT License
+

data/lib/elevate/api.rb

@@ -1,6 +1,6 @@
 module Elevate
-  def async(target, &block)
-    with_operation(target, block) do |operation|
+  def async(args = {}, &block)
+    with_operation(args, block) do |operation|
       queue.addOperation(operation)
     end
   end
@@ -16,15 +16,14 @@ module Elevate
     $elevate_queue
   end
 
-  def with_operation(target, dsl_block, &block)
-    operation = ElevateOperation.alloc.initWithTarget(target)
+  def with_operation(args, dsl_block, &block)
+    dsl = DSL.new(&dsl_block)
 
-    if dsl_block
-      dsl = DSL.new(&dsl_block)
+    raise "No task block specified!" unless dsl.task_callback
 
-      operation.on_started  = Callback.new(self, operation, dsl.started_callback)  if dsl.started_callback
-      operation.on_finished = Callback.new(self, operation, dsl.finished_callback) if dsl.finished_callback
-    end
+    operation = ElevateOperation.alloc.initWithTarget(dsl.task_callback, args: args)
+    operation.on_started  = Callback.new(self, dsl.started_callback)  if dsl.started_callback
+    operation.on_finished = Callback.new(self, dsl.finished_callback) if dsl.finished_callback
 
     yield operation
 

data/lib/elevate/callback.rb

@@ -1,13 +1,22 @@
 module Elevate
   class Callback
-    def initialize(context, operation, block)
-      @context = context
-      @operation = operation
+    def initialize(controller, block)
+      @controller = controller
       @block = block
     end
 
-    def call
-      @context.instance_exec(@operation, &@block)
+    def call(*args)
+      if NSThread.isMainThread
+        invoke(*args)
+      else
+        Dispatch::Queue.main.sync { invoke(*args) }
+      end
+    end
+
+    private
+
+    def invoke(*args)
+      @controller.instance_exec(*args, &@block)
     end
   end
 end

data/lib/elevate/dsl.rb

@@ -6,12 +6,23 @@ module Elevate
 
     attr_reader :started_callback
     attr_reader :finished_callback
+    attr_reader :task_callback
+
+    def task(&block)
+      raise "task blocks must accept zero parameters" unless block.arity == 0
+
+      @task_callback = block
+    end
 
     def on_started(&block)
+      raise "on_started blocks must accept zero parameters" unless block.arity == 0
+
       @started_callback = block
     end
 
     def on_completed(&block)
+      raise "on_completed blocks must accept two parameters" unless block.arity == 2
+
       @finished_callback = block
     end
   end

data/lib/elevate/operation.rb

@@ -1,16 +1,32 @@
 module Elevate
+  class Context
+    def initialize(args, &block)
+      metaclass = class << self; self; end
+      metaclass.send(:define_method, :execute, &block)
+
+      args.each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
+    end
+  end
+
   class ElevateOperation < NSOperation
-    def initWithTarget(target)
+    def initWithTarget(target, args:args)
       if init()
-        @target = target
         @coordinator = IOCoordinator.new
-        @dispatcher = Dispatcher.new
+        @target = target
+        @context = Context.new(args, &target)
+        @finished_callback = nil
 
         setCompletionBlock(lambda do
-          @target = nil
-
-          @dispatcher.invoke_finished_callback() unless isCancelled()
-          @dispatcher.dispose()
+          if @finished_callback
+            @finished_callback.call(@result, @exception) unless isCancelled
+          end
+
+          Dispatch::Queue.main.sync do
+            @target = nil
+            @finished_callback = nil
+          end
         end)
       end
 
@@ -18,13 +34,7 @@ module Elevate
     end
 
     def cancel
-      @coordinator.cancel()
-
-      super
-    end
-
-    def dealloc
-      #puts 'dealloc!'
+      @coordinator.cancel
 
       super
     end
@@ -44,18 +54,18 @@ module Elevate
     def main
       log " START: #{inspect}"
 
-      @coordinator.install()
+      @coordinator.install
 
       begin
         unless @coordinator.cancelled?
-          @result = @target.execute
+          @result = @context.execute
         end
 
       rescue Exception => e
         @exception = e
       end
 
-      @coordinator.uninstall()
+      @coordinator.uninstall
 
       log "FINISH: #{inspect}"
     end
@@ -64,11 +74,17 @@ module Elevate
     attr_reader :result
 
     def on_started=(callback)
-      @dispatcher.on_started = callback
+      started_callback = callback
+      started_callback.retain
+
+      Dispatch::Queue.main.async do
+        started_callback.call unless isCancelled
+        started_callback.release
+      end
     end
 
     def on_finished=(callback)
-      @dispatcher.on_finished = callback
+      @finished_callback = callback
     end
   end
 end

data/lib/elevate/version.rb

@@ -1,3 +1,3 @@
 module Elevate
-  VERSION = "0.3.3"
+  VERSION = "0.4.0"
 end

data/spec/api_spec.rb

@@ -6,11 +6,14 @@ end
 
 describe Elevate do
   describe "#async" do
-    it "runs the specified interactor asynchronously" do
+    it "runs the specified task asynchronously" do
+      async do
+        task do
+          true
+        end
 
-      async Target.new() do
-        on_completed do |operation|
-          @called = true
+        on_completed do |result, exception|
+          @called = result
           resume
         end
       end
@@ -19,5 +22,22 @@ describe Elevate do
         @called.should.be.true
       end
     end
+
+    it "passes provided args to the task as instance variables" do
+      async name: "harry" do
+        task do
+          @name
+        end
+
+        on_completed do |name, exception|
+          @result = name
+          resume
+        end
+      end
+
+      wait_max 1.0 do
+        @result.should == "harry"
+      end
+    end
   end
 end

data/spec/callback_spec.rb

@@ -1,12 +1,22 @@
 describe Elevate::Callback do
   describe "#call" do
-    it "invokes the block using instance_*" do
-      callback = Elevate::Callback.new(self, 42, lambda { |v| @value = v })
-      callback.call
+    describe "on the main thread" do
+      it "invokes the block within the provided context" do
+        callback = Elevate::Callback.new(self, lambda { |v| @value = v })
+        callback.call(42)
 
-      @value.should == 42
+        @value.should == 42
+      end
     end
 
+    describe "on a background thread" do
+      it "invokes the block within the provided context on the main thread" do
+        callback = Elevate::Callback.new(self, lambda { @thread = NSThread.currentThread })
+        callback.call
+
+        @thread.should == NSThread.mainThread
+      end
+    end
   end
 end
 

data/spec/dsl_spec.rb

@@ -2,7 +2,7 @@ describe Elevate::DSL do
   describe "#on_started" do
     it "stores the provided block" do
       i = Elevate::DSL.new do
-        on_started { |operation| puts 'hi' }
+        on_started { puts 'hi' }
       end
 
       i.started_callback.should.not.be.nil
@@ -12,7 +12,7 @@ describe Elevate::DSL do
   describe "#on_completed" do
     it "stores the passed block" do
       i = Elevate::DSL.new do
-        on_completed { |o| puts 'hi' }
+        on_completed { |result, exception| puts 'hi' }
       end
 
       i.finished_callback.should.not.be.nil

data/spec/http/activity_indicator_spec.rb

@@ -0,0 +1,44 @@
+describe Elevate::HTTP::ActivityIndicator do
+  before do
+    UIApplication.sharedApplication.setNetworkActivityIndicatorVisible(false)
+
+    @indicator = Elevate::HTTP::ActivityIndicator.new
+  end
+
+  describe ".instance" do
+    it "returns a singleton instance" do
+      instance = Elevate::HTTP::ActivityIndicator.instance
+      instance2 = Elevate::HTTP::ActivityIndicator.instance
+
+      instance.object_id.should == instance2.object_id
+    end
+  end
+
+  describe "#hide" do
+    it "does nothing if it isn't shown" do
+      @indicator.hide
+
+      UIApplication.sharedApplication.isNetworkActivityIndicatorVisible.should.be.false
+    end
+
+    it "hides the indicator only if there are no outstanding show requests" do
+      @indicator.show
+
+      @indicator.show
+      @indicator.hide
+
+      UIApplication.sharedApplication.isNetworkActivityIndicatorVisible.should.be.true
+
+      @indicator.hide
+      UIApplication.sharedApplication.isNetworkActivityIndicatorVisible.should.be.false
+    end
+  end
+
+  describe "#show" do
+    it "shows the activity indicator" do
+      @indicator.show
+
+      UIApplication.sharedApplication.isNetworkActivityIndicatorVisible.should.be.true
+    end
+  end
+end

data/spec/operation_spec.rb

@@ -1,7 +1,7 @@
 describe Elevate::ElevateOperation do
   before do
-    @target = Target.new
-    @operation = Elevate::ElevateOperation.alloc.initWithTarget(@target)
+    @target = lambda { @result }
+    @operation = Elevate::ElevateOperation.alloc.initWithTarget(@target, args: {})
     @queue = NSOperationQueue.alloc.init
   end
 
@@ -18,7 +18,7 @@ describe Elevate::ElevateOperation do
       @lock = NSLock.alloc.init
       @value = []
 
-      @operation.on_started  = lambda do
+      @operation.on_started = lambda do
         @lock.lock()
         if @value == []
           @value << 1
@@ -26,14 +26,14 @@ describe Elevate::ElevateOperation do
         @lock.unlock()
       end
 
-      @operation.on_finished = lambda do
+      @operation.on_finished = lambda do |result, exception|
         @lock.lock()
         if @value == [1]
           @value << 2
         end
         @lock.unlock()
 
-        resume
+        Dispatch::Queue.main.sync { resume }
       end
 
       @queue.addOperation(@operation)
@@ -58,50 +58,21 @@ describe Elevate::ElevateOperation do
 
     describe "when an exception is raised" do
       it "returns the exception" do
-        @target.exception = IndexError.new
+        @target = lambda { raise IndexError }
+        @operation = Elevate::ElevateOperation.alloc.initWithTarget(@target, args: {})
 
         @queue.addOperation(@operation)
         @operation.waitUntilFinished()
 
-        @operation.exception.should == @target.exception
-      end
-    end
-  end
-
-  describe "#main" do
-    describe "when the operation has not been run" do
-      it "invokes the target" do
-        @queue.addOperation(@operation)
-        @operation.waitUntilFinished()
-
-        @target.called.should == 1
-      end
-    end
-
-    describe "when the operation has been cancelled prior to starting" do
-      it "does not invoke the target" do
-        @operation.cancel()
-
-        @queue.addOperation(@operation)
-        @operation.waitUntilFinished()
-
-        @target.called.should == 0
-      end
-    end
-
-    describe "when the operation is running" do
-      it "allows IO to be cancelled" do
-        @queue.addOperation(@operation)
-        @operation.waitUntilFinished()
-
-        @target.io_coordinator.should.not.be.nil
+        @operation.exception.should.not.be.nil
       end
     end
   end
 
   describe "#result" do
     before do
-      @target.result = 42
+      @target = lambda { 42 }
+      @operation = Elevate::ElevateOperation.alloc.initWithTarget(@target, args: {})
     end
 
     describe "before starting the operation" do
@@ -122,7 +93,7 @@ describe Elevate::ElevateOperation do
     end
 
     describe "when the operation has finished" do
-      it "returns the result of the target's #execute method" do
+      it "returns the result of the lambda" do
         @queue.addOperation(@operation)
         @operation.waitUntilFinished()
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elevate
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-22 00:00:00.000000000 Z
+date: 2013-04-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -83,7 +83,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
-- .rvmrc
+- .travis.yml
 - Gemfile
 - Gemfile.lock
 - Guardfile
@@ -95,7 +95,6 @@ files:
 - lib/elevate.rb
 - lib/elevate/api.rb
 - lib/elevate/callback.rb
-- lib/elevate/dispatcher.rb
 - lib/elevate/dsl.rb
 - lib/elevate/http/activity_indicator.rb
 - lib/elevate/http/base64.rb
@@ -111,9 +110,8 @@ files:
 - lib/elevate/version.rb
 - spec/api_spec.rb
 - spec/callback_spec.rb
-- spec/dispatcher_spec.rb
 - spec/dsl_spec.rb
-- spec/helpers/target.rb
+- spec/http/activity_indicator_spec.rb
 - spec/http/http_client_spec.rb
 - spec/http/http_request_spec.rb
 - spec/io_coordinator_spec.rb
@@ -132,7 +130,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 13511162272098335
+      hash: -1464207392655779665
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -141,7 +139,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 13511162272098335
+      hash: -1464207392655779665
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -151,9 +149,8 @@ summary: Distill the essence of your RubyMotion app
 test_files:
 - spec/api_spec.rb
 - spec/callback_spec.rb
-- spec/dispatcher_spec.rb
 - spec/dsl_spec.rb
-- spec/helpers/target.rb
+- spec/http/activity_indicator_spec.rb
 - spec/http/http_client_spec.rb
 - spec/http/http_request_spec.rb
 - spec/io_coordinator_spec.rb

data/.rvmrc

@@ -1,5 +0,0 @@
-rvm ruby-1.9.3-p194@rubymotion --create
-
-[[ -s "config/rvm_env.sh" ]] && . "config/rvm_env.sh"
-[[ -s ".rvm_env" ]] && . ".rvm_env"
-

data/lib/elevate/dispatcher.rb

@@ -1,53 +0,0 @@
-module Elevate
-  class Dispatcher
-    def initialize
-      @on_finished = nil
-      @on_started = nil
-    end
-
-    def dispose
-      return if @on_started.nil? && @on_finished.nil?
-
-      # Callbacks must be released on the main thread, because they may contain a strong
-      # reference to a UIKit component. See "The Deallocation Problem" for more info.
-      unless NSThread.isMainThread
-        self.performSelectorOnMainThread(:dispose, withObject: nil, waitUntilDone: true)
-        return
-      end
-
-      @on_started = nil
-      @on_finished = nil
-    end
-
-    def invoke_finished_callback
-      invoke(:@on_finished)
-    end
-
-    def on_finished=(callback)
-      @on_finished = callback
-    end
-
-    def on_started=(callback)
-      @on_started = callback
-
-      Dispatch::Queue.main.async do
-        invoke(:@on_started)
-      end
-    end
-
-    private
-
-    def invoke(callback_name)
-      unless NSThread.isMainThread
-        self.performSelectorOnMainThread(:"invoke:", withObject: callback_name, waitUntilDone: true)
-        return
-      end
-
-      if callback = instance_variable_get(callback_name)
-        callback.call()
-
-        instance_variable_set(callback_name, nil)
-      end
-    end
-  end
-end

data/spec/dispatcher_spec.rb

@@ -1,40 +0,0 @@
-describe Elevate::Dispatcher do
-  DELAY = 0.2
-
-  before do
-    @dispatcher = Elevate::Dispatcher.new
-  end
-
-  describe "#on_started=" do
-    before do
-      @dispatcher.on_started = lambda { @thread = NSThread.currentThread }
-    end
-
-    after do
-      @thread = nil
-    end
-
-    it "invokes the callback on the main thread" do
-      wait DELAY do
-        @thread.should == NSThread.currentThread
-      end
-    end
-
-    it "does not invoke the callback immediately" do
-      @thread.should.be.nil
-    end
-  end
-
-  describe "#on_finished=" do
-    before do
-      @dispatcher.on_finished = lambda { @thread = NSThread.currentThread }
-      @dispatcher.invoke_finished_callback()
-    end
-
-    it "invokes the callback on the main thread" do
-      wait DELAY do
-        @thread.should == NSThread.currentThread
-      end
-    end
-  end
-end

data/spec/helpers/target.rb

@@ -1,23 +0,0 @@
-class Target
-  attr_reader   :called
-  attr_reader   :io_coordinator
-  attr_accessor :exception
-  attr_accessor :result
-
-  def initialize
-    @called = 0
-    @result = true
-  end
-
-  def execute
-    @io_coordinator = Thread.current[:io_coordinator]
-
-    @called += 1
-
-    if @exception
-      raise @exception
-    end
-
-    @result
-  end
-end