richzhou-rspec-rails 1.3.4

data/lib/spec/rails/example/assigns_hash_proxy.rb

@@ -0,0 +1,39 @@
+module Spec
+  module Rails
+    module Example
+      class AssignsHashProxy #:nodoc:
+        def initialize(example_group, &block)
+          @target = block.call
+          @example_group = example_group
+        end
+
+        def [](key)
+          return false if false == assigns[key] || false == assigns[key.to_s]
+          assigns[key] || assigns[key.to_s] || @target.instance_variable_get("@#{key}")
+        end
+
+        def []=(key, val)
+          @target.instance_variable_set("@#{key}", val)
+        end
+
+        def delete(key)
+          assigns.delete(key.to_s)
+          @target.instance_variable_set("@#{key}", nil)
+        end
+
+        def each(&block)
+          assigns.each &block
+        end
+
+        def has_key?(key)
+          assigns.key?(key.to_s)
+        end
+
+        protected
+        def assigns
+          @example_group.orig_assigns
+        end
+      end
+    end
+  end
+end

data/lib/spec/rails/example/controller_example_group.rb

@@ -0,0 +1,285 @@
+module Spec
+  module Rails
+    module Example
+      # Controller Examples live in $RAILS_ROOT/spec/controllers/.
+      #
+      # Controller Examples use Spec::Rails::Example::ControllerExampleGroup,
+      # which supports running specs for Controllers in two modes, which
+      # represent the tension between the more granular testing common in TDD
+      # and the more high level testing built into rails. BDD sits somewhere
+      # in between: we want to a balance between specs that are close enough
+      # to the code to enable quick fault isolation and far enough away from
+      # the code to enable refactoring with minimal changes to the existing
+      # specs.
+      #
+      # == Isolation mode (default)
+      #
+      # No dependencies on views because none are ever rendered. The benefit
+      # of this mode is that can spec the controller completely independent of
+      # the view, allowing that responsibility to be handled later, or by
+      # somebody else. Combined w/ separate view specs, this also provides
+      # better fault isolation.
+      #
+      # == Integration mode
+      #
+      # To run in this mode, include the +integrate_views+ declaration
+      # in your controller context:
+      #
+      #   describe ThingController do
+      #     integrate_views
+      #     ...
+      #
+      # In this mode, controller specs are run in the same way that rails
+      # functional tests run - one set of tests for both the controllers and
+      # the views. The benefit of this approach is that you get wider coverage
+      # from each spec. Experienced rails developers may find this an easier
+      # approach to begin with, however we encourage you to explore using the
+      # isolation mode and revel in its benefits.
+      #
+      # == Expecting Errors
+      #
+      # Rspec on Rails will raise errors that occur in controller actions and
+      # are not rescued or handeled with rescue_from.
+      #
+      class ControllerExampleGroup < FunctionalExampleGroup
+        class << self
+
+          # Use integrate_views to instruct RSpec to render views in
+          # your controller examples in Integration mode.
+          #
+          #   describe ThingController do
+          #     integrate_views
+          #     ...
+          #
+          # See Spec::Rails::Example::ControllerExampleGroup for more
+          # information about Integration and Isolation modes.
+          def integrate_views(integrate_views = true)
+            @integrate_views = integrate_views
+          end
+
+          def integrate_views? # :nodoc:
+            @integrate_views
+          end
+
+          def inherited(klass) # :nodoc:
+            klass.integrate_views(integrate_views?)
+            klass.subject { controller }
+            super
+          end
+
+          def set_description(*args) # :nodoc:
+            super
+            if described_class && described_class.ancestors.include?(ActionController::Base)
+              controller_klass = if superclass.controller_class.ancestors.include?(ActionController::Base)
+                superclass.controller_class
+              else
+                described_class
+              end
+              tests controller_klass
+            end
+          end
+
+          # When you don't pass a controller to describe, like this:
+          #
+          #   describe ThingsController do
+          #
+          # ... then you must provide a controller_name within the context of
+          # your controller specs:
+          #
+          #   describe "ThingController" do
+          #     controller_name :thing
+          #     ...
+          def controller_name(name)
+            tests "#{name}_controller".camelize.constantize
+          end
+        end
+
+        before(:each) do
+          # Some Rails apps explicitly disable ActionMailer in environment.rb
+          if defined?(ActionMailer)
+            @deliveries = []
+            ActionMailer::Base.deliveries = @deliveries
+          end
+
+          unless @controller.class.ancestors.include?(ActionController::Base)
+            Spec::Expectations.fail_with <<-MESSAGE
+Controller specs need to know what controller is being specified. You can
+indicate this by passing the controller to describe():
+
+  describe MyController do
+
+or by declaring the controller's name
+
+  describe "a MyController" do
+    controller_name :my #invokes the MyController
+end
+MESSAGE
+          end
+          @controller.extend ControllerInstanceMethods
+          @controller.integrate_views! if integrate_views?
+          @controller.session = session
+        end
+
+        attr_reader :response, :request, :controller
+
+        def integrate_views?
+          @integrate_views || self.class.integrate_views?
+        end
+
+        # Bypasses any error rescues defined with rescue_from. Useful
+        # in cases in which you want to specify errors coming out of
+        # actions that might be caught by a rescue_from clause that is
+        # specified separately.
+        #
+        # Note that this will override the effect of rescue_action_in_public
+        def bypass_rescue
+          if ::Rails::VERSION::STRING >= '2.2'
+            def controller.rescue_action(exception)
+              raise exception
+            end
+          else
+            def controller.rescue_action_with_handler(exception)
+              raise exception
+            end
+          end
+        end
+
+      protected
+
+        def _assigns_hash_proxy
+          @_assigns_hash_proxy ||= AssignsHashProxy.new(self) {@response.template}
+        end
+
+      private
+
+        module TemplateIsolationExtensions
+          def file_exists?(ignore); true; end
+
+          def render_file(*args)
+            @first_render ||= args[0] unless args[0] =~ /^layouts/
+          end
+
+          # Rails 2.2
+          def _pick_template(*args)
+            @_first_render ||= args[0] unless args[0] =~ /^layouts/
+            PickedTemplate.new
+          end
+
+          def __action_exists?(params)
+            controller.respond_to? params[:action]
+          end
+
+          def __template_exists?(args)
+            self.view_paths.respond_to?(:find_template) ?
+              self.view_paths.find_template(args[0][:file], template_format) :
+              false
+          end
+
+          def render(*args)
+            if ::Rails::VERSION::STRING >= "2.1"
+              return super unless __action_exists?(params) || __template_exists?(args)
+            end
+            if file = args.last[:file].instance_eval{@template_path}
+              record_render :file => file
+            elsif args.last[:inline]
+              super
+            elsif @_rendered
+              record_render(args[0])
+            else
+              super
+            end
+          end
+
+        private
+
+          def record_render(opts)
+            return unless @_rendered
+            @_rendered[:template] ||= opts[:file] if opts[:file]
+            @_rendered[:partials][opts[:partial]] += 1 if opts[:partial]
+          end
+
+          # Returned by _pick_template when running controller examples in isolation mode.
+          class PickedTemplate
+            # Do nothing when running controller examples in isolation mode.
+            def render_template(*ignore_args); end
+            # Do nothing when running controller examples in isolation mode.
+            def render_partial(*ignore_args);  end
+          end
+        end
+
+        module ControllerInstanceMethods # :nodoc:
+          include Spec::Rails::Example::RenderObserver
+
+          # === render(options = nil, extra_options={}, &block)
+          #
+          # This gets added to the controller's singleton meta class,
+          # allowing Controller Examples to run in two modes, freely switching
+          # from example group to example group.
+          def render(options=nil, extra_options={}, &block)
+            unless block_given?
+              unless integrate_views?
+                @template.extend TemplateIsolationExtensions
+              end
+            end
+
+            if matching_message_expectation_exists(options)
+              render_proxy.render(options, &block)
+              @performed_render = true
+            else
+              if matching_stub_exists(options)
+                @performed_render = true
+              else
+                if ::Rails::VERSION::STRING > '2.1'
+                  super(options, extra_options, &block)
+                else
+                  super(options, &block)
+                end
+              end
+            end
+          end
+
+          # Rails 2.3
+          def default_template(action_name = self.action_name)
+            if integrate_views?
+              super
+            else
+              begin
+                super
+              rescue ActionView::MissingTemplate
+                "#{self.class.name.sub(/Controller$/,'').underscore}/#{action_name}"
+              end
+            end
+          end
+
+          def response(&block)
+            # NOTE - we're setting @update for the assert_select_spec - kinda weird, huh?
+            @update = block
+            super
+          end
+
+          def integrate_views!
+            @integrate_views = true
+          end
+
+        private
+
+          def integrate_views?
+            @integrate_views
+          end
+
+          def matching_message_expectation_exists(options)
+            render_proxy.__send__(:__mock_proxy).__send__(:find_matching_expectation, :render, options)
+          end
+
+          def matching_stub_exists(options)
+            render_proxy.__send__(:__mock_proxy).__send__(:find_matching_method_stub, :render, options)
+          end
+
+        end
+
+        Spec::Example::ExampleGroupFactory.register(:controller, self)
+
+      end
+    end
+  end
+end

