cucumber-rails 0.3.0 → 1.0.0

data/features/allow_rescue.feature

@@ -0,0 +1,63 @@
+Feature: Allow Cucumber to rescue exceptions
+
+  Background: A controller that raises an exception in a Rails app without web_steps.rb
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    And I remove the file "features/step_definitions/web_steps.rb"
+    And I write to "app/controllers/posts_controller.rb" with:
+      """
+      class PostsController < ApplicationController
+        def index
+          raise "There is an error in index"
+        end
+      end
+      """
+    And I write to "config/routes.rb" with:
+      """
+      Rails3App::Application.routes.draw do
+        resources :posts
+      end
+      """
+
+  Scenario: Allow rescue
+    And I write to "features/posts.feature" with:
+      """
+      Feature: posts
+        @allow-rescue
+        Scenario: See posts
+          When I look at the posts
+      """
+    And I write to "features/step_definitions/posts_steps.rb" with:
+      """
+      When /^I look at the posts$/ do
+        visit '/posts'
+      end
+      """
+    And I run `bundle exec rake db:migrate`
+    And I run `bundle exec cucumber`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      1 step (1 passed)
+      """
+
+  Scenario: Don't allow rescue
+    Given I write to "features/posts.feature" with:
+      """
+      Feature: posts
+        Scenario: See them
+          When I look at the posts
+      """
+    And I write to "features/step_definitions/posts_steps.rb" with:
+      """
+      When /^I look at the posts$/ do
+        visit '/posts'
+      end
+      """
+    And I run `bundle exec rake db:migrate`
+    And I run `bundle exec cucumber`
+    Then it should fail with:
+       """
+       1 scenario (1 failed)
+       1 step (1 failed)
+       """
+

data/features/capybara_javascript_drivers.feature

@@ -0,0 +1,87 @@
+Feature: Capybara Javascript Drivers
+
+  Background: A simple calendar app
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    And I successfully run `bundle exec rails g scaffold appointment name:string when:datetime`
+
+  Scenario Outline: Use a particular driver
+    Given I write to "features/create_appointment.feature" with:
+      """
+      @javascript
+      Feature: Create appointments
+        Scenario: Constitution on May 17
+          Given I am on the new appointment page
+          And I fill in "Norway's constitution" for "Name"
+          And I select "2009-02-20 15:10:00 UTC" as the "When" date and time
+          And I press "Create Appointment"
+          Then I should see "Norway's constitution"
+          And I should see "2009-02-20 15:10:00 UTC"
+
+      """
+    And I append to "Gemfile" with:
+      """
+      <Gemfile extra>
+
+      """
+    And I append to "features/support/env.rb" with:
+      """
+      <env.rb extra>
+
+      """
+
+    When I run `bundle exec rake db:migrate`
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      6 steps (6 passed)
+      """
+
+    Examples:
+      | Gemfile extra                    | env.rb extra       |
+      | gem "capybara", :group => :test  | require 'capybara' |
+
+  Scenario Outline: Mixed DB access
+    Given I write to "features/create_appointment.feature" with:
+      """
+      @javascript
+      Feature: Create appointments
+        Scenario: Constitution on May 17
+          Given a random appointment
+          And I am viewing random appointment
+          Then I should see "Random appointment"
+
+      """
+    And I write to "features/step_definitions/custom_steps.rb" with:
+      """
+      Given /^a random appointment$/ do
+        @appointment = Appointment.create!(:name => 'Random appointment', :when => DateTime.now)
+      end
+
+      Given /^I am viewing random appointment$/ do
+        visit appointment_path(@appointment)
+      end
+      """
+    And I append to "Gemfile" with:
+      """
+      <Gemfile extra>
+
+      """
+    And I append to "features/support/env.rb" with:
+      """
+      <env.rb extra>
+
+      """
+
+    When I run `bundle exec rake db:migrate`
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      3 steps (3 passed)
+      """
+
+    Examples:
+      | Gemfile extra                    | env.rb extra       |
+      | gem "capybara", :group => :test  | require 'capybara' |
+

data/features/database_cleaner.feature

@@ -0,0 +1,44 @@
+Feature: DatabaseCleaner
+
+  Scenario: Create records in background
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    And I write to "features/widgets.feature" with:
+      """
+      Feature: Create widgets
+        Background: some widdgets
+          Given I have 2 widgets
+      
+        Scenario: Add 3
+          When I create 3 more widgets
+          Then I should have 5 widgets
+
+        Scenario: Add 7
+          When I create 7 more widgets
+          Then I should have 9 widgets
+      """
+    And I successfully run `rails generate model widget name:string`
+    And I write to "features/step_definitions/widget_steps.rb" with:
+      """
+      Given /^I have (\d+) widgets$/ do |n|
+        n.to_i.times do |i|
+          Widget.create! :name => "Widget #{Widget.count + i}"
+        end
+      end
+
+      When /^I create (\d+) more widgets$/ do |n|
+        n.to_i.times do |i|
+          Widget.create! :name => "Widget #{Widget.count + i}"
+        end
+      end
+
+      Then /^I should have (\d+) widgets$/ do |n|
+        Widget.count.should == n.to_i
+      end
+      """
+    And I run `bundle exec rake db:migrate`
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+       """
+       2 scenarios (2 passed)
+       6 steps (6 passed)
+       """

data/features/emulate_javascript.feature

@@ -0,0 +1,34 @@
+Feature: Emulate Javascript
+
+  Scenario: See a widget
+    Given I have created a new Rails 3 app "widgets" with cucumber-rails support
+    And I successfully run `rails generate scaffold widget name:string`
+    And I write to "features/f.feature" with:
+      """
+      @javascript
+      Feature: Widget inventory
+        Scenario: Delete a widget
+          Given there is a widget named "wrench"
+          When I go to the widgets page
+          Then I should see "wrench"
+      """
+    And I write to "features/step_definitions/s.rb" with:
+      """
+      Given /^there is a widget named "([^"]*)"$/ do |name|
+        Factory(:widget, :name => name)
+      end
+      """
+    And I write to "features/support/factories.rb" with:
+      """
+      Factory.define :widget do |f| 
+        f.name 'testwidget'
+      end
+      """
+    When I run `bundle exec rake db:migrate`
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+       """
+       1 scenario (1 passed)
+       3 steps (3 passed)
+       """
+

data/features/inspect_query_string.feature

@@ -0,0 +1,37 @@
+Feature: Inspect query string
+
+  Scenario: Inspect query string
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    And I successfully run `rails generate cucumber:feature post title:string body:text number:integer published:boolean`
+    And I successfully run `rails generate scaffold post title:string body:text number:integer published:boolean`
+    And I successfully run `rails generate scaffold cuke name:string`
+    And I overwrite "app/controllers/cukes_controller.rb" with:
+      """
+      class CukesController < ApplicationController
+        def index
+          redirect_to cuke_path(10, {:name => 'cucumber', :what => 'vegetable'})
+        end
+        
+        def show
+          render :text => "Cuke #{params[:id]}"
+        end
+      end
+      """
+    And I write to "features/tests.feature" with:
+      """
+      Feature: Tests
+        Scenario: Tests
+          When I go to the cukes page
+          Then I should have the following query string: 
+            | name | cucumber  |
+            | what | vegetable |
+          And I should see "Cuke 10"
+      """
+    And I run `bundle exec rake db:migrate`
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+       """
+       3 scenarios (3 passed)
+       16 steps (16 passed)
+       """
+

data/features/install_cucumber_rails.feature

@@ -0,0 +1,16 @@
+Feature: Rails 3
+  In order to take over the world
+  Cucumber-Rails should work on major versions
+  of Rails 3 and Ruby, with Capybara, Spork and DatabaseCleaner
+
+  Scenario: Install Cucumber-Rails
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    Then the following files should exist:
+      | config/cucumber.yml                    |
+      | script/cucumber                        |
+      | features/step_definitions/web_steps.rb |
+      | features/support/env.rb                |
+      | features/support/paths.rb              |
+      | features/support/selectors.rb          |
+      | lib/tasks/cucumber.rake                |
+    And the file "features/support/env.rb" should contain "require 'cucumber/rails'"

data/features/mongoid.feature

@@ -0,0 +1,53 @@
+@announce
+Feature: Mongoid
+
+  Scenario: Keep Mongoid happy
+    Given I successfully run `rails new cuke-app`
+    And I cd to "cuke-app"
+    And I write to "config/application.rb" with:
+      """
+      require File.expand_path('../boot', __FILE__)
+
+      require 'action_controller/railtie'
+      require 'action_mailer/railtie'
+      require 'active_resource/railtie'
+      require 'rails/test_unit/railtie'
+
+      Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+      module CukeApp
+        class Application < Rails::Application
+          config.encoding = "utf-8"
+          config.filter_parameters += [:password]
+        end
+      end
+      """
+    And I remove the file "config/database.yml"
+    And I append to "Gemfile" with:
+      """
+      gem "cucumber-rails", :group => :test, :path => '../../..'
+      gem "capybara", :group => :test
+      gem "database_cleaner", :group => :test
+      gem "mongoid", :group => :test
+      gem "bson_ext", :group => :test
+
+      """
+    And I successfully run `bundle exec rails generate cucumber:install`
+    And I successfully run `bundle exec rails generate mongoid:config`
+    And I write to "features/tests.feature" with:
+      """
+      Feature: Tests
+        Scenario: Tests
+          When I go to the home page
+      """
+    And I overwrite "features/support/env.rb" with:
+      """
+      require 'cucumber/rails'
+      DatabaseCleaner.strategy = :truncation
+      """
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      1 step (1 passed)
+      """

