elevate 0.3

data/spec/dispatcher_spec.rb

@@ -0,0 +1,40 @@
+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/dsl_spec.rb

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

data/spec/helpers/target.rb

@@ -0,0 +1,23 @@
+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

data/spec/http/http_client_spec.rb

@@ -0,0 +1,40 @@
+describe Elevate::HTTP::HTTPClient do
+  extend WebStub::SpecHelpers
+
+  before do
+    disable_network_access!
+
+    @base_url = "http://www.example.com"
+    @path = "/resource/action"
+    @url = @base_url + @path
+
+    @client = Elevate::HTTP::HTTPClient.new(@base_url)
+  end
+
+  it "issues requests to the complete URL" do
+    stub_request(:get, @url).to_return(status_code: 201)
+
+    @client.get(@path).status_code.should == 201
+  end
+
+  it "appends query parameters to the URL" do
+    stub_request(:get, @url + "?q=help&page=2").to_return(json: { result: 0 })
+
+    @client.get(@path, q: "help", page: 2).body.should == { "result" => 0 }
+  end
+
+  it "decodes JSON responses" do
+    result = { "int" => 42, "string" => "hi", "dict" => { "boolean" => true }, "array" => [1,2,3] }
+    stub_request(:get, @url).to_return(json: result)
+
+    @client.get(@path).body.should == result
+  end
+
+  it "encodes JSON bodies" do
+   stub_request(:post, @url).
+      with(json: { string: "hello", array: [1,2,3] }).
+      to_return(json: { result: true })
+
+    @client.post(@path, { string: "hello", array: [1,2,3] }).body.should == { "result" => true }
+  end
+end

data/spec/http/http_request_spec.rb

@@ -0,0 +1,103 @@
+describe Elevate::HTTP::HTTPRequest do
+  extend WebStub::SpecHelpers
+
+  before do
+    disable_network_access!
+  end
+
+  before do
+    @url = "http://www.example.com/"
+    @body = "hello"
+  end
+
+  it "requires a valid HTTP method" do
+    lambda { Elevate::HTTP::HTTPRequest.new(:invalid, @url) }.should.raise(ArgumentError)
+  end
+
+  it "requires a URL starting with http" do
+    lambda { Elevate::HTTP::HTTPRequest.new(:get, "asdf") }.should.raise(ArgumentError)
+  end
+
+  it "requires the body to be an instance of NSData" do
+    lambda { Elevate::HTTP::HTTPRequest.new(:get, @url, body: @body) }.should.raise(ArgumentError)
+  end
+
+  describe "fulfilling a GET request" do
+    before do
+      stub_request(:get, @url).
+        to_return(body: @body, headers: {"Content-Type" => "text/plain"}, status_code: 201)
+
+      @request = Elevate::HTTP::HTTPRequest.new(:get, @url)
+      @response = @request.response
+    end
+
+    it "response has the correct status code" do
+      @response.status_code.should == 201
+    end
+
+    it "response has the right body" do
+      NSString.alloc.initWithData(@response.body, encoding:NSUTF8StringEncoding).should == @body
+    end
+
+    it "response has the correct headers" do
+      @response.headers.should == { "Content-Type" => "text/plain" }
+    end
+
+    it "response has no errors" do
+      @response.error.should.be.nil
+    end
+  end
+
+  describe "fulfilling a GET request with headers" do
+    before do
+      stub_request(:get, @url).with(headers: { "API-Token" => "abc123" }).to_return(body: @body)
+
+      @request = Elevate::HTTP::HTTPRequest.new(:get, @url, headers: {})
+      @response = @request.response
+    end
+
+    it "includes the headers in the request" do
+      @response.body.should.not.be.nil
+    end
+  end
+
+  describe "fulfilling a POST request with a body" do
+    before do
+      stub_request(:post, @url).with(body: @body).to_return(body: @body)
+    end
+
+    it "sends the body as part of the request" do
+      request = Elevate::HTTP::HTTPRequest.new(:post, @url, body: @body.dataUsingEncoding(NSUTF8StringEncoding))
+      response = request.response
+
+      NSString.alloc.initWithData(response.body, encoding:NSUTF8StringEncoding).should == @body
+    end
+  end
+
+  describe "cancelling a request" do
+    before do
+      stub_request(:get, @url).to_return(body: @body, delay: 1.0)
+    end
+
+    it "aborts the request" do
+      start = Time.now
+
+      request = Elevate::HTTP::HTTPRequest.new(:get, @url)
+      request.start()
+      request.cancel()
+
+      response = request.response # simulate blocking
+      finish = Time.now
+
+      (finish - start).should < 1.0
+    end
+
+    it "sets the response to nil" do
+      request = Elevate::HTTP::HTTPRequest.new(:get, @url)
+      request.start()
+      request.cancel()
+
+      request.response.should.be.nil
+    end
+  end
+end

