cucumber-rails2 0.3.3

data/lib/generators/cucumber/install/install_generator.rb

@@ -0,0 +1,64 @@
+require File.join(File.dirname(__FILE__), 'install_base')
+
+module Cucumber
+  class InstallGenerator < Rails::Generators::Base
+
+    include Cucumber::Generators::InstallBase
+
+    DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name'])
+
+    argument     :language,      :type => :string,  :banner => "LANG", :optional => true
+
+    class_option :webrat,        :type => :boolean, :desc => "Use Webrat"
+    class_option :capybara,      :type => :boolean, :desc => "Use Capybara"
+    class_option :rspec,         :type => :boolean, :desc => "Use RSpec"
+    class_option :testunit,      :type => :boolean, :desc => "Use Test::Unit"
+    class_option :spork,         :type => :boolean, :desc => "Use Spork"
+    class_option :skip_database, :type => :boolean, :desc => "Skip modification of database.yml", :aliases => '-D', :default => false
+
+    attr_reader :framework, :driver
+
+    def configure_defaults
+      @language ||= 'en'
+      @framework  = framework_from_options || detect_current_framework || detect_default_framework
+      @driver     = driver_from_options    || detect_current_driver    || detect_default_driver
+    end
+
+    def generate
+      check_upgrade_limitations
+      create_templates
+      create_scripts
+      create_step_definitions
+      create_feature_support
+      create_tasks
+      create_database unless options[:skip_database]
+    end
+  
+    def self.gem_root
+      File.expand_path("../../../../../", __FILE__)
+    end
+  
+    def self.source_root
+      File.join(gem_root, 'templates/install')
+    end
+
+    def cucumber_rails_env
+      'test'
+    end
+
+    private
+  
+    def framework_from_options
+      return :rspec if options[:rspec]
+      return :testunit if options[:testunit]
+      return nil
+    end
+
+    def driver_from_options
+      return :webrat if options[:webrat]
+      return :capybara if options[:capybara]
+      return nil
+    end
+  
+  end
+end

data/spec/cucumber/web/tableish_spec.rb

