cavalle-rspec-rails 1.2.2.0.1

data/spec/spec/rails/example/controller_isolation_spec.rb

@@ -0,0 +1,56 @@
+require File.dirname(__FILE__) + '/../../../spec_helper'
+require 'controller_spec_controller'
+
+describe "a controller spec running in isolation mode", :type => :controller do
+  controller_name :controller_spec
+
+  it "should not care if the template doesn't exist" do
+    get 'some_action'
+    response.should be_success
+    response.should render_template("template/that/does/not/actually/exist")
+  end
+
+  it "should not care if the template has errors" do
+    get 'action_with_errors_in_template'
+    response.should be_success
+    response.should render_template("action_with_errors_in_template")
+  end
+end
+
+describe "a controller spec running in integration mode", :type => :controller do
+  controller_name :controller_spec
+  integrate_views
+  
+  it "should render a template" do
+    get 'action_with_template'
+    response.should be_success
+    response.should have_tag('div', 'This is action_with_template.rhtml')
+  end
+
+  it "should choke if the template doesn't exist" do
+    error = defined?(ActionController::MissingTemplate) ? ActionController::MissingTemplate : ActionView::MissingTemplate    
+    lambda { get 'some_action' }.should raise_error(error)
+  end
+
+  it "should choke if the template has errors" do
+    lambda { get 'action_with_errors_in_template' }.should raise_error(ActionView::TemplateError)
+  end
+  
+  describe "nested" do
+    it "should render a template" do
+      get 'action_with_template'
+      response.should be_success
+      response.should have_tag('div', 'This is action_with_template.rhtml')
+    end
+    
+    describe "with integrate_views turned off" do
+      integrate_views false
+      
+      it "should not care if the template doesn't exist" do
+        get 'some_action'
+        response.should be_success
+        response.should render_template("template/that/does/not/actually/exist")
+      end
+    end
+  end
+end

data/spec/spec/rails/example/cookies_proxy_spec.rb

@@ -0,0 +1,87 @@
+require File.dirname(__FILE__) + '/../../../spec_helper'
+
+class CookiesProxyExamplesController < ActionController::Base
+  def index
+    cookies[:key] = cookies[:key]
+    render :text => ""
+  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
+            proxy = CookiesProxy.new(self)
+            proxy['key'] = 'value'
+            get :index
+            if ::Rails::VERSION::STRING >= "2.3"
+              proxy['key'].should == 'value'
+            else
+              proxy['key'].should == ['value']
+            end
+          end
+          
+          it "should accept a Hash value" do
+            proxy = CookiesProxy.new(self)
+            proxy['key'] = { :value => 'value', :expires => expiration = 1.hour.from_now, :path => path = '/path' }
+            get :index
+            if ::Rails::VERSION::STRING >= "2.3"
+              proxy['key'].should == 'value'
+            else
+              proxy['key'].should == ['value']
+              proxy['key'].value.should == ['value']
+              proxy['key'].expires.should == expiration
+              proxy['key'].path.should == path
+            end
+          end
+            
+        end
+      
+        describe "with a Symbol key" do
+        
+          it "should accept a String value" do
+            proxy = CookiesProxy.new(self)
+            proxy[:key] = 'value'
+            get :index
+            if ::Rails::VERSION::STRING >= "2.3"
+              proxy[:key].should == 'value'
+            else
+              proxy[:key].should == ['value']
+            end
+          end
+
+          it "should accept a Hash value" do
+            proxy = CookiesProxy.new(self)
+            proxy[:key] = { :value => 'value', :expires => expiration = 1.hour.from_now, :path => path = '/path' }
+            get :index
+            if ::Rails::VERSION::STRING >= "2.3"
+              proxy[:key].should == 'value'
+            else
+              proxy[:key].should == ['value']
+              proxy[:key].value.should == ['value']
+              proxy[:key].expires.should == expiration
+              proxy[:key].path.should == path
+            end
+          end
+
+        end
+    
+        describe "#delete" do
+          it "should delete from the response cookies" do
+            proxy = CookiesProxy.new(self)
+            response_cookies = mock('cookies')
+            response.should_receive(:cookies).and_return(response_cookies)
+            response_cookies.should_receive(:delete).with('key')
+            proxy.delete :key
+          end
+        end
+      end
+    
+    end
+  end
+end

data/spec/spec/rails/example/error_handling_spec.rb