data/spec/io_coordinator_spec.rb

@@ -0,0 +1,44 @@
+describe Elevate::IOCoordinator do
+  before do
+    @coordinator = Elevate::IOCoordinator.new
+  end
+
+  it "is not cancelled" do
+    @coordinator.should.not.be.cancelled
+  end
+
+  describe "#install" do
+    it "stores the coordinator in a thread-local variable" do
+      @coordinator.install()
+
+      Thread.current[:io_coordinator].should == @coordinator
+    end
+  end
+
+  [:signal_blocked, :signal_unblocked].each do |method|
+    describe method.to_s do
+      describe "when IO has not been cancelled" do
+        it "does not raise CancelledError" do
+          lambda { @coordinator.send(method, 42) }.should.not.raise
+        end
+      end
+
+      describe "when IO was cancelled" do
+        it "raises CancelledError" do
+          @coordinator.cancel()
+
+          lambda { @coordinator.send(method, "hello") }.should.raise(Elevate::CancelledError)
+        end
+      end
+    end
+  end
+
+  describe "#uninstall" do
+    it "removes the coordinator from a thread-local variable" do
+      @coordinator.install()
+      @coordinator.uninstall()
+
+      Thread.current[:io_coordinator].should.be.nil
+    end
+  end
+end

data/spec/operation_spec.rb

@@ -0,0 +1,133 @@
+describe Elevate::ElevateOperation do
+  before do
+    @target = Target.new
+    @operation = Elevate::ElevateOperation.alloc.initWithTarget(@target)
+    @queue = NSOperationQueue.alloc.init
+  end
+
+  after do
+    @queue.waitUntilAllOperationsAreFinished()
+  end
+
+  it "subclasses NSOperation" do
+    @operation.class.ancestors.should.include NSOperation
+  end
+
+  describe "#on_finished" do
+    it "invokes it after #on_started" do
+      @lock = NSLock.alloc.init
+      @value = []
+
+      @operation.on_started  = lambda do
+        @lock.lock()
+        if @value == []
+          @value << 1
+        end
+        @lock.unlock()
+      end
+
+      @operation.on_finished = lambda do
+        @lock.lock()
+        if @value == [1]
+          @value << 2
+        end
+        @lock.unlock()
+
+        resume
+      end
+
+      @queue.addOperation(@operation)
+
+      wait_max 1.0 do
+        @lock.lock()
+        @value.should == [1,2]
+        @lock.unlock()
+      end
+    end
+  end
+
+  describe "#exception" do
+    describe "when no exception is raised" do
+      it "returns nil" do
+        @queue.addOperation(@operation)
+        @operation.waitUntilFinished()
+
+        @operation.exception.should.be.nil
+      end
+    end
+
+    describe "when an exception is raised" do
+      it "returns the exception" do
+        @target.exception = IndexError.new
+
+        @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
+      end
+    end
+  end
+
+  describe "#result" do
+    before do
+      @target.result = 42
+    end
+
+    describe "before starting the operation" do
+      it "returns nil" do
+        @operation.result.should.be.nil
+      end
+    end
+
+    describe "when the operation has been cancelled" do
+      it "returns nil" do
+        @operation.cancel()
+
+        @queue.addOperation(@operation)
+        @operation.waitUntilFinished()
+
+        @operation.result.should.be.nil
+      end
+    end
+
+    describe "when the operation has finished" do
+      it "returns the result of the target's #execute method" do
+        @queue.addOperation(@operation)
+        @operation.waitUntilFinished()
+
+        @operation.result.should == 42
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: elevate
+version: !ruby/object:Gem::Version
+  version: '0.3'
+  prerelease: 
+platform: ruby
+authors:
+- Matt Green
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: guard-motion
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: webstub
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.3
+description: Distill the essence of your RubyMotion app
+email:
+- mattgreenrocks@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- app/app_delegate.rb
+- elevate.gemspec
+- lib/elevate.rb
+- lib/elevate/api.rb
+- lib/elevate/callback.rb
+- lib/elevate/dispatcher.rb
+- lib/elevate/dsl.rb
+- lib/elevate/http/base64.rb
+- lib/elevate/http/http_client.rb
+- lib/elevate/http/request.rb
+- lib/elevate/http/response.rb
+- lib/elevate/http/uri.rb
+- lib/elevate/io_coordinator.rb
+- lib/elevate/operation.rb
+- lib/elevate/promise.rb
+- 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/http_client_spec.rb
+- spec/http/http_request_spec.rb
+- spec/io_coordinator_spec.rb
+- spec/operation_spec.rb
+homepage: http://github.com/mattgreen/elevate
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1532692712045252370
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1532692712045252370
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+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/http_client_spec.rb
+- spec/http/http_request_spec.rb
+- spec/io_coordinator_spec.rb
+- spec/operation_spec.rb