@@ -0,0 +1,192 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path(File.dirname(__FILE__) + "/../../spec_helper")
+
+def World(*a); end
+require 'cucumber/web/tableish'
+
+module Cucumber
+  module Web
+    describe Tableish do
+      include Tableish
+
+      unless RUBY_PLATFORM =~ /java/
+        it "should convert a table" do
+          html = <<-HTML
+            <table id="tools">
+              <tr>
+                <th>tool</th>
+                <th>dude</th>
+              </tr>
+              <tr>
+                <td>webrat</td>
+                <td>bryan</td>
+              </tr>
+              <tr>
+                <td>cucumber</td>
+                <td>aslak</td>
+              </tr>
+            </table>
+          HTML
+
+          _tableish(html, 'table#tools tr', 'td,th').should == [
+            %w{tool dude},
+            %w{webrat bryan},
+            %w{cucumber aslak}
+          ]
+        end
+
+        it "should size to the first row" do
+          html = <<-HTML
+            <table id="tools">
+              <tr>
+                <th>tool</th>
+                <th>dude</th>
+              </tr>
+              <tr>
+                <td>webrat</td>
+                <td>bryan</td>
+                <td>crapola</td>
+              </tr>
+              <tr>
+                <td>cucumber</td>
+                <td>aslak</td>
+                <td>gunk</td>
+                <td>filth</td>
+              </tr>
+            </table>
+          HTML
+
+          _tableish(html, 'table#tools tr', 'td,th').should == [
+            ['tool',     'dude',],
+            ['webrat',   'bryan'],
+            ['cucumber', 'aslak']
+          ]
+        end
+
+        it "should pad with empty Strings if some rows are shorter" do
+          html = <<-HTML
+            <table id="tools">
+              <tr>
+                <th>tool</th>
+                <th>dude</th>
+              </tr>
+              <tr>
+                <td>webrat</td>
+                <td>bryan</td>
+              </tr>
+              <tr>
+                <td>cucumber</td>
+              </tr>
+            </table>
+          HTML
+
+          _tableish(html, 'table#tools tr', 'td,th').should == [
+            %w{tool dude},
+            %w{webrat bryan},
+            ['cucumber', '']
+          ]
+        end
+
+        it "should handle colspan and rowspan" do
+          html = <<-HTML
+            <table id="tools">
+              <tr>
+                <td rowspan="4">a</td>
+                <td>b</td>
+                <td>c</td>
+                <td>d</td>
+              </tr>
+              <tr>
+                <td colspan="3">e</td>
+              </tr>
+              <tr>
+                <td rowspan="2" colspan="2">f</td>
+                <td>g</td>
+              </tr>
+              <tr>
+                <td>h</td>
+              </tr>
+            </table>
+          HTML
+
+          _tableish(html, 'table#tools tr', 'td,th').should == [
+            ['a', 'b', 'c', 'd'],
+            ['',  'e', '',  '' ],
+            ['',  'f', '',  'g' ],
+            ['',  '',  '',  'h' ],
+           ]
+        end
+
+        it "should convert a dl" do
+          html = <<-HTML
+            <dl id="tools">
+              <dt>webrat</dt>
+              <dd>bryan</dd>
+              <dt>cucumber</dt>
+              <dd>aslak</dd>
+            </dl>
+          HTML
+
+          _tableish(html, 'dl#tools dt', lambda{|dt| [dt, dt.next.next]}).should == [
+            %w{webrat bryan},
+            %w{cucumber aslak}
+          ]
+        end
+
+        it "should convert a ul" do
+          html = <<-HTML
+            <ul id="phony">
+              <li>nope</li>
+            </ul>
+
+            <ul id="yes">
+              <li>webrat</li>
+              <li>bryan</li>
+              <li>cucumber</li>
+              <li>aslak</li>
+            </ul>
+          HTML
+
+          _tableish(html, 'ul#yes li', lambda{|li| [li]}).should == [
+            %w{webrat},
+            %w{bryan},
+            %w{cucumber},
+            %w{aslak},
+          ]
+        end
+
+        it "should do complex shit" do
+          html = <<-HTML
+            <form method="post" action="/invoices/10/approve" class="button-to">
+              <div>
+                <input id="approve_invoice_10" type="submit" value="Approve" />
+                <input name="authenticity_token" type="hidden" value="WxKGVy3Y5zcvFEiFe66D/odoc3CicfMdAup4vzQfiZ0=" />
+                <span>Hello&nbsp;World<span>
+              </div>
+            </form>
+            <form method="post" action="/invoices/10/delegate" class="button-to">
+              <div>
+                <input id="delegate_invoice_10" type="submit" value="Delegate" />
+                <input name="authenticity_token" type="hidden" value="WxKGVy3Y5zcvFEiFe66D/odoc3CicfMdAup4vzQfiZ0=" />
+                <span>Hi There<span>
+              </div>
+            </form>
+          HTML
+
+          selectors = lambda do |form|
+            [
+              form.css('div input:nth-child(1)').first.attributes['value'],
+              form.css('span').first.text.gsub(/\302\240/, ' ')
+            ]
+          end
+
+          _tableish(html, 'form', selectors).should == [
+            ['Approve', "Hello World"],
+            ['Delegate', 'Hi There']
+          ]
+        end
+      end
+    end
+  end
+end

data/spec/generators/cucumber/install/install_base_spec.rb

