Documents how to use the new routes DSL with controller specs

Author: alindeman

features/.nav

@@ -17,6 +17,7 @@
   - render_views.feature
   - anonymous_controller.feature
   - bypass_rescue.feature
+  - engine_routes.feature
 - matchers:
   - new_record_matcher.feature
   - render_template_matcher.feature
@@ -37,3 +38,4 @@
   - route_to_matcher.feature
   - be_routable_matcher.feature
   - named_routes.feature
+  - engine_routes.feature

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