rspec-rails 2.14.0.rc1 → 2.14.0

data/features/controller_specs/bypass_rescue.feature

@@ -0,0 +1,75 @@
+Feature: bypass rescue
+
+  Use `bypass_rescue` to bypass both Rails' default handling of errors in
+  controller actions, and any custom handling declared with a `rescue_from`
+  statement.
+
+  This lets you specify details of the exception being raised, regardless of
+  how it might be handled upstream.
+
+  Background:
+    Given a file named "spec/controllers/gadgets_controller_spec_context.rb" with:
+      """ruby
+      class AccessDenied < StandardError; end
+
+      class ApplicationController < ActionController::Base
+        rescue_from AccessDenied, :with => :access_denied
+
+        private
+
+        def access_denied
+          redirect_to "/401.html"
+        end
+      end
+      """
+
+  Scenario: standard exception handling using `rescue_from`
+    Given a file named "spec/controllers/gadgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      require 'controllers/gadgets_controller_spec_context'
+
+      describe GadgetsController do
+        before do
+          def controller.index
+            raise AccessDenied
+          end
+        end
+
+        describe "index" do
+          it "redirects to the /401.html page" do
+            get :index
+            expect(response).to redirect_to("/401.html")
+          end
+        end
+      end
+      """
+    When I run `rspec spec/controllers/gadgets_controller_spec.rb`
+    Then the examples should all pass
+
+  Scenario: bypass `rescue_from` handling with `bypass_rescue`
+    Given a file named "spec/controllers/gadgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      require 'controllers/gadgets_controller_spec_context'
+
+      describe GadgetsController do
+        before do
+          def controller.index
+            raise AccessDenied
+          end
+        end
+
+        describe "index" do
+          it "raises AccessDenied" do
+            bypass_rescue
+            expect { get :index }.to raise_error(AccessDenied)
+          end
+        end
+      end
+      """
+    When I run `rspec spec/controllers/gadgets_controller_spec.rb`
+    Then the examples should all pass
+

data/features/controller_specs/controller_spec.feature

@@ -0,0 +1,58 @@
+Feature: controller spec
+
+  Scenario: simple passing example
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe WidgetsController do
+        describe "GET index" do
+          it "has a 200 status code" do
+            get :index
+            expect(response.status).to eq(200)
+          end
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the example should pass
+
+  Scenario: controller is exposed to global before hooks
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      RSpec.configure {|c| c.before { expect(controller).not_to be_nil }}
+
+      describe WidgetsController do
+        describe "GET index" do
+          it "doesn't matter" do
+          end
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the example should pass
+
+  Scenario: controller is extended with a helper module
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      module MyHelper
+        def my_variable
+        end
+      end
+
+      RSpec.configure {|c| c.include MyHelper }
+
+      describe WidgetsController do
+        let(:my_variable) { 'is a value' }
+
+        describe 'something' do
+          specify { expect(my_variable).to eq 'is a value' }
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the example should pass

data/features/controller_specs/engine_routes.feature

@@ -0,0 +1,51 @@
+Feature: engine routes for controllers
+
+  Controller specs can specify the routeset that will be used for the example
+  group. This is most useful when testing Rails engines.
+
+  @unsupported-on-rails-3-0
+  Scenario: specify engine route
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+    """ruby
+    require "spec_helper"
+
+    # A very simple Rails engine
+    module MyEngine
+      class Engine < ::Rails::Engine
+        isolate_namespace MyEngine
+      end
+
+      Engine.routes.draw do
+        resources :widgets, :only => [:show] do
+          get :random, :on => :collection
+        end
+      end
+
+      class WidgetsController < ::ActionController::Base
+        def random
+          @random_widget = Widget.all.shuffle.first
+          redirect_to widget_path(@random_widget)
+        end
+
+        def show
+          @widget = Widget.find(params[:id])
+          render :text => @widget.name
+        end
+      end
+    end
+
+    describe MyEngine::WidgetsController do
+      routes { MyEngine::Engine.routes }
+
+      it "redirects to a random widget" do
+        widget1 = Widget.create!(:name => "Widget 1")
+        widget2 = Widget.create!(:name => "Widget 2")
+
+        get :random
+        expect(response).to be_redirect
+        expect(response).to redirect_to(assigns(:random_widget))
+      end
+    end
+    """
+    When I run `rspec spec`
+    Then the examples should all pass

data/features/controller_specs/isolation_from_views.feature