@@ -0,0 +1,84 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../spec_helper")
+
+# TODO using this seam as an interim way to get the file to load
+module Config
+  CONFIG = {
+    'bindir' => 'foo',
+    'ruby_install_name' => 'bar'
+  }
+end
+require 'generators/cucumber/install/install_base'
+
+module Cucumber
+  module Generators
+    describe InstallBase do
+      def instance_of_class_including(mixin)
+        Class.new do
+          include mixin
+        end.new
+      end
+      
+      before(:each) do
+        Kernel.stub(:require => nil)
+        
+        @generator = instance_of_class_including(Cucumber::Generators::InstallBase)
+      end
+      
+      # This is a private method, but there was a bug in it where it
+      # defaulted to :testunit (the framework) when called to identify
+      # the driver
+      describe "#first_loadable" do
+        it "detects loadable libraries" do
+          Gem.should_receive(:available?).with('capybara').and_return(true)
+          @generator.send(:first_loadable, [['capybara', :capybara], ['webrat', :webrat ]]).should == :capybara
+        end        
+
+        it "tries the given libraries in order" do
+          Gem.stub(:available?).with('capybara').and_return(false)
+          Gem.should_receive(:available?).with('webrat').and_return(true)
+          @generator.send(:first_loadable, [['capybara', :capybara], ['webrat', :webrat ]]).should == :webrat
+        end
+        
+        it "returns nil if no libraries are available" do
+          Gem.stub(:available? => false)
+          @generator.send(:first_loadable, [['capybara', :capybara], ['webrat', :webrat ]]).should be_nil
+        end
+      end
+      
+      # This is a private method, but there may have been a bug in it where
+      # it defaulted to :testunit (the framework) when called to identify
+      # the driver
+      describe "#detect_in_env" do
+        describe "when env.rb doesn't exist" do
+          it "returns nil" do
+            File.should_receive(:file?).with("features/support/env.rb").and_return(false)
+            @generator.send(:detect_in_env, [['capybara', :capybara], ['webrat', :webrat]]).should be_nil
+          end
+        end
+        
+        describe "when env.rb exists" do
+          before(:each) do
+            File.stub(:file => true)
+          end
+          
+          it "detects loadable libraries, choosing the first in the argument list" do
+            IO.should_receive(:read).with("features/support/env.rb").and_return("blah webrat capybara blah")
+            @generator.send(:detect_in_env, [['capybara', :capybara], ['webrat', :webrat]]).should == :capybara
+          end        
+
+          it "tries the given libraries in order" do
+            IO.should_receive(:read).with("features/support/env.rb").and_return("blah webrat blah")
+            @generator.send(:detect_in_env, [['capybara', :capybara], ['webrat', :webrat]]).should == :webrat
+          end
+        
+          it "returns nil if no libraries are available" do
+            IO.should_receive(:read).with("features/support/env.rb").and_return("blah blah")
+            @generator.send(:detect_in_env, [['capybara', :capybara], ['webrat', :webrat]]).should be_nil
+          end
+        end
+        
+      end
+      
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--format progress
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+gem 'rspec'
+require 'spec'
+require 'spec/autorun'
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')

data/templates/feature/feature.erb

@@ -0,0 +1,63 @@
+Feature: Manage <%= plural_name %>
+  In order to [goal]
+  [stakeholder]
+  wants [behaviour]
+  
+  Scenario: Register new <%= singular_name %>
+    Given I am on the new <%= singular_name %> page
+<% keyword = 'When' -%>
+<% named_args.each do |arg| -%>
+<% if arg.type == 'boolean' -%>
+    <%= keyword %> I uncheck "<%= arg.name.humanize %>"
+<% else -%>
+    <%= keyword %> I fill in "<%= arg.name.humanize %>" with "<%= arg.value(1) %>"
+<% end -%>
+<% keyword = 'And' -%>
+<% end -%>
+    And I press "Create"
+<% keyword = 'Then' -%>
+<% named_args.each do |arg| -%>
+    <%= keyword %> I should see "<%= arg.value(1) %>"
+<% keyword = 'And' -%>
+<% end -%>
+
+<% if IO.read('features/support/env.rb') =~ /capybara/n -%>
+  # Rails generates Delete links that use Javascript to pop up a confirmation
+  # dialog and then do a HTTP POST request (emulated DELETE request).
+  #
+  # Capybara must use Culerity/Celerity or Selenium2 (webdriver) when pages rely
+  # on Javascript events. Only Culerity/Celerity supports clicking on confirmation
+  # dialogs.
+  #
+  # Since Culerity/Celerity and Selenium2 has some overhead, Cucumber-Rails will
+  # detect the presence of Javascript behind Delete links and issue a DELETE request 
+  # instead of a GET request.
+  #
+  # You can turn this emulation off by tagging your scenario with @no-js-emulation.
+  # Turning on browser testing with @selenium, @culerity, @celerity or @javascript
+  # will also turn off the emulation. (See the Capybara documentation for 
+  # details about those tags). If any of the browser tags are present, Cucumber-Rails
+  # will also turn off transactions and clean the database with DatabaseCleaner 
+  # after the scenario has finished. This is to prevent data from leaking into 
+  # the next scenario.
+  #
+  # Another way to avoid Cucumber-Rails' javascript emulation without using any
+  # of the tags above is to modify your views to use <button> instead. You can
+  # see how in http://github.com/jnicklas/capybara/issues#issue/12
+  #
+<% if options[:capybara] -%>
+  @<%= options[:capybara] %>  
+<% end -%>
+<% end -%>
+  Scenario: Delete <%= singular_name %>
+    Given the following <%= plural_name %>:
+      |<%= named_args.map(&:name).join('|') %>|
+<% (1..4).each do |n| -%>
+      |<%= named_args.map{|arg| arg.value(n)}.join('|') %>|
+<% end -%>
+    When I delete the 3rd <%= singular_name %>
+    Then I should see the following <%= plural_name %>:
+      |<%= named_args.map{|arg| arg.name.humanize}.join('|') %>|
+<% [1,2,4].each do |n| -%>
+      |<%= named_args.map{|arg| arg.value(n)}.join('|') %>|
+<% end -%>

