dchelimsky-rspec-rails 1.1.6

data/spec/rails/example/controller_spec_spec.rb

@@ -0,0 +1,272 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'controller_spec_controller'
+
+['integration', 'isolation'].each do |mode|
+  describe "A controller example running in #{mode} mode", :type => :controller do
+    controller_name :controller_spec
+    integrate_views if mode == 'integration'
+    
+    it "should provide controller.session as session" do
+      get 'action_with_template'
+      session.should equal(controller.session)
+    end
+  
+    it "should provide the same session object before and after the action" do
+      session_before = session
+      get 'action_with_template'
+      session.should equal(session_before)
+    end
+  
+    it "should keep the same data in the session before and after the action" do
+      session[:foo] = :bar
+      get 'action_with_template'
+      session[:foo].should == :bar
+    end
+  
+    it "should ensure controller.session is NOT nil before the action" do
+      controller.session.should_not be_nil
+      get 'action_with_template'
+    end
+    
+    it "should ensure controller.session is NOT nil after the action" do
+      get 'action_with_template'
+      controller.session.should_not be_nil
+    end
+    
+    it "should allow specifying a partial with partial name only" do
+      get 'action_with_partial'
+      response.should render_template("_partial")
+    end
+    
+    it "should allow specifying a partial with should_receive(:render)" do
+      controller.should_receive(:render).with(:partial => "controller_spec/partial")
+      get 'action_with_partial'
+    end
+    
+    it "should allow specifying a partial with should_receive(:render) with object" do
+      controller.should_receive(:render).with(:partial => "controller_spec/partial", :object => "something")
+      get 'action_with_partial_with_object', :thing => "something"
+    end
+    
+    it "should allow specifying a partial with should_receive(:render) with locals" do
+      controller.should_receive(:render).with(:partial => "controller_spec/partial", :locals => {:thing => "something"})
+      get 'action_with_partial_with_locals', :thing => "something"
+    end
+    
+    it "should yield to render :update" do
+      template = stub("template")
+      controller.should_receive(:render).with(:update).and_yield(template)
+      template.should_receive(:replace).with(:bottom, "replace_me", :partial => "non_existent_partial")
+      get 'action_with_render_update'
+    end
+    
+    it "should allow a path relative to RAILS_ROOT/app/views/ when specifying a partial" do
+      get 'action_with_partial'
+      response.should render_template("controller_spec/_partial")
+    end
+    
+    it "should provide access to flash" do
+      get 'action_which_sets_flash'
+      flash[:flash_key].should == "flash value"
+    end
+    
+    it "should provide access to flash values set after a session reset" do
+      get 'action_setting_flash_after_session_reset'
+      flash[:after_reset].should == "available"
+    end
+    
+    it "should not provide access to flash values set before a session reset" do
+      get 'action_setting_flash_before_session_reset'
+      flash[:before_reset].should_not == "available"
+    end
+
+    it "should provide access to session" do
+      session[:session_key] = "session value"
+      lambda do
+        get 'action_which_gets_session', :expected => "session value"
+      end.should_not raise_error
+    end
+
+    describe "handling should_receive(:render)" do
+      it "should warn" do
+        controller.should_receive(:render).with(:template => "controller_spec/action_with_template")
+        get :action_with_template
+      end
+    end
+    
+    describe "handling should_not_receive(:render)" do
+      it "should warn" do
+        controller.should_not_receive(:render).with(:template => "the/wrong/template")
+        get :action_with_template
+      end
+    end
+    
+    describe "handling deprecated expect_render" do
+      it "should warn" do
+        Kernel.should_receive(:warn).with(/expect_render is deprecated/)
+        controller.expect_render(:template => "controller_spec/action_with_template")
+        get :action_with_template
+      end
+    end
+    
+    describe "handling deprecated stub_render" do
+      it "should warn" do
+        Kernel.should_receive(:warn).with(/stub_render is deprecated/)
+        controller.stub_render(:template => "controller_spec/action_with_template")
+        get :action_with_template
+      end
+    end
+    
+    describe "setting cookies in the request" do
+    
+      it "should support a String key" do
+        cookies['cookie_key'] = 'cookie value'
+        get 'action_which_gets_cookie', :expected => "cookie value"
+      end
+
+      it "should support a Symbol key" do
+        cookies[:cookie_key] = 'cookie value'
+        get 'action_which_gets_cookie', :expected => "cookie value"
+      end
+      
+      if Rails::VERSION::STRING >= "2.0.0"
+        it "should support a Hash value" do
+          cookies[:cookie_key] = {'value' => 'cookie value', 'path' => '/not/default'}
+          get 'action_which_gets_cookie', :expected => {'value' => 'cookie value', 'path' => '/not/default'}
+        end
+      end
+      
+    end
+  
+    describe "reading cookies from the response" do
+  
+      it "should support a Symbol key" do
+        get 'action_which_sets_cookie', :value => "cookie value"
+        cookies[:cookie_key].value.should == ["cookie value"]
+      end
+
+      it "should support a String key" do
+        get 'action_which_sets_cookie', :value => "cookie value"
+        cookies['cookie_key'].value.should == ["cookie value"]
+      end
+    
+    end
+
+    it "should support custom routes" do
+      route_for(:controller => "custom_route_spec", :action => "custom_route").should == "/custom_route"
+    end
+
+    it "should support existing routes" do
+      route_for(:controller => "controller_spec", :action => "some_action").should == "/controller_spec/some_action"
+    end
+
+    it "should generate params for custom routes" do
+      params_from(:get, '/custom_route').should == {:controller => "custom_route_spec", :action => "custom_route"}
+    end
+    
+    it "should generate params for existing routes" do
+      params_from(:get, '/controller_spec/some_action').should == {:controller => "controller_spec", :action => "some_action"}
+    end
+    
+    it "should expose instance vars through the assigns hash" do
+      get 'action_setting_the_assigns_hash'
+      assigns[:indirect_assigns_key].should == :indirect_assigns_key_value
+    end
+    
+    it "should NOT complain when calling should_receive with arguments other than :render" do
+      controller.should_receive(:anything_besides_render)
+      lambda {
+        controller.rspec_verify
+      }.should raise_error(Exception, /expected :anything_besides_render/)
+    end
+    
+    it "should not run a skipped before_filter" do
+      lambda {
+        get 'action_with_skipped_before_filter'
+      }.should_not raise_error
+    end
+  end
+
+  describe "Given a controller spec for RedirectSpecController running in #{mode} mode", :type => :controller do
+    controller_name :redirect_spec
+    integrate_views if mode == 'integration'
+
+    it "a redirect should ignore the absence of a template" do
+      get 'action_with_redirect_to_somewhere'
+      response.should be_redirect
+      response.redirect_url.should == "http://test.host/redirect_spec/somewhere"
+      response.should redirect_to("http://test.host/redirect_spec/somewhere")
+    end
+    
+    it "a call to response.should redirect_to should fail if no redirect" do
+      get 'action_with_no_redirect'
+      lambda {
+        response.redirect?.should be_true
+      }.should fail
+      lambda {
+        response.should redirect_to("http://test.host/redirect_spec/somewhere")
+      }.should fail_with("expected redirect to \"http://test.host/redirect_spec/somewhere\", got no redirect")
+    end
+  end
+  
+  describe "Given a controller spec running in #{mode} mode" do
+    example_group = describe "A controller spec"
+    # , :type => :controller do
+    # integrate_views if mode == 'integration'
+    it "a spec in a context without controller_name set should fail with a useful warning" do
+      pending("need a new way to deal with examples that should_raise")
+    # ,
+    #   :should_raise => [
+    #     Spec::Expectations::ExpectationNotMetError,
+    #     /You have to declare the controller name in controller specs/
+    #   ] do
+    end
+  end
+  
+end
+
+['integration', 'isolation'].each do |mode|
+  describe "A controller example running in #{mode} mode", :type => :controller do
+    controller_name :controller_inheriting_from_application_controller
+    integrate_views if mode == 'integration'
+    
+    it "should only have a before filter inherited from ApplicationController run once..." do
+      controller.should_receive(:i_should_only_be_run_once).once
+      get :action_with_inherited_before_filter
+    end
+  end
+end
+
+
+describe ControllerSpecController, :type => :controller do
+  it "should not require naming the controller if describe is passed a type" do
+  end  
+end
+
+describe "A controller spec with controller_name set", :type => :controller do
+  controller_name :controller_spec
+  
+  describe "nested" do
+    it "should inherit the controller name" do
+      get 'action_with_template'
+      response.should be_success
+    end
+  end
+end
+
+module Spec
+  module Rails
+    module Example
+      describe ControllerExampleGroup do
+        it "should clear its name from the description" do
+          group = describe("foo", :type => :controller) do
+            $nested_group = describe("bar") do
+            end
+          end
+          group.description.to_s.should == "foo"
+          $nested_group.description.to_s.should == "foo bar"
+        end
+      end
+    end
+  end
+end