data/features/multiple_databases.feature

@@ -0,0 +1,74 @@
+Feature: Multiple Databases
+  In order to use Database Cleaner with multiple database repositories
+  As an engineer
+  I want to specify explicit strategies for each
+
+  Background: A Rails 3 app utilizing multiple database repositories exists
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    And I remove the file "features/step_definitions/web_steps.rb"
+    And I append to "config/database.yml" with:
+      """
+
+      ursidae:
+        adapter: sqlite3
+        database: db/ursidae.sqlite3
+      """
+    And I write to "app/models/bear.rb" with:
+      """
+      class Bear < ActiveRecord::Base
+        establish_connection "ursidae"
+      end
+      """
+    And a directory named "db/migrate"
+    And I write to "db/migrate/001_create_bears.rb" with:
+      """
+      class CreateBears < ActiveRecord::Migration
+        def self.up
+          if Rails.env == 'ursidae'
+            create_table :bears do |t|
+              t.string :name, :null => false
+            end
+            add_index :bears, :name,  :unique => true
+          end
+        end
+      end
+      """
+    And I successfully run `bundle exec rake db:migrate`
+    And I successfully run `bundle exec rake db:migrate RAILS_ENV=ursidae`
+    And I write to "features/support/env.rb" with:
+      """
+      require 'cucumber/rails'
+      DatabaseCleaner.strategy = :transaction
+      DatabaseCleaner[:active_record, {:connection => "ursidae"}].strategy = :truncation
+      """
+    And I write to "features/create_bear.feature" with:
+      """
+      Feature: Screws up in transactional test and must use truncation
+        Scenario: I create a bear
+          When I create a bear
+          And something transactional happens
+      """
+    And I write to "features/step_definitions/create_bear_steps.rb" with:
+      """
+      When /^I create a bear$/ do
+        Bear.create!(:name => "yogi")
+      end
+      When /^something transactional happens$/ do
+        Bear.transaction { Bear.find_by_name("yogi").lock! }
+      end
+      """
+
+  Scenario: Default transactional strategy is not attempted on second database
+    When I run `bundle exec rake cucumber FEATURE=features/create_bear.feature`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      2 steps (2 passed)
+      """
+    And the output should not contain "cannot rollback - no transaction is active"
+
+  Scenario: Truncation strategy is used on the second database
+    Given I successfully run `bundle exec rails runner 'Bear.create(:name => "boo boo")'`
+    And I successfully run `bundle exec rake cucumber FEATURE=features/create_bear.feature`
+    When I run `bundle exec rails runner 'raise "ahh! bears!" if Bear.count > 0'`
+    Then the exit status should be 0

data/features/named_selectors.feature

@@ -0,0 +1,33 @@
+Feature: Named Selectors
+
+  Scenario: Look within named selector
+    Given a project without ActiveRecord
+    And a cukes resource
+    And I write to "app/views/cukes/index.html.erb" with:
+      """
+      <div class="foo">foo</div>
+      <div class="bar">bar</div>
+      """
+    And I write to "features/tests.feature" with:
+      """
+      Feature: Tests
+        Scenario: Tests
+          When I go to the cukes page
+          Then I should see "foo" within the foo div
+          And I should not see "bar" within the foo div
+      """
+    And I overwrite "features/support/selectors.rb" with:
+      """
+      module HtmlSelectorsHelpers
+        def selector_for(locator)
+          return '.foo' if locator == 'the foo div'
+        end
+      end
+      World(HtmlSelectorsHelpers)
+      """
+    And I run `rake cucumber`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      3 steps (3 passed)
+      """