data/templates/feature/steps.erb

@@ -0,0 +1,14 @@
+Given /^the following <%= plural_name %>:$/ do |<%= plural_name %>|
+  <%= class_name %>.create!(<%= plural_name %>.hashes)
+end
+
+When /^I delete the (\d+)(?:st|nd|rd|th) <%= singular_name %>$/ do |pos|
+  visit <%= plural_name %>_path
+  within("table tr:nth-child(#{pos.to_i+1})") do
+    click_link "Destroy"
+  end
+end
+
+Then /^I should see the following <%= plural_name %>:$/ do |expected_<%= plural_name %>_table|
+  expected_<%= plural_name %>_table.diff!(tableish('table tr', 'td,th'))
+end

data/templates/install/config/cucumber.yml.erb

@@ -0,0 +1,8 @@
+<%%
+rerun = File.file?('rerun.txt') ? IO.read('rerun.txt') : ""
+rerun_opts = rerun.to_s.strip.empty? ? "--format #{ENV['CUCUMBER_FORMAT'] || 'progress'} features" : "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} #{rerun}"
+std_opts = "--format #{ENV['CUCUMBER_FORMAT'] || 'progress'} --strict --tags ~@wip"
+%>
+default: <%= spork? ? '--drb ' : '' %><%%= std_opts %> features
+wip: <%= spork? ? '--drb ' : '' %>--tags @wip:3 --wip features
+rerun: <%= spork? ? '--drb ' : '' %><%%= rerun_opts %> --format rerun --out rerun.txt --strict --tags ~@wip

data/templates/install/environments/cucumber.rb.erb

@@ -0,0 +1,37 @@
+# Edit at your own peril - it's recommended to regenerate this file
+# in the future when you upgrade to a newer version of Cucumber.
+
+# IMPORTANT: Setting config.cache_classes to false is known to
+# break Cucumber's use_transactional_fixtures method.
+# For more information see https://rspec.lighthouseapp.com/projects/16211/tickets/165
+config.cache_classes = true
+
+# Log error messages when you accidentally call methods on nil.
+config.whiny_nils = true
+
+# Show full error reports and disable caching
+config.action_controller.consider_all_requests_local = true
+config.action_controller.perform_caching             = false
+
+# Disable request forgery protection in test environment
+config.action_controller.allow_forgery_protection    = false
+
+# Tell Action Mailer not to deliver emails to the real world.
+# The :test delivery method accumulates sent emails in the
+# ActionMailer::Base.deliveries array.
+config.action_mailer.delivery_method = :test
+
+config.gem 'cucumber-rails',   :lib => false, :version => '>=<%= version %>' unless File.directory?(File.join(Rails.root, 'vendor/plugins/cucumber-rails'))
+config.gem 'database_cleaner', :lib => false, :version => '>=0.5.0' unless File.directory?(File.join(Rails.root, 'vendor/plugins/database_cleaner'))
+<% if driver == :capybara -%>
+config.gem 'capybara',         :lib => false, :version => '>=0.3.5' unless File.directory?(File.join(Rails.root, 'vendor/plugins/capybara'))
+<% else -%>
+config.gem 'webrat',           :lib => false, :version => '>=0.7.0' unless File.directory?(File.join(Rails.root, 'vendor/plugins/webrat'))
+<% end -%>
+<% if framework == :rspec -%>
+config.gem 'rspec',            :lib => false, :version => '>=1.3.0' unless File.directory?(File.join(Rails.root, 'vendor/plugins/rspec'))
+config.gem 'rspec-rails',      :lib => false, :version => '>=1.3.2' unless File.directory?(File.join(Rails.root, 'vendor/plugins/rspec-rails'))
+<% end %>
+<% if spork? -%>
+config.gem 'spork',            :lib => false, :version => '>=0.7.5' unless File.directory?(File.join(Rails.root, 'vendor/plugins/spork'))
+<% end %>