data/spec/rails/example/cookies_proxy_spec.rb

@@ -0,0 +1,74 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+class CookiesProxyExamplesController < ActionController::Base
+  def index
+    cookies[:key] = cookies[:key]
+  end
+end
+
+module Spec
+  module Rails
+    module Example
+      describe CookiesProxy, :type => :controller do
+        controller_name :cookies_proxy_examples
+      
+        describe "with a String key" do
+        
+          it "should accept a String value" do
+            cookies = CookiesProxy.new(self)
+            cookies['key'] = 'value'
+            get :index
+            cookies['key'].should == ['value']
+          end
+          
+          if Rails::VERSION::STRING >= "2.0.0"
+            it "should accept a Hash value" do
+              cookies = CookiesProxy.new(self)
+              cookies['key'] = { :value => 'value', :expires => expiration = 1.hour.from_now, :path => path = '/path' }
+              get :index
+              cookies['key'].should == ['value']
+              cookies['key'].value.should == ['value']
+              cookies['key'].expires.should == expiration
+              cookies['key'].path.should == path
+            end
+          end
+            
+        end
+      
+        describe "with a Symbol key" do
+        
+          it "should accept a String value" do
+            example_cookies = CookiesProxy.new(self)
+            example_cookies[:key] = 'value'
+            get :index
+            example_cookies[:key].should == ['value']
+          end
+
+          if Rails::VERSION::STRING >= "2.0.0"
+            it "should accept a Hash value" do
+              example_cookies = CookiesProxy.new(self)
+              example_cookies[:key] = { :value => 'value', :expires => expiration = 1.hour.from_now, :path => path = '/path' }
+              get :index
+              example_cookies[:key].should == ['value']
+              example_cookies[:key].value.should == ['value']
+              example_cookies[:key].expires.should == expiration
+              example_cookies[:key].path.should == path
+            end
+          end
+
+        end
+    
+        describe "#delete" do
+          it "should delete from the response cookies" do
+            example_cookies = CookiesProxy.new(self)
+            response_cookies = mock('cookies')
+            response.should_receive(:cookies).and_return(response_cookies)
+            response_cookies.should_receive(:delete).with('key')
+            example_cookies.delete :key
+          end
+        end
+      end
+    
+    end
+  end
+end