@@ -0,0 +1,87 @@
+Feature: views are stubbed by default
+
+  By default, controller specs stub views with a template that renders an empty
+  string instead of the views in the app. This allows you specify which view
+  template an action should try to render regardless of whether the template
+  compiles cleanly.
+
+  NOTE: unlike rspec-rails-1.x, the real template must exist.
+
+  Scenario: expect template that is rendered by controller action (passes)
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe WidgetsController do
+        describe "index" do
+          it "renders the index template" do
+            get :index
+            expect(response).to render_template("index")
+            expect(response.body).to eq ""
+          end
+          it "renders the widgets/index template" do
+            get :index
+            expect(response).to render_template("widgets/index")
+            expect(response.body).to eq ""
+          end
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the examples should all pass
+
+  Scenario: expect template that is not rendered by controller action (fails)
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe WidgetsController do
+        describe "index" do
+          it "renders the 'new' template" do
+            get :index
+            expect(response).to render_template("new")
+          end
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the output should contain "1 example, 1 failure"
+
+  Scenario: expect empty templates to render when view path is changed at runtime (passes)
+    Given a file named "spec/controllers/things_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe ThingsController do
+        describe "custom_action" do
+          it "renders an empty custom_action template" do
+            controller.prepend_view_path 'app/views'
+            controller.append_view_path 'app/views'
+            get :custom_action
+            expect(response).to render_template("custom_action")
+            expect(response.body).to eq ""
+          end
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the examples should all pass
+
+  Scenario: expect template to render the real template with render_views when view path is changed at runtime
+    Given a file named "spec/controllers/things_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe ThingsController do
+        render_views
+
+        it "renders the real custom_action template" do
+          controller.prepend_view_path 'app/views'
+          get :custom_action
+          expect(response).to render_template("custom_action")
+          expect(response.body).to match(/template for a custom action/)
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the examples should all pass

data/features/controller_specs/render_views.feature

@@ -0,0 +1,114 @@
+Feature: render_views
+
+  You can tell a controller example group to render views with the
+  `render_views` declaration in any individual group, or globally.
+
+  Scenario: render_views directly in a single group
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe WidgetsController do
+        render_views
+
+        describe "GET index" do
+          it "says 'Listing widgets'" do
+            get :index
+            expect(response.body).to match /Listing widgets/m
+          end
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the examples should all pass
+
+  Scenario: render_views on and off in nested groups
+    Given a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe WidgetsController do
+        context "with render_views" do
+          render_views
+
+          describe "GET index" do
+            it "renders the actual template" do
+              get :index
+              expect(response.body).to match /Listing widgets/m
+            end
+          end
+
+          context "with render_views(false) nested in a group with render_views" do
+            render_views false
+
+            describe "GET index" do
+              it "renders the RSpec generated template" do
+                get :index
+                expect(response.body).to eq("")
+              end
+            end
+          end
+        end
+
+        context "without render_views" do
+          describe "GET index" do
+            it "renders the RSpec generated template" do
+              get :index
+              expect(response.body).to eq("")
+            end
+          end
+        end
+
+        context "with render_views again" do
+          render_views
+
+          describe "GET index" do
+            it "renders the actual template" do
+              get :index
+              expect(response.body).to match /Listing widgets/m
+            end
+          end
+        end
+      end
+      """
+    When I run `rspec spec --order default --format documentation`
+    Then the output should contain:
+      """ruby
+      WidgetsController
+        with render_views
+          GET index
+            renders the actual template
+          with render_views(false) nested in a group with render_views
+            GET index
+              renders the RSpec generated template
+        without render_views
+          GET index
+            renders the RSpec generated template
+        with render_views again
+          GET index
+            renders the actual template
+      """
+
+  Scenario: render_views globally
+    Given a file named "spec/support/render_views.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.render_views
+      end
+      """
+    And a file named "spec/controllers/widgets_controller_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe WidgetsController do
+        describe "GET index" do
+          it "renders the index template" do
+            get :index
+            expect(response.body).to match /Listing widgets/m
+          end
+        end
+      end
+      """
+    When I run `rspec spec`
+    Then the examples should all pass
+    

data/features/feature_specs/feature_spec.feature

@@ -0,0 +1,34 @@
+Feature: feature spec
+
+  Feature specs are high-level tests meant to exercise slices of functionality
+  through an application. They should drive the application only via its
+  external interface, usually web pages.
+
+  Feature specs require the [capybara](http://github.com/jnicklas/capybara)
+  gem, version 2.0.0 or later. Refer to the [capybara API
+  documentation](http://rubydoc.info/github/jnicklas/capybara/master) for more
+  information on the methods and matchers that can be used in feature specs.
+
+  The `feature` and `scenario` DSL correspond to `describe` and `it`,
+  respectively. These methods are simply aliases that allow feature specs to
+  read more as [customer tests](http://c2.com/cgi/wiki?CustomerTest) and
+  [acceptance tests](http://c2.com/cgi/wiki?AcceptanceTest).
+
+  Scenario: specify creating a Widget by driving the application with capybara
+    Given a file named "spec/features/widget_management_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      feature "Widget management" do
+        scenario "User creates a new widget" do
+          visit "/widgets/new"
+
+          fill_in "Name", :with => "My Widget"
+          click_button "Create Widget"
+
+          expect(page).to have_text("Widget was successfully created.")
+        end
+      end
+      """
+    When I run `rspec spec/features/widget_management_spec.rb`
+    Then the example should pass

