casecumber-rails 1.0.2.1

data/README.md

@@ -0,0 +1,77 @@
+# Cucumber-Rails
+
+Cucumber-Rails brings Cucumber to Rails3. It contains 2 generators - one
+for bootstrapping your Rails app for Cucumber, and a second one for generating features.
+
+Cucumber-Rails also contains Cucumber Step Definitions that wrap Capybara,
+giving you a head start for writing Cucumber features against your Rails app.
+
+## Installation
+
+Before you can use the generator, add the gem to your project's Gemfile as follows:
+
+    group :test do
+      gem 'cucumber-rails'
+      # database_cleaner is not required, but highly recommended
+      gem 'database_cleaner'
+    end
+
+Then install it by running:
+
+    bundle install
+
+Learn about the various options:
+
+    rails generate cucumber:install --help
+
+Finally, bootstrap your Rails app, for example:
+
+    rails generate cucumber:install
+
+## Generating a Cucumber feature
+
+IMPORTANT: Only do this if you are new to Cucumber. We recommend you write your
+Cucumber features by hand once you get the hang of it.
+
+Example:
+
+    rails generate cucumber:feature post title:string body:text published:boolean
+    rails generate scaffold post title:string body:text published:boolean
+    rake db:migrate
+    rake cucumber
+
+## Running Cucumber
+
+With Rake:
+
+    rake cucumber
+
+Without Rake:
+
+    [bundle exec] cucumber
+
+## Bugs and feature requests
+
+The *only* way to have a bug fixed or a new feature accepted is to describe it with a Cucumber feature. Let's say you think you have found a bug in the cucumber:install generator. Fork this project, clone it to your workstation and check out a branch with a descriptive name:
+
+    git clone git@github.com:you/cucumber-rails.git
+    git checkout -b bug-install-generator
+
+Start by making sure you can run the existing features. Now, create a feature that demonstrates what's wrong. See the existing features for examples. When you have a failing feature that reproduces the bug, commit, push and send a pull request. Someone from the Cucumber-Rails team will review it and hopefully create a fix.
+
+If you know how to fix the bug yourself, make a second commit (after committing the failing feature) before you send the pull request.
+
+### Setting up your environment
+
+I strongly recommend rvm and ruby 1.9.2. When you have that, cd into your cucumber-rails repository and:
+
+    gem install bundler
+    bundle install
+
+### Running all features
+
+With all dependencies installed, all features should pass:
+
+    rake cucumber
+
+One of the features uses MongoDB, which needs to be running in order to make features/mongoid.feature to pass.

data/Rakefile

@@ -0,0 +1,9 @@
+# encoding: utf-8
+CUCUMBER_RAILS_VERSION = Gem::Specification.load(File.dirname(__FILE__) + '/cucumber-rails.gemspec').version.version
+require 'rubygems'
+require 'bundler/setup'
+Bundler::GemHelper.install_tasks
+
+$:.unshift(File.dirname(__FILE__) + '/lib')
+Dir["#{File.dirname(__FILE__)}/dev_tasks/*.rake"].sort.each { |ext| load ext }
+task :default => :cucumber

data/config/.gitignore

@@ -0,0 +1 @@
+aruba-rvm.yml

data/config/cucumber.yml

@@ -0,0 +1 @@
+default: --tags ~@broken

data/cucumber-rails.gemspec