data/features/no_database.feature

@@ -0,0 +1,70 @@
+@announce
+Feature: No Database
+  Allow Cucumber to work with a Rails app without a database
+
+  Scenario: No ActiveRecord and DatabaseCleaner
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    # Turn off ActiveRecord
+    And I write to "config/application.rb" with:
+      """
+      require File.expand_path('../boot', __FILE__)
+
+      require 'action_controller/railtie'
+      require 'action_mailer/railtie'
+      require 'active_resource/railtie'
+      require 'rails/test_unit/railtie'
+
+      Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+      module Rails3App
+        class Application < Rails::Application
+          config.encoding = "utf-8"
+          config.filter_parameters += [:password]
+        end
+      end
+      """
+    And I remove the file "config/database.yml"
+    And I overwrite "features/support/env.rb" with:
+      """
+      require 'cucumber/rails'
+      """
+    # Remove DatabaseCleaner and SQLite
+    And I write to "Gemfile" with:
+      """
+      source 'http://rubygems.org'
+      gem 'rails'
+      gem "cucumber-rails", :group => :test, :path => "../../.."
+      gem "capybara", :group => :test
+      gem "rspec-rails", :group => :test
+      """
+    And I write to "app/controllers/posts_controller.rb" with:
+      """
+      class PostsController < ApplicationController
+        def index
+          raise "There is an error in index"
+        end
+      end
+      """
+    And I write to "config/routes.rb" with:
+      """
+      Rails3App::Application.routes.draw do
+        resources :posts
+      end
+      """
+    And I write to "features/posts.feature" with:
+      """
+      Feature: posts
+        Scenario: See them
+          When I do it
+      """
+    And I write to "features/step_definitions/posts_steps.rb" with:
+      """
+      When /^I do it$/ do
+        visit '/posts'
+      end
+      """
+    And I run `bundle exec rake cucumber`
+    Then it should fail with:
+      """
+      There is an error in index
+      """