data/features/helper_specs/helper_spec.feature

@@ -0,0 +1,122 @@
+Feature: helper spec
+
+  Helper specs live in `spec/helpers`, or any example group with `:type =>
+  :helper`.
+
+  Helper specs expose a `helper` object, which includes the helper module being
+  specified, the `ApplicationHelper` module (if there is one) and all of the
+  helpers built into Rails. It does not include the other helper modules in
+  your app.
+
+  To access the helper methods you're specifying, simply call them directly
+  on the `helper` object.
+
+  NOTE: helper methods defined in controllers are not included.
+
+  Scenario: helper method that returns a value
+    Given a file named "spec/helpers/application_helper_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe ApplicationHelper do
+        describe "#page_title" do
+          it "returns the default title" do
+            expect(helper.page_title).to eq("RSpec is your friend")
+          end
+        end
+      end
+      """
+    And a file named "app/helpers/application_helper.rb" with:
+      """ruby
+      module ApplicationHelper
+        def page_title
+          "RSpec is your friend"
+        end
+      end
+      """
+    When I run `rspec spec/helpers/application_helper_spec.rb`
+    Then the examples should all pass
+
+  Scenario: helper method that accesses an instance variable
+    Given a file named "spec/helpers/application_helper_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe ApplicationHelper do
+        describe "#page_title" do
+          it "returns the instance variable" do
+            assign(:title, "My Title")
+            expect(helper.page_title).to eql("My Title")
+          end
+        end
+      end
+      """
+    And a file named "app/helpers/application_helper.rb" with:
+      """ruby
+      module ApplicationHelper
+        def page_title
+          @title || nil
+        end
+      end
+      """
+    When I run `rspec spec/helpers/application_helper_spec.rb`
+    Then the examples should all pass
+
+  Scenario: application helper is included in helper object
+    Given a file named "spec/helpers/widgets_helper_spec.rb" with:
+      """ruby
+      require "spec_helper"
+
+      describe WidgetsHelper do
+        describe "#widget_title" do
+          it "includes the app name" do
+            assign(:title, "This Widget")
+            expect(helper.widget_title).to eq("The App: This Widget")
+          end
+        end
+      end
+      """
+    And a file named "app/helpers/application_helper.rb" with:
+      """ruby
+      module ApplicationHelper
+        def app_name
+          "The App"
+        end
+      end
+      """
+    And a file named "app/helpers/widgets_helper.rb" with:
+      """ruby
+      module WidgetsHelper
+        def widget_title
+          "#{app_name}: #{@title}"
+        end
+      end
+      """
+    When I run `rspec spec/helpers/widgets_helper_spec.rb`
+    Then the examples should all pass
+
+  Scenario: url helpers are defined
+    Given a file named "spec/helpers/widgets_helper_spec.rb" with:
+    """ruby
+    require "spec_helper"
+
+    describe WidgetsHelper do
+      describe "#link_to_widget" do
+        it "links to a widget using its name" do
+          widget = Widget.create!(:name => "This Widget")
+          expect(helper.link_to_widget(widget)).to include("This Widget")
+          expect(helper.link_to_widget(widget)).to include(widget_path(widget))
+        end
+      end
+    end
+    """
+    And a file named "app/helpers/widgets_helper.rb" with:
+    """ruby
+    module WidgetsHelper
+      def link_to_widget(widget)
+        link_to(widget.name, widget_path(widget))
+      end
+    end
+    """
+    When I run `rspec spec/helpers/widgets_helper_spec.rb`
+    Then the examples should all pass