@@ -0,0 +1,46 @@
+# -*- encoding: utf-8 -*-
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = 'casecumber-rails'
+  s.version     = '1.0.2.1'
+  s.authors     = ["Aslak Hellesøy", "Dennis Blöte", "Rob Holland", "Case Commons LLC", "Trace Wax", "Jason Berlinsky"]
+  s.description = "Cucumber Generators and Runtime for Rails"
+  s.summary     = "#{s.name}-#{s.version}"
+  s.email       = ["cukes@googlegroups.com", "casecommons-dev@googlegroups.com", "gems@tracedwax.com", "jason@jasonberlinsky.com"]
+  s.homepage    = "http://cukes.info"
+
+  s.add_dependency('casecumber', '~> 1.0.2.1')
+  s.add_dependency('nokogiri', '>= 1.4.6')
+  s.add_dependency('capybara', '>= 1.0.0')
+  s.add_development_dependency('rails', '>= 3.1.0.rc4')
+  s.add_development_dependency('rake', '>= 0.9.2')
+  s.add_development_dependency('bundler', '>= 1.0.15')
+  s.add_development_dependency('aruba', '>= 0.4.3')
+  s.add_development_dependency('sqlite3-ruby', '>= 1.3.3')
+  s.add_development_dependency('rspec', '>= 2.6.0')
+  s.add_development_dependency('rspec-rails', '>= 2.6.1')
+  s.add_development_dependency('factory_girl', '>= 2.0.0')
+  s.add_development_dependency('database_cleaner', '>= 0.6.7')
+  s.add_development_dependency('mongoid', '>= 2.0.2')
+  s.add_development_dependency('bson_ext', '>= 1.3.1')
+  # s.add_development_dependency('akephalos', '>= 0.2.5')
+
+  # Various Stuff that Rails 3.1 puts inside apps.
+  s.add_development_dependency('turn', '>= 0.8.2')
+  s.add_development_dependency('sass', '>= 3.1.3')
+  s.add_development_dependency('coffee-script', '>= 2.2.0')
+  s.add_development_dependency('uglifier', '>= 1.0.0')
+  s.add_development_dependency('jquery-rails', '>= 1.0.12')
+
+  # For Documentation:
+  s.add_development_dependency('yard', '= 0.7.1')
+  s.add_development_dependency('rdiscount', '= 1.6.8')
+  s.add_development_dependency('bcat', '= 0.6.1')
+
+  s.rubygems_version = ">= 1.6.1"
+  s.files            = `git ls-files`.split("\n")
+  s.test_files       = `git ls-files -- {spec,features}/*`.split("\n")
+  s.executables      = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_path     = "lib"
+end

data/dev_tasks/cucumber.rake

@@ -0,0 +1,5 @@
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new do |t|
+  t.rcov = false
+end

data/dev_tasks/rspec.rake

@@ -0,0 +1,8 @@
+require 'rspec/core/rake_task'
+
+desc "Run RSpec"
+RSpec::Core::RakeTask.new do |t|
+  t.rcov = ENV['RCOV']
+  t.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/}
+  t.verbose = true
+end

data/dev_tasks/yard/default/layout/html/footer.erb

@@ -0,0 +1,5 @@
+<div id="footer">
+  Generated on <%= Time.now.strftime("%c") %> by 
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  <%= YARD::VERSION %> (ruby-<%= RUBY_VERSION %>).
+</div>

data/dev_tasks/yard/default/layout/html/index.erb

@@ -0,0 +1 @@
+<%= yieldall %>

data/dev_tasks/yard/default/layout/html/layout.erb

@@ -0,0 +1,25 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <%= erb(:headers) %>
+  </head>
+  <body>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+    
+    <div id="header">
+      <%= erb(:logo) %>
+      <%= erb(:breadcrumb) %>
+      <%= erb(:search) %>
+      <div class="clear"></div>
+    </div>
+    
+    <iframe id="search_frame"></iframe>
+    
+    <div id="content"><%= yieldall %></div>
+    
+    <%= erb(:footer) %>
+  </body>
+</html>

data/dev_tasks/yard/default/layout/html/logo.erb

@@ -0,0 +1 @@
+<h3><img src="<%= url_for('images/bubble_32x32.png') %>"></img> Cucumber-Rails <%= CUCUMBER_RAILS_VERSION %></h3>

data/dev_tasks/yard/default/layout/html/setup.rb

@@ -0,0 +1,4 @@
+def init
+  super
+  options[:serializer].serialize('/images/bubble_32x32.png', IO.read(File.dirname(__FILE__) + '/bubble_32x32.png'))
+end

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)
+       """
+