data/lib/spec/rails/example/cookies_proxy.rb

@@ -0,0 +1,29 @@
+require 'action_controller/cookies'
+
+module Spec
+  module Rails
+    module Example
+      class CookiesProxy
+        def initialize(example)
+          @example = example
+        end
+      
+        def[]=(name, value)
+          if ::Rails::VERSION::STRING >= '2.3'
+            @example.request.cookies[name.to_s] = value
+          else
+            @example.request.cookies[name.to_s] = CGI::Cookie.new(name.to_s, value)
+          end
+        end
+        
+        def [](name)
+          @example.response.cookies[name.to_s]
+        end
+      
+        def delete(name)
+          @example.response.cookies.delete(name.to_s)
+        end
+      end
+    end
+  end
+end

data/lib/spec/rails/example/functional_example_group.rb

@@ -0,0 +1,106 @@
+require 'action_controller/test_case'
+
+module Spec
+  module Rails
+    module Example
+      class FunctionalExampleGroup < ActionController::TestCase
+        def setup
+          # no-op to override AC::TC's setup w/ conflicts with the before(:each) below
+        end
+
+        attr_reader :request, :response
+
+        # The params hash accessed within a view or helper. Use this before
+        # rendering a view or calling a helper to provide data used by the
+        # view or helper.
+        #
+        # == Examples
+        #   # in a view spec
+        #   params[:name] = "David"
+        #   render
+        #   response.should have_tag("div.name","David")
+        #    
+        #   # in a helper spec
+        #   params[:first_name] = "David"
+        #   params[:last_name] = "Chelimsky"
+        #   helper.full_name.should == "David Chelimsky"
+        def params
+          request.parameters
+        end
+
+        # Provides access to the flash hash. Use this after rendering a
+        # view, calling a helper or calling a controller action.
+        #
+        # == Examples
+        #   post :create
+        #   flash[:notice].should == "Success!"
+        def flash
+          @controller.__send__ :flash
+        end
+
+        # Provides access to the session hash. Use this before or after
+        # rendering a view, calling a helper or calling a controller action.
+        def session
+          request.session
+        end
+        
+        # Overrides the <tt>cookies()</tt> method in
+        # ActionController::TestResponseBehaviour, returning a proxy that
+        # accesses the requests cookies when setting a cookie and the
+        # responses cookies when reading one. This allows you to set and read
+        # cookies in examples using the same API with which you set and read
+        # them in controllers.
+        #
+        # == Examples (Rails 2.0 > 2.2)
+        #
+        #   cookies[:user_id] = {:value => '1234', :expires => 1.minute.ago}
+        #   get :index
+        #   response.should be_redirect
+        #
+        # == Examples (Rails 2.3)
+        #
+        # Rails 2.3 changes the way cookies are made available to functional
+        # tests (and therefore rspec controller specs), only making single
+        # values available with no access to other aspects of the cookie. This
+        # is backwards-incompatible, so you have to change your examples to
+        # look like this:
+        #
+        #   cookies[:foo] = 'bar'
+        #   get :index
+        #   cookies[:foo].should == 'bar'
+        def cookies
+          @cookies ||= Spec::Rails::Example::CookiesProxy.new(self)
+        end
+        
+        alias_method :orig_assigns, :assigns
+
+        # :call-seq:
+        #   assigns()
+        #
+        # Hash of instance variables to values that are made available to
+        # views. == Examples
+        #
+        #   #in thing_controller.rb
+        #   def new
+        #     @thing = Thing.new
+        #   end
+        #
+        #   #in thing_controller_spec
+        #   get 'new'
+        #   assigns[:registration].should == Thing.new
+        #--
+        # NOTE - Even though docs only use assigns[:key] format, this supports
+        # assigns(:key) for backwards compatibility.
+        #++
+        def assigns(key = nil)
+          if key.nil?
+            _assigns_hash_proxy
+          else
+            _assigns_hash_proxy[key]
+          end
+        end
+
+      end
+    end
+  end
+end