data/features/pseduo_class_selectors.feature

@@ -0,0 +1,24 @@
+Feature: Pseudo-class Selectors
+
+  Scenario: Look within css pseudo-class selectors
+    Given a project without ActiveRecord
+    And a cukes resource
+    And I write to "app/views/cukes/index.html.erb" with:
+      """
+      <div>foo</div>
+      <div>bar</div>
+      """
+    And I write to "features/tests.feature" with:
+      """
+      Feature: Tests
+        Scenario: Tests
+          When I go to the cukes page
+          Then I should see "bar" within "div:nth-child(2)"
+          And I should not see "foo" within "div:nth-child(2)"
+      """
+    And I run `rake cucumber`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      3 steps (3 passed)
+      """

data/features/rerun_profile.feature

@@ -0,0 +1,38 @@
+Feature: Rerun profile
+  In order to concentrate on failing features
+  As a Rails developer working with Cucumber
+  I want to rerun only failing features
+
+  Scenario: Rerun
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    And a file named "rerun.txt" with:
+      """
+      features/rerun_test.feature:2
+      """
+    And a file named "features/rerun_test.feature" with:
+      """
+      Feature: Rerun test
+        Scenario: failing before
+          Given fixed now
+
+        Scenario: always passing
+          Given passing
+      """
+    And a file named "features/step_definitions/rerun_steps.rb" with:
+      """
+      Given /fixed now/ do
+        puts "All fixed now"
+      end
+
+      Given /passing/ do
+        puts "I've always been passing"
+      end
+      """
+    When I successfully run `bundle exec cucumber -p rerun`
+    Then it should pass with:
+      """
+      1 scenario (1 passed)
+      1 step (1 passed)
+      """
+    And the file "rerun.txt" should not contain "features/rerun_test.feature:2"
+    

data/features/rest_api.feature

@@ -0,0 +1,47 @@
+Feature: REST API
+
+  Scenario: Compare JSON
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    And I write to "app/controllers/posts_controller.rb" with:
+      """
+      class PostsController < ApplicationController
+        def index
+          render :json => {'hello' => 'world'}.to_json
+        end
+      end
+      """
+    And I write to "config/routes.rb" with:
+      """
+      Rails3App::Application.routes.draw do
+        resources :posts
+      end
+      """
+    And I write to "features/posts.feature" with:
+      """
+      Feature: posts
+        Scenario: See them
+          When the client requests GET /posts
+          Then the response should be JSON:
+            \"\"\"
+            {
+              "hello": "world"
+            }
+            \"\"\"
+      """
+    And I write to "features/step_definitions/rest_steps.rb" with:
+      """
+      When /^the client requests GET (.*)$/ do |path|
+        get(path)
+      end
+
+      Then /^the response should be JSON:$/ do |json|
+        JSON.parse(last_response.body).should == JSON.parse(json)
+      end
+      """
+    And I run `bundle exec rake db:migrate`
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+       """
+       1 scenario (1 passed)
+       2 steps (2 passed)
+       """

data/features/routing.feature

@@ -0,0 +1,18 @@
+Feature: Routing
+
+  Scenario: Visit undefined route
+    Given a project without ActiveRecord
+    And I remove the file "public/index.html"
+    And I write to "features/tests.feature" with:
+      """
+      Feature: Tests
+        Scenario: Tests
+          When I go to the home page
+      """
+    And I run `rake cucumber`
+    Then it should fail with:
+      """
+      1 scenario (1 failed)
+      1 step (1 failed)
+      """
+    And the stdout should contain "ActionController::RoutingError"