data/spec/rails/example/example_group_factory_spec.rb

@@ -0,0 +1,112 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Example
+    describe ExampleGroupFactory do
+      it "should return a ModelExampleGroup when given :type => :model" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :type => :model
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ModelExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :spec_path => '/blah/spec/models/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '/blah/spec/models/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ModelExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :spec_path => '\\blah\\spec\\models\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '\\blah\\spec\\models\\blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ModelExampleGroup
+      end
+
+      it "should return a RailsExampleGroup when given :spec_path => '/blah/spec/foo/' (anything other than controllers, views and helpers)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '/blah/spec/foo/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::RailsExampleGroup
+      end
+
+      it "should return a RailsExampleGroup when given :spec_path => '\\blah\\spec\\foo\\' (windows format)  (anything other than controllers, views and helpers)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '\\blah\\spec\\foo\\blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::RailsExampleGroup
+      end
+
+      it "should return a ViewExampleGroup when given :type => :model" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :type => :view
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ViewExampleGroup
+      end
+
+      it "should return a ViewExampleGroup when given :spec_path => '/blah/spec/views/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '/blah/spec/views/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ViewExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :spec_path => '\\blah\\spec\\views\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '\\blah\\spec\\views\\blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ViewExampleGroup
+      end
+
+      it "should return a HelperExampleGroup when given :type => :helper" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :type => :helper
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::HelperExampleGroup
+      end
+
+      it "should return a HelperExampleGroup when given :spec_path => '/blah/spec/helpers/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '/blah/spec/helpers/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::HelperExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :spec_path => '\\blah\\spec\\helpers\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '\\blah\\spec\\helpers\\blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::HelperExampleGroup
+      end
+
+      it "should return a ControllerExampleGroup when given :type => :controller" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :type => :controller
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ControllerExampleGroup
+      end
+
+      it "should return a ControllerExampleGroup when given :spec_path => '/blah/spec/controllers/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '/blah/spec/controllers/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ControllerExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :spec_path => '\\blah\\spec\\controllers\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '\\blah\\spec\\controllers\\blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ControllerExampleGroup
+      end
+
+      it "should favor the :type over the :spec_path" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :spec_path => '/blah/spec/models/blah.rb', :type => :controller
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ControllerExampleGroup
+      end
+    end
+  end
+end