@@ -0,0 +1,90 @@
+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'
+    
+    describe "without use_rails_error_handling!" do
+      describe "with an error that is *not* rescued" do
+        it "raises the error" do
+          lambda do
+            get 'un_rescued_error_action'
+          end.should raise_error(ControllerSpecController::UnRescuedError)
+        end
+      end
+      describe "with an error that *is* rescued" do
+        it "returns a 200" do
+          get 'rescued_error_action'
+          response.response_code.should == 200
+        end
+      end
+    end
+
+    describe "with deprecated use_rails_error_handling!" do
+      before(:each) do
+        Kernel.stub!(:warn)
+      end
+
+      it "warns of deprecation" do
+        Kernel.should_receive(:warn).with(/DEPRECATION NOTICE/)
+        controller.use_rails_error_handling!
+      end
+
+      describe "with an error that is *not* rescued" do
+        it "returns the error code" do
+          controller.use_rails_error_handling!
+          get 'un_rescued_error_action'
+          response.response_code.should == 500
+        end
+      end
+
+      describe "with an error that *is* rescued" do
+        it "returns a 200" do
+          controller.use_rails_error_handling!
+          get 'rescued_error_action'
+          response.response_code.should == 200
+        end
+      end
+    end
+
+    describe "with rescue_action_in_public!" do
+      describe "with an error that is *not* rescued" do
+        it "returns the error code" do
+          rescue_action_in_public!
+          get 'un_rescued_error_action'
+          response.response_code.should == 500
+        end
+      end
+
+      describe "with an error that *is* rescued" do
+        it "returns a 200" do
+          rescue_action_in_public!
+          get 'rescued_error_action'
+          response.response_code.should == 200
+        end
+      end
+    end
+    
+    describe "with bypass_rescue" do
+      describe "with an error that is *not* rescued" do
+        it "raises the error" do
+          bypass_rescue
+          lambda do
+            get 'un_rescued_error_action'
+          end.should raise_error(ControllerSpecController::UnRescuedError)
+        end
+      end
+
+      describe "with an error that *is* rescued" do
+        it "raises the error" do
+          bypass_rescue
+          lambda do
+            get 'rescued_error_action'
+          end.should raise_error(ControllerSpecController::RescuedError)
+        end
+      end
+    end
+  end
+end

data/spec/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 :location => '/blah/spec/models/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '/blah/spec/models/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ModelExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :location => '\\blah\\spec\\models\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '\\blah\\spec\\models\\blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ModelExampleGroup
+      end
+
+      it "should return an ActiveSupport::TestCase when given :location => '/blah/spec/foo/' (anything other than controllers, views and helpers)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '/blah/spec/foo/blah.rb'
+        ) {}
+        example_group.superclass.should == ActiveSupport::TestCase
+      end
+
+      it "should return an ActiveSupport::TestCase when given :location => '\\blah\\spec\\foo\\' (windows format)  (anything other than controllers, views and helpers)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '\\blah\\spec\\foo\\blah.rb'
+        ) {}
+        example_group.superclass.should == ActiveSupport::TestCase
+      end
+
+      it "should return a ViewExampleGroup when given :type => :view" 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 :location => '/blah/spec/views/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '/blah/spec/views/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ViewExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :location => '\\blah\\spec\\views\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '\\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 :location => '/blah/spec/helpers/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '/blah/spec/helpers/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::HelperExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :location => '\\blah\\spec\\helpers\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '\\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 :location => '/blah/spec/controllers/'" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '/blah/spec/controllers/blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ControllerExampleGroup
+      end
+
+      it "should return a ModelExampleGroup when given :location => '\\blah\\spec\\controllers\\' (windows format)" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '\\blah\\spec\\controllers\\blah.rb'
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ControllerExampleGroup
+      end
+
+      it "should favor the :type over the :location" do
+        example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+          "name", :location => '/blah/spec/models/blah.rb', :type => :controller
+        ) {}
+        example_group.superclass.should == Spec::Rails::Example::ControllerExampleGroup
+      end
+    end
+  end
+end

data/spec/spec/rails/example/helper_example_group_spec.rb

