rspec-rails-ext 1.7.1

data/CHANGELOG

@@ -0,0 +1,12 @@
+v1.7.1. Added be_not_acceptable
+v1.7.   Added use_layout matcher
+v1.6.3. Changed the output when status/locations don't match
+v1.6.2. Changed how we match the status header
+v1.6.1. Added associated_model builder
+v1.6.0. Pushed a version that actually works (oops, sorry about that)
+v1.005. Added invalid_model
+v1.004. Added `rake build`
+v1.003. Added mocks - prepare_for_errors_on
+v1.002. Bugfix
+v1.001. Bugfix
+v1.000. Initial release

data/LICENCE

@@ -0,0 +1,11 @@
+Released under the MIT Licence
+
+Copyright (c) 2008 Brightbox Systems Ltd 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+* The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+See http://www.brightbox.co.uk/ for contact details.  

data/Manifest

@@ -0,0 +1,11 @@
+CHANGELOG
+LICENCE
+Manifest
+README.rdoc
+Rakefile
+lib/controller_example_group.rb
+lib/mocks.rb
+lib/responses.rb
+lib/rspec_rails_extensions.rb
+lib/use_layout.rb
+rspec-rails-ext.gemspec

data/README.rdoc

@@ -0,0 +1,82 @@
+= RSpec-Rails Extensions
+
+Some prettifications for RSpec Rails.  
+
+== Installation
+
+  sudo gem install rspec-rails-ext
+  
+Then, within your spec/spec_helper.rb
+
+  require 'rspec_rails_extensions'
+
+== ActiveRecord::RecordInvalid
+
+If you try to call ActiveRecord::RecordInvalid.new(@my_object) where @my_object is a mock then your exception will not be raised; instead you get a cryptic error.  This is because RecordInvalid expects to be able to call certain methods on your ActiveRecord model, which your mock isn't set up for.  So instead, prepare your mock, like so: 
+
+  @thingy = mock_model Thingy, :field => 'value'
+  prepare_for_errors_on @thingy
+  raise ActiveRecord::RecordInvalid.new(@thingy)
+  
+There's also a short-cut method: 
+
+  @thingy = invalid_model Thingy, :field => 'value'
+  raise ActiveRecord::RecordInvalid.new(@thingy)
+
+== Matchers
+
+Some helpful matchers for testing HTTP statuses beyond the default be_success (200 OK)
+
+  # looks for a 201 Created (useful for API CREATE calls)
+  response.should be_successfully_created 
+  
+  # expects a Location field with the given URL (useful for API CREATE calls)
+  response.should point_to(url) 
+  
+  # looks for a 422 response (invalid object)
+  response.should be_unprocessable
+  
+  # looks for a 404
+  response.should be_not_found
+  
+  # looks for a 401
+  response.should be_unauthorised
+  
+  # looks for a 500
+  response.should be_an_error
+  
+Also a helper for testing which layout was used
+
+  # Makes sure it used the "bare" layout
+  response.should use_layout("bare")
+    
+== Specifying your controllers
+
+One of the issues with writing standard controller specifications, using RSpec's inbuilt mock objects is that the "flow" of your specs feels wrong.  
+
+  it "should display a page for a given thingy" do
+    @thingy = mock_model Thingy, :name => 'Wotsit'
+    Thingy.should_receive(:find).with('1').and_return(@thingy)
+    
+    get :show, :id => '1'
+    
+    response.should be_success
+    response.should render_template('thingies/show')
+  end
+    
+In other words you are setting expectations before you are doing the work - technically correct but it reads wrongly.  
+
+These extra helpers let you write specifications in a more english-like manner.  
+
+  it "should display a page for a given thingy" do
+    @thingy = mock_model Thingy
+    
+    on_getting :show, :id => '1' do
+      Thingy.should_receive(:find).with('1').and_return(@thingy)
+    end
+
+    response.should be_success
+    response.should render_template('thingies/show')
+  end
+    
+Isn't that lovely?

data/Rakefile

@@ -0,0 +1,12 @@
+require 'echoe'
+Echoe.new('rspec-rails-ext') do | gem | 
+  gem.author = ["Rahoul Baruah", "Caius Durling"]
+  gem.email = 'support@brightbox.co.uk'
+  gem.summary = 'Helpers for prettying up your RSpec-Rails specifications'
+  gem.url = 'http://github.com/brightbox/rspec-rails-extensions/tree/master'
+end
+
+desc "Generates the manifest and the gemspec"
+task :build => [:manifest, :build_gemspec] do
+  puts "Built!"
+end

data/lib/controller_example_group.rb