data/spec/rails/example/helper_spec_spec.rb

@@ -0,0 +1,161 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+Spec::Runner.configuration.global_fixtures = :people
+
+describe ExplicitHelper, :type => :helper do
+  include ExplicitHelper
+  
+  it "should not require naming the helper if describe is passed a type" do
+    method_in_explicit_helper.should match(/text from a method/)
+    helper.method_in_explicit_helper.should match(/text from a method/)
+  end
+end
+
+module Spec
+  module Rails
+    module Example
+      describe HelperExampleGroup, :type => :helper do
+        helper_name :explicit
+
+        it "DEPRECATED should have direct access to methods defined in helpers" do
+          method_in_explicit_helper.should =~ /text from a method/
+        end
+
+        it "should expose the helper with the #helper method" do
+          helper.method_in_explicit_helper.should =~ /text from a method/
+        end
+
+        it "should have access to named routes" do
+          rspec_on_rails_specs_url.should == "http://test.host/rspec_on_rails_specs"
+          rspec_on_rails_specs_path.should == "/rspec_on_rails_specs"
+
+          helper.named_url.should == "http://test.host/rspec_on_rails_specs"
+          helper.named_path.should == "/rspec_on_rails_specs"
+        end
+
+        it "should fail if the helper method deson't exist" do
+          lambda { non_existent_helper_method }.should raise_error(NameError)
+          lambda { helper.non_existent_helper_method }.should raise_error(NameError)
+        end
+
+        it "should have access to session" do
+          session[:foo] = 'bar'
+          session_foo.should == 'bar'
+          helper.session_foo.should == 'bar'
+        end
+        
+        it "should have access to params" do
+          params[:foo] = 'bar'
+          params_foo.should == 'bar'
+          helper.params_foo.should == 'bar'
+        end
+        
+        it "should have access to request" do
+          request.stub!(:thing).and_return('bar')
+          request_thing.should == 'bar'
+          helper.request_thing.should == 'bar'
+        end
+        
+        it "should have access to flash" do
+          flash[:thing] = 'camera'
+          flash_thing.should == 'camera'
+          helper.flash_thing.should == 'camera'
+        end
+      end
+
+      describe HelperExampleGroup, "#eval_erb", :type => :helper do
+        helper_name :explicit
+
+        it "should support methods that accept blocks" do
+          eval_erb("<% prepend 'foo' do %>bar<% end %>").should == "foobar"
+        end
+      end
+
+      describe HelperExampleGroup, ".fixtures", :type => :helper do
+        helper_name :explicit
+        fixtures :animals
+
+        it "should load fixtures" do
+          pig = animals(:pig)
+          pig.class.should == Animal
+        end
+
+        it "should load global fixtures" do
+          lachie = people(:lachie)
+          lachie.class.should == Person
+        end
+      end
+      
+      describe "methods from standard helpers", :type => :helper do
+        helper_name :explicit
+        it "should be exposed to the helper" do
+          helper.link_to("Foo","http://bar").should have_tag("a")
+        end
+      end
+
+      describe HelperExampleGroup, "included modules", :type => :helper do
+        helpers = [
+          ActionView::Helpers::ActiveRecordHelper,
+          ActionView::Helpers::AssetTagHelper,
+          ActionView::Helpers::BenchmarkHelper,
+          ActionView::Helpers::CacheHelper,
+          ActionView::Helpers::CaptureHelper,
+          ActionView::Helpers::DateHelper,
+          ActionView::Helpers::DebugHelper,
+          ActionView::Helpers::FormHelper,
+          ActionView::Helpers::FormOptionsHelper,
+          ActionView::Helpers::FormTagHelper,
+          ActionView::Helpers::JavaScriptHelper,
+          ActionView::Helpers::NumberHelper,
+          ActionView::Helpers::PrototypeHelper,
+          ActionView::Helpers::ScriptaculousHelper,
+          ActionView::Helpers::TagHelper,
+          ActionView::Helpers::TextHelper,
+          ActionView::Helpers::UrlHelper
+        ]
+        helpers << ActionView::Helpers::PaginationHelper rescue nil       #removed for 2.0
+        helpers << ActionView::Helpers::JavaScriptMacrosHelper rescue nil #removed for 2.0
+        helpers.each do |helper_module|
+          it "should include #{helper_module}" do
+            self.class.ancestors.should include(helper_module)
+            helper.class.ancestors.should include(helper_module)
+          end
+        end
+      end
+      
+      # TODO: BT - Helper Examples should proxy method_missing to a Rails View instance.
+      # When that is done, remove this method
+      describe HelperExampleGroup, "#protect_against_forgery?", :type => :helper do
+        it "should return false" do
+          protect_against_forgery?.should be_false
+          helper.protect_against_forgery?.should be_false
+        end
+      end
+    end
+  end
+end
+
+module Bug11223
+  # see http://rubyforge.org/tracker/index.php?func=detail&aid=11223&group_id=797&atid=3149
+  describe 'Accessing flash from helper spec', :type => :helper do
+    it 'should not raise an error' do
+      lambda { flash['test'] }.should_not raise_error
+    end
+  end
+end
+
+module Spec
+  module Rails
+    module Example
+      describe HelperExampleGroup do
+        it "should clear its name from the description" do
+          group = describe("foo", :type => :helper) do
+            $nested_group = describe("bar") do
+            end
+          end
+          group.description.to_s.should == "foo"
+          $nested_group.description.to_s.should == "foo bar"
+        end
+      end
+    end
+  end
+end