@@ -0,0 +1,233 @@
+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
+
+        accesses_configured_helper_methods
+
+        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.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
+      
+      describe HelperExampleGroup, "#assigns", :type => :helper do
+        helper_name :addition
+        it "should expose variables to helper" do
+          assigns[:addend] = 3
+          helper.plus(4).should == 7
+        end
+
+        it "should make helper ivars available in example" do
+          assigns[:addend] = 3
+          assigns[:addend].should == 3
+        end
+      end
+      
+      describe HelperExampleGroup, "using a helper that uses output_buffer inside helper", :type => :helper do
+        helper_name :explicit
+        
+        before(:each) do
+          if Rails::VERSION::STRING <= "2.1"
+            pending("need to get this new feature working against pre 2.2 versions of rails")
+          end
+        end
+
+        it "should not raise an error" do
+          lambda { method_using_output_buffer }.should_not raise_error
+        end
+
+        it "should put the output in the output_buffer" do
+          method_using_output_buffer
+          output_buffer.should == "the_text_from_concat"
+        end
+      end
+
+      describe HelperExampleGroup, "using a helper that tries to access @template", :type => :helper do
+        helper_name :explicit
+
+        it "should not raise an error" do
+          lambda { method_using_template }.should_not raise_error
+        end
+
+        it "should have the correct output" do
+          method_using_template.should have_text(/#some_id/)
+        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
+
+module Bug719
+  # see http://rspec.lighthouseapp.com/projects/5645/tickets/719
+  # FIXME - helper and example provided in ticket. The example did
+  # fail initially, so running it now shows that the bug is fixed,
+  # but this doesn't serve as a good internal example.
+  module ImagesHelper
+    def hide_images_button
+      content_tag :div, :class => :hide_images_button do
+        button_to_function "Hide Images", :id => :hide_images_button do |page|
+          page[:more_images_button].toggle
+          page[:image_browser].toggle
+        end
+      end
+    end
+  end
+  
+  describe ImagesHelper, :type => :helper do
+    it "should render a hide_images_button" do
+      helper.hide_images_button.should have_tag('div[class=?]','hide_images_button') do
+        with_tag('input[id=?][type=?][value=?][onclick^=?]',
+                 'hide_images_button', 'button', 'Hide Images',
+                 "$(&quot;more_images_button&quot;).toggle();\n$(&quot;image_browser&quot;).toggle();;")
+        end
+     end
+  end
+end

data/spec/spec/rails/example/model_example_group_spec.rb

@@ -0,0 +1,20 @@
+require File.dirname(__FILE__) + '/../../../spec_helper'
+
+module Spec
+  module Rails
+    module Example
+      describe ModelExampleGroup do
+        accesses_configured_helper_methods
+        
+        it "clears 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/spec/rails/example/routing_example_group_spec.rb

@@ -0,0 +1,9 @@
+require File.dirname(__FILE__) + '/../../../spec_helper'
+require 'controller_spec_controller'
+require File.join(File.dirname(__FILE__), "/shared_routing_example_group_examples.rb")
+
+describe "Routing Examples", :type => :routing do
+  
+  include RoutingExampleGroupSpec
+
+end

data/spec/spec/rails/example/shared_routing_example_group_examples.rb

@@ -0,0 +1,44 @@
+class CustomRouteSpecController < ActionController::Base; end
+class RspecOnRailsSpecsController < ActionController::Base; end
+
+share_as :RoutingExampleGroupSpec do
+  it "support custom routes" do
+    route_for(:controller => "custom_route_spec", :action => "custom_route").
+      should == "/custom_route"
+  end
+
+  it "support existing routes" do
+    route_for(:controller => "controller_spec", :action => "some_action").
+      should == "/controller_spec/some_action"
+  end
+
+  it "support existing routes with additional parameters" do
+    route_for(:controller => "controller_spec", :action => "some_action", :param => '1').
+      should == "/controller_spec/some_action?param=1"
+  end
+  
+  it "recognize routes with methods besides :get" do
+    route_for(:controller => "rspec_on_rails_specs", :action => "update", :id => "37").
+      should == {:path => "/rspec_on_rails_specs/37", :method => :put}
+  end
+
+  it "generate params for custom routes" do
+    params_from(:get, '/custom_route').
+      should == {:controller => "custom_route_spec", :action => "custom_route"}
+  end
+
+  it "generate params for existing routes" do
+    params_from(:get, '/controller_spec/some_action').
+      should == {:controller => "controller_spec", :action => "some_action"}
+  end
+
+  it "generate params for an existing route with a query parameter" do
+    params_from(:get, '/controller_spec/some_action?param=1').
+      should == {:controller => "controller_spec", :action => "some_action", :param => '1'}
+  end
+
+  it "generate params for an existing route with multiple query parameters" do
+    params_from(:get, '/controller_spec/some_action?param1=1&param2=2').
+      should == {:controller => "controller_spec", :action => "some_action", :param1 => '1', :param2 => '2' }
+  end
+end

data/spec/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