@@ -0,0 +1,65 @@
+module Spec
+  module Rails
+    module Example
+      class ControllerExampleGroup < FunctionalExampleGroup
+        # Perform a pseudo HTTP GET, performing any code in the block beforehand.  This is to allow you to set up expectations on your mocks whilst keeping the code readable.   
+        # For example: 
+        #   on_getting :show, :id => '25' do
+        #     @person = mock_model Person
+        #     Person.should_receive(:find).with('25').and_return(@person)
+        #   end
+        # If you want an XMLHTTPRequest pass in :as_xhr => true in the parameters
+        # (don't worry - it won't be passed to your controller)
+        # For example:
+        #   on_getting :show, :id => '25', :as_xhr => true do
+        #     whatever
+        #   end
+        def on_getting page, parameters = {}
+          yield if block_given?
+          is_xhr_request = parameters.delete(:as_xhr)
+          if is_xhr_request
+            xhr :get, page, parameters
+          else
+            get page, parameters
+          end
+        end
+
+        # Perform a pseudo HTTP POST, performing any code in the block beforehand.  This is to allow you to set up expectations on your mocks whilst keeping the code readable.   
+        # As with on_getting, use :as_xhr => true to make this an XMLHTTPRequest
+        def on_posting_to page, parameters = {}
+          yield if block_given?
+          is_xhr_request = parameters.delete(:as_xhr)
+          if is_xhr_request
+            xhr :post, page, parameters
+          else
+            post page, parameters
+          end
+        end
+        
+        # Perform a pseudo HTTP PUT, performing any code in the block beforehand.  This is to allow you to set up expectations on your mocks whilst keeping the code readable.   
+        # As with on_getting, use :as_xhr => true to make this an XMLHTTPRequest
+        def on_putting_to page, parameters = {}
+          yield if block_given?
+          is_xhr_request = parameters.delete(:as_xhr)
+          if is_xhr_request
+            xhr :put, page, parameters
+          else
+            put page, parameters
+          end
+        end
+        
+        # Perform a pseudo HTTP DELETE, performing any code in the block beforehand.  This is to allow you to set up expectations on your mocks whilst keeping the code readable.   
+        # As with on_getting, use :as_xhr => true to make this an XMLHTTPRequest
+        def on_deleting_from page, parameters = {}
+          yield if block_given?
+          is_xhr_request = parameters.delete(:as_xhr)
+          if is_xhr_request
+            xhr :delete, page, parameters
+          else
+            delete page, parameters
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mocks.rb

@@ -0,0 +1,36 @@
+module Spec
+  module Rails
+    module Mocks
+      # Set up the given mock model in preparation for an ActiveRecord::RecordInvalid call
+      # For example: 
+      #   @user = mock_model User
+      #   prepare_for_errors_on @user
+      #   @user.should_receive(:save!).and_raise(ActiveRecord::RecordInvalid.new(@user))
+      # If you tried this without the call to prepare_for_errors_on, the RecordInvalid exception would not be raised.  
+      def prepare_for_errors_on model
+        errors = mock 'errors'
+        errors.should_receive(:full_messages).and_return([])
+        model.should_receive(:errors).and_return(errors)
+      end
+    
+      # Shortcut to create a mock model that is prepared for a ActiveRecord::RecordInvalid.new(@model) call
+      # Equivalent to: 
+      #   @model = mock_model Model, :some => :fields
+      #   prepare_for_errors_on @model
+      def invalid_model class_name, stubs = {}
+        model = mock_model class_name, stubs
+        prepare_for_errors_on model
+        return model
+      end
+      
+      # Shortcut to create a model that will be used in an association
+      # Example: 
+      #   @model = MasterModel.create!
+      #   @mock = associated_model ChildModel, :some => :value
+      #   @model.children << @mock
+      def associated_model class_name, stubs = {}
+        mock_model class_name, stubs.merge(:[]= => true, :save => true)
+      end
+    end
+  end
+end

data/lib/responses.rb