data/spec/rails/example/model_spec_spec.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Rails
+    module Example
+      describe ModelExampleGroup do
+        it "should clear its name from the description" do
+          group = describe("foo", :type => :model) do
+            $nested_group = describe("bar") do
+            end
+          end
+          group.description.to_s.should == "foo"
+          $nested_group.description.to_s.should == "foo bar"
+        end
+      end
+    end
+  end
+end

data/spec/rails/example/shared_behaviour_spec.rb

@@ -0,0 +1,16 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe "A shared view example_group", :shared => true do
+  it "should have some tag with some text" do
+    response.should have_tag('div', 'This is text from a method in the ViewSpecHelper')
+  end
+end
+
+describe "A view example_group", :type => :view do
+  it_should_behave_like "A shared view example_group"
+  
+  before(:each) do
+    render "view_spec/implicit_helper"
+  end
+end
+  

data/spec/rails/example/test_unit_assertion_accessibility_spec.rb

@@ -0,0 +1,33 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe "assert_equal", :shared => true do
+  it "like assert_equal" do
+    assert_equal 1, 1
+    lambda {
+      assert_equal 1, 2
+    }.should raise_error(Test::Unit::AssertionFailedError)
+  end
+end
+
+describe "A model spec should be able to access 'test/unit' assertions", :type => :model do
+  it_should_behave_like "assert_equal"
+end
+
+describe "A view spec should be able to access 'test/unit' assertions", :type => :view do
+  it_should_behave_like "assert_equal"
+end
+
+describe "A helper spec should be able to access 'test/unit' assertions", :type => :helper do
+  it_should_behave_like "assert_equal"
+end
+
+describe "A controller spec with integrated views should be able to access 'test/unit' assertions", :type => :controller do
+  controller_name :controller_spec
+  integrate_views
+  it_should_behave_like "assert_equal"
+end
+
+describe "A controller spec should be able to access 'test/unit' assertions", :type => :controller do
+  controller_name :controller_spec
+  it_should_behave_like "assert_equal"
+end