webstub 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5a5ee428399a0214cd16a8d72651cf34d6d07497
-  data.tar.gz: e55c492aca59216cf5b245286e8ba9859d2b9abb
+  metadata.gz: 83ff338cdc8626be04a4ca16d8a72f4fa015e5ae
+  data.tar.gz: 32edcc1fb2dc10c867ce83ad0c8bfbd4860959dd
 SHA512:
-  metadata.gz: 58f0a1305f0d7a7b0f6dceea41696210694991f88ddc36c20007a0312fe32f76e77c6087a12f96b7f89a9e67e37b41cb0074b31a13c7055c00b105a61b7213db
-  data.tar.gz: 20330658e51a988deada8bfec184c32a699c8437eb635a0073a13ad6c4840788e9cba1e7cc4287c01895c1d2b862d6c3feaa993b1f9f8dd663e907f54df8a5e6
+  metadata.gz: f94be75dca1cacf1f27d03282ab04f98f791bc8f7e3ec6e4080a759914169a3b73ed4d9a83c4ad01ae5a71d6fec3152ae371c3c9f246c60034f9da5a8720a7fd
+  data.tar.gz: 28b5ea6be60a257bfb17a3e517dde84b2fb9a231eb4e245dd200fd5be0d5e17f9d99d2bc2dd0e91bcb36a34b122b5c54d103f98f0fa7c5dab65ed2b315ca8ba9

data/Gemfile

@@ -1,11 +1,3 @@
 source 'https://rubygems.org'
 
-gem 'rake'
-
-gem 'listen', :git => 'git://github.com/guard/listen.git'
-gem 'guard', :git => 'git://github.com/guard/guard.git'
-gem 'guard-motion'
-gem 'rb-fsevent', '~> 0.9.1'
-gem 'coolline'
-gem 'terminal-notifier-guard'
-gem 'rubygems-tasks'
+gemspec

data/README.md

@@ -91,6 +91,23 @@ describe "Example" do
       end
     end
   end
+
+  describe "Stubbing a GET request to fail" do
+    it "returns an NSError with the NSURLError domain" do
+      stub_request(:get, "https://example.com/action").
+        to_fail(code: NSURLErrorNotConnectedToInternet)
+
+      @error = nil
+      @api.get_albums do |results, error|
+        @error = error
+        resume
+      end
+
+      wait_max 1.0 do
+        @error.code.should == NSURLErrorNotConnectedToInternet
+      end
+    end
+  end
 end
 ```
 
@@ -108,6 +125,9 @@ Conventions
 - The `to_redirect` method accepts:
   - `url`: String of the URL to redirect to (*required*)
   - All options supported by `to_return` except for `status_code`
+- The `to_fail` method accepts one of the following options:
+  - `code`: `NSURLErrorDomain` [error code](https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Miscellaneous/Foundation_Constants/Reference/reference.html)
+  - `error`: `NSError` to fail the request with
 
 Expectations
 -----------------

data/lib/webstub/protocol.rb

@@ -51,6 +51,11 @@ module WebStub
                                                      headerFields:@stub.response_headers)
       @stub.requests += 1
 
+      if @stub.error?
+        client.URLProtocol(self, didFailWithError: @stub.response_error)
+        return
+      end
+
       if @stub.redirects?
         url = NSURL.URLWithString(@stub.response_headers["Location"])
         redirect_request = NSURLRequest.requestWithURL(url)

data/lib/webstub/stub.rb

@@ -14,10 +14,15 @@ module WebStub
 
       @response_body = ""
       @response_delay = 0.0
+      @response_error = nil
       @response_headers = {}
       @response_status_code = 200
     end
 
+    def error?
+      ! @response_error.nil?
+    end
+
     def matches?(method, url, options={})
       if @request_url != canonicalize_url(url)
         return false
@@ -58,9 +63,22 @@ module WebStub
 
     attr_reader :response_body
     attr_reader :response_delay
+    attr_reader :response_error
     attr_reader :response_headers
     attr_reader :response_status_code
 
+    def to_fail(options)
+      if error = options.delete(:error)
+        @response_error = error
+      elsif code = options.delete(:code)
+        @response_error = NSError.errorWithDomain(NSURLErrorDomain, code: code, userInfo: nil)
+      else
+        raise ArgumentError, "to_fail requires either the code or error option" 
+      end
+
+      self
+    end
+
     def to_return(options)
       if status_code = options[:status_code]
         @response_status_code = status_code

data/lib/webstub/version.rb

@@ -1,3 +1,3 @@
 module WebStub
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/spec/api_spec.rb

@@ -172,6 +172,17 @@ describe WebStub::API do
         response.body.should == '{}'
       end
     end
+
+    describe "when a stub is configured to fail" do
+      it "fails the request" do
+        WebStub::API.stub_request(:get, @url).
+          to_fail(code: NSURLErrorNetworkConnectionLost)
+
+        response = get(@url)
+
+        response.error.code.should == NSURLErrorNetworkConnectionLost
+      end
+    end
   end
 
   describe ".reset_stubs" do

data/spec/stub_spec.rb

@@ -17,6 +17,26 @@ describe WebStub::Stub do
     lambda { WebStub::Stub.new("invalid", "http://www.yahoo.com/") }.should.raise(ArgumentError)
   end
 
+  it "does not have a response error by default" do
+    @stub.response_error.should.be.nil
+  end
+
+  describe "#error?" do
+    describe "by default" do
+      it "returns false" do
+        @stub.error?.should.be.false
+      end
+    end
+
+    describe "after calling to_fail" do
+      it "returns true" do
+        @stub.to_fail(code: NSURLErrorUnsupportedURL)
+
+        @stub.error?.should.be.true
+      end
+    end
+  end
+
   describe "#matches?" do
     it "returns true when provided an identical stub" do
       @stub.matches?(:get, "http://www.yahoo.com/").should.be.true
@@ -108,6 +128,30 @@ describe WebStub::Stub do
     end
   end
 
+  describe "#to_fail" do
+    it "rejects an empty options Hash" do
+      lambda { @stub.to_fail({}) }.should.raise(ArgumentError)
+    end
+
+    it "builds an NSError using the option specified by code" do
+      @stub.to_fail(code: NSURLErrorUnsupportedURL)
+
+      @stub.response_error.domain.should == NSURLErrorDomain
+      @stub.response_error.code.should == NSURLErrorUnsupportedURL
+    end
+
+    it "accepts an arbitrary NSError using the error option" do
+      error = NSError.errorWithDomain(0, code: 123, userInfo: nil)
+      @stub.to_fail(error: error)
+
+      @stub.response_error.should == error
+    end
+
+    it "returns self" do
+      @stub.to_fail(code: 123).should == @stub
+    end
+  end
+
   describe "#to_redirect" do
     it "requires the :url option" do
       lambda { @stub.to_redirect }.should.raise(ArgumentError)

data/webstub.gemspec

@@ -13,4 +13,7 @@ Gem::Specification.new do |gem|
   gem.name          = "webstub"
   gem.require_paths = ["lib"]
   gem.version       = WebStub::VERSION
+
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "rubygems-tasks"
 end

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: webstub
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Matt Green
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-26 00:00:00.000000000 Z
-dependencies: []
+date: 2013-06-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Easily stub out HTTP responses in RubyMotion specs
 email:
 - mattgreenrocks@gmail.com