@@ -0,0 +1,92 @@
+=begin rdoc
+Module with a set of matchers for examining ActionController::Response objects
+=end
+module ResponseMatchers
+  # test for a 201 response
+  def be_successfully_created 
+    ResponseStatusMatcher.new "201 Created"
+  end
+  
+  # test for a 422 response
+  def be_unprocessable
+    ResponseStatusMatcher.new "422 Unprocessable Entity"
+  end 
+  
+  # test for a 404 response
+  def be_not_found
+    ResponseStatusMatcher.new "404 Not Found"
+  end
+  
+  # test for a 401 response
+  def be_unauthorised
+    ResponseStatusMatcher.new "401 Unauthorized"
+  end
+  alias :be_unauthorized :be_unauthorised
+  
+  # test for a 406 response
+  def be_not_acceptable
+    ResponseStatusMatcher.new "406 Not Acceptable"
+  end
+  
+  # test for a 500 internal server error 
+  def be_an_error
+    ResponseStatusMatcher.new "500 Internal Error"
+  end
+  
+  # test that the location points to a given URI
+  def point_to url
+    ResponseLocationMatcher.new url
+  end
+  
+  # Response matcher that examines ActionController::Response headers for the required status code
+  class ResponseStatusMatcher
+    # Set up this matcher as required
+    def initialize status_code
+      @status_code = status_code
+    end
+
+    # Does the given target object match the required status code?
+    def matches? target
+      (@target_status = target.status) == @status_code
+    end
+    
+    # What do we tell the user when it fails?
+    def failure_message
+      a = <<-EOF
+      expected the location header to be #{@status_code.inspect}
+                          instead it was #{@target_status.inspect}
+      EOF
+    end
+    
+    # What do we tell the user when it shouldn't fail but does
+    def negative_failure_message
+      "expected the response to be different to #{@status_code.inspect}"
+    end
+  end
+  
+  # Response matcher that examines ActionController::Response headers for the given location code
+  class ResponseLocationMatcher
+    def initialize url
+      @url = url
+    end
+    
+    # Does the given target object match the required location?
+    def matches? target
+      (@target_url = target.headers['Location']) == @url
+    end
+    
+    # What do we tell the user when it fails?
+    def failure_message
+      a = <<-EOF
+      expected the location header to be #{@target_url.inspect}
+                          instead it was #{@url.inspect}
+      EOF
+    end
+    
+    # What do we tell the user when it shouldn't fail but does
+    def negative_failure_message
+      "expected the location header to be different to #{@url.inspect}"
+    end
+  end
+
+end

data/lib/rspec_rails_extensions.rb

@@ -0,0 +1,5 @@
+require 'spec/rails'
+require 'mocks'
+require 'responses'
+require 'controller_example_group'
+require "use_layout"

data/lib/use_layout.rb

@@ -0,0 +1,29 @@
+=begin rdoc
+  Module for testing the layout used in a response object
+=end
+module ResponseMatchers
+  # From http://rubyforge.org/pipermail/rspec-users/2007-May/001818.html
+  class UseLayout
+    def initialize(expected)
+      @expected = 'layouts/' + expected
+    end
+
+    def matches?(controller)
+      @actual = controller.layout
+      #@actual.equal?(@expected)
+      @actual == @expected
+    end
+
+    def failure_message
+      return "use_layout expected #{@expected.inspect}, got #{@actual.inspect}", @expected, @actual
+    end
+
+    def negeative_failure_message
+      return "use_layout expected #{@expected.inspect} not to equal #{@actual.inspect}", @expected, @actual
+    end
+  end
+
+  def use_layout(expected)
+    UseLayout.new(expected)
+  end
+end

data/rspec-rails-ext.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rspec-rails-ext}
+  s.version = "1.7.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Rahoul Baruah, Caius Durling"]
+  s.date = %q{2009-11-10}
+  s.description = %q{Helpers for prettying up your RSpec-Rails specifications}
+  s.email = %q{support@brightbox.co.uk}
+  s.extra_rdoc_files = ["CHANGELOG", "README.rdoc", "lib/controller_example_group.rb", "lib/mocks.rb", "lib/responses.rb", "lib/rspec_rails_extensions.rb", "lib/use_layout.rb"]
+  s.files = ["CHANGELOG", "LICENCE", "Manifest", "README.rdoc", "Rakefile", "lib/controller_example_group.rb", "lib/mocks.rb", "lib/responses.rb", "lib/rspec_rails_extensions.rb", "lib/use_layout.rb", "rspec-rails-ext.gemspec"]
+  s.homepage = %q{http://github.com/brightbox/rspec-rails-extensions/tree/master}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rspec-rails-ext", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{rspec-rails-ext}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Helpers for prettying up your RSpec-Rails specifications}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: rspec-rails-ext
+version: !ruby/object:Gem::Version 
+  version: 1.7.1
+platform: ruby
+authors: 
+- Rahoul Baruah, Caius Durling
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-10 00:00:00 +00:00
+default_executable: 
+dependencies: []
+
+description: Helpers for prettying up your RSpec-Rails specifications
+email: support@brightbox.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- README.rdoc
+- lib/controller_example_group.rb
+- lib/mocks.rb
+- lib/responses.rb
+- lib/rspec_rails_extensions.rb
+- lib/use_layout.rb
+files: 
+- CHANGELOG
+- LICENCE
+- Manifest
+- README.rdoc
+- Rakefile
+- lib/controller_example_group.rb
+- lib/mocks.rb
+- lib/responses.rb
+- lib/rspec_rails_extensions.rb
+- lib/use_layout.rb
+- rspec-rails-ext.gemspec
+has_rdoc: true
+homepage: http://github.com/brightbox/rspec-rails-extensions/tree/master
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Rspec-rails-ext
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: rspec-rails-ext
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Helpers for prettying up your RSpec-Rails specifications
+test_files: []
+