cucumber-rails-training-wheels 1.0.0

data/.gitignore

@@ -0,0 +1,8 @@
+pkg
+doc
+tmp
+coverage
+.bundle
+.rvmrc
+.yardoc/
+.rvmrc

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/Gemfile.lock

@@ -0,0 +1,156 @@
+PATH
+  remote: .
+  specs:
+    cucumber-rails-training-wheels (1.0.0)
+      cucumber-rails (>= 1.1.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.1.0)
+      actionpack (= 3.1.0)
+      mail (~> 2.3.0)
+    actionpack (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      i18n (~> 0.6)
+      rack (~> 1.3.2)
+      rack-cache (~> 1.0.3)
+      rack-mount (~> 0.8.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.0.0)
+    activemodel (3.1.0)
+      activesupport (= 3.1.0)
+      bcrypt-ruby (~> 3.0.0)
+      builder (~> 3.0.0)
+      i18n (~> 0.6)
+    activerecord (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+      arel (~> 2.2.1)
+      tzinfo (~> 0.3.29)
+    activeresource (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+    activesupport (3.1.0)
+      multi_json (~> 1.0)
+    arel (2.2.1)
+    aruba (0.4.6)
+      bcat (>= 0.6.1)
+      childprocess (>= 0.2.0)
+      cucumber (>= 1.0.2)
+      rdiscount (>= 1.6.8)
+      rspec (>= 2.6.0)
+    bcat (0.6.2)
+      rack (~> 1.0)
+    bcrypt-ruby (3.0.1)
+    builder (3.0.0)
+    capybara (1.1.1)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (~> 2.0)
+      xpath (~> 0.1.4)
+    childprocess (0.2.2)
+      ffi (~> 1.0.6)
+    cucumber (1.1.0)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.2)
+      gherkin (~> 2.5.0)
+      json (>= 1.4.6)
+      term-ansicolor (>= 1.0.6)
+    cucumber-rails (1.1.1)
+      capybara (>= 1.1.1)
+      cucumber (>= 1.1.0)
+      nokogiri (>= 1.5.0)
+    database_cleaner (0.6.7)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    ffi (1.0.9)
+    gherkin (2.5.1)
+      json (>= 1.4.6)
+    hike (1.2.1)
+    i18n (0.6.0)
+    json (1.6.1)
+    json_pure (1.6.1)
+    mail (2.3.0)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    multi_json (1.0.3)
+    nokogiri (1.5.0)
+    polyglot (0.3.2)
+    rack (1.3.4)
+    rack-cache (1.0.3)
+      rack (>= 0.4)
+    rack-mount (0.8.3)
+      rack (>= 1.0.0)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rails (3.1.0)
+      actionmailer (= 3.1.0)
+      actionpack (= 3.1.0)
+      activerecord (= 3.1.0)
+      activeresource (= 3.1.0)
+      activesupport (= 3.1.0)
+      bundler (~> 1.0)
+      railties (= 3.1.0)
+    railties (3.1.0)
+      actionpack (= 3.1.0)
+      activesupport (= 3.1.0)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.6)
+    rake (0.9.2)
+    rdiscount (1.6.8)
+    rdoc (3.9.4)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    rspec-rails (2.6.1)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.6.0)
+    rubyzip (0.9.4)
+    selenium-webdriver (2.7.0)
+      childprocess (>= 0.2.1)
+      ffi (>= 1.0.7)
+      json_pure
+      rubyzip
+    sprockets (2.0.1)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    term-ansicolor (1.0.6)
+    thor (0.14.6)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.30)
+    xpath (0.1.4)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba (>= 0.4.6)
+  cucumber-rails-training-wheels!
+  database_cleaner (>= 0.6.7)
+  rails (>= 3.1.0)
+  rspec (>= 2.6.0)
+  rspec-rails (>= 2.6.1)

data/README.md

@@ -0,0 +1,29 @@
+# Cucumber-Rails Training Wheels
+
+Cucumber-Rails Training Wheels contains a couple of generators to get you started with Cucumber and Rails really quickly. You won't even have to think! There is a little snag: If you don't take those training wheels off immediately you will end up with a complete mess. -And remember - every time you run a Cucumber feature based on Cucumber-Rails Training Wheels, god kills a kitten. But hey, you're running Cucumber!
+
+You have been warned. I think you should read [The training wheels came off](http://aslakhellesoy.com/post/11055981222/the-training-wheels-came-off)
+
+## Installation
+
+Add this to your Gemfile:
+
+    gem "cucumber-rails-training-wheels", :group => :test
+
+Generate `features/step_definitions/web_steps.rb`, which will make you write really bad features:
+
+    rails generate cucumber_rails_training_wheels:install
+
+Or generate a feature file:
+
+    rails generate cucumber_rails_training_wheels:feature post title:string body:text number:integer published:boolean
+    rails generate scaffold post title:string body:text number:integer published:boolean
+
+Congratulations! You have created Cucumber features that no stakeholder will ever want to read. Features that don't express
+any business value at all, but hey - they are green! Good luck maintaining them. You have become an [MDD](http://skillsmatter.com/podcast/home/refuctoring-your-cukes) pro!
+
+## Pull requests
+
+Please don't bother. This gem exists for the sole purpose of helping people who are reading books or blogs that were written prior to Cucumber-Rails 1.1.0. I really want this code to go away and be forgotten.
+
+If something is broken, just fork it and use your own fork.

data/Rakefile

@@ -0,0 +1,10 @@
+# encoding: utf-8
+require 'rubygems'
+require 'bundler/setup'
+Bundler::GemHelper.install_tasks
+
+require 'cucumber/rake/task'
+Cucumber::Rake::Task.new do |t|
+end
+
+task :default => :cucumber

data/cucumber-rails-training-wheels.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name        = 'cucumber-rails-training-wheels'
+  s.version     = '1.0.0'
+  s.authors     = ["Aslak Hellesøy"]
+  s.description = "Training Wheels for Cucumber-Rails"
+  s.summary     = "#{s.name}-#{s.version}"
+  s.email       = 'cukes@googlegroups.com'
+  s.homepage    = "http://cukes.info"
+
+  s.add_runtime_dependency('cucumber-rails', '>= 1.1.1')
+
+  s.add_development_dependency('rails', '>= 3.1.0')
+  s.add_development_dependency('aruba', '>= 0.4.6')
+  s.add_development_dependency('rspec', '>= 2.6.0')
+  s.add_development_dependency('rspec-rails', '>= 2.6.1')
+  s.add_development_dependency('database_cleaner', '>= 0.6.7')
+
+  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/features/step_defintions/rails_steps.rb

@@ -0,0 +1,21 @@
+Given /^I have created a new Rails 3 app "([^"]*)" with cucumber\-rails support$/ do |app_name|
+  steps %Q{
+    When I successfully run `rails new #{app_name}`
+    Then it should pass with:
+      """
+      README
+      """
+    And I cd to "#{app_name}"
+    And I append to "Gemfile" with:
+      """
+      gem "cucumber-rails-training-wheels", :group => :test, :path => "../../.."
+      gem "cucumber-rails", :group => :test
+      gem "capybara", :group => :test
+      gem "rspec-rails", :group => :test
+      gem "database_cleaner", :group => :test
+      gem 'factory_girl', :group => :test
+
+      """
+    And I successfully run `bundle exec rails generate cucumber:install`
+  }
+end

data/features/support/env.rb

@@ -0,0 +1,8 @@
+require 'bundler/setup'
+require 'rspec/expectations'
+require 'aruba/cucumber'
+
+Before do
+  @aruba_timeout_seconds = 120 # A long time needed some times
+  unset_bundler_env_vars
+end

data/features/use_training_wheels.feature

@@ -0,0 +1,17 @@
+Feature: Use training wheels
+
+  Scenario: I don't care. I'll use it anyway. Yee-haa!!
+    Given I have created a new Rails 3 app "rails-3-app" with cucumber-rails support
+    # Generate features/step_definitions/web_steps.rb
+    And I successfully run `rails generate cucumber_rails_training_wheels:install`
+    # Generate features/post_feature.rb
+    And I successfully run `rails generate cucumber_rails_training_wheels: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 run `bundle exec rake db:migrate`
+    And I run `bundle exec rake cucumber`
+    Then it should pass with:
+       """
+       2 scenarios (2 passed)
+       13 steps (13 passed)
+       """
+

data/lib/generators/cucumber_rails_training_wheels/feature/USAGE

@@ -0,0 +1,16 @@
+Description:
+    Generates a skeleton for a new feature. Both a simple .feature file and
+    a steps.rb file is generated. This generator should be used with moderation.
+    See https://github.com/cucumber/cucumber/wiki/Feature-Coupled-Steps-(Antipattern)
+    for details about the dangers involved.
+
+    This generator can take an optional list of attribute pairs similar to Rails'
+    built-in resource generator.
+
+Examples (Rails 3):
+    `script/rails generate cucumber:feature post` # no attributes
+    `script/rails generate cucumber:feature post title:string body:text published:boolean`
+
+Examples (Rails 2):
+    `script/generate feature post` # no attributes
+    `script/generate feature post title:string body:text published:boolean`

data/lib/generators/cucumber_rails_training_wheels/feature/feature_generator.rb

@@ -0,0 +1,27 @@
+require File.join(File.dirname(__FILE__), 'named_arg')
+
+module CucumberRailsTrainingWheels
+  class FeatureGenerator < ::Rails::Generators::NamedBase
+    source_root File.expand_path("../templates", __FILE__)
+
+    argument :fields, :optional => true, :type => :array, :banner => "[field:type, field:type]"
+
+    attr_reader :named_args
+  
+    def parse_fields
+      @named_args = @fields.nil? ? [] : @fields.map { |arg| NamedArg.new(arg) }
+    end    
+
+    def generate
+      template 'feature.erb', "features/manage_#{plural_name}.feature"
+      template 'steps.erb', "features/step_definitions/#{singular_name}_steps.rb"
+      gsub_file 'features/support/paths.rb', /'\/'/mi do |match|
+        "#{match}\n    when /the new #{singular_name} page/\n      new_#{singular_name}_path\n"
+      end
+    end
+  
+    def self.banner
+      "#{$0} cucumber:feature ModelName [field:type, field:type]"
+    end
+  end
+end

data/lib/generators/cucumber_rails_training_wheels/feature/named_arg.rb

@@ -0,0 +1,20 @@
+module CucumberRailsTrainingWheels
+  class NamedArg
+    attr_reader :name
+    attr_reader :type
+
+    def initialize(s)
+      @name, @type = *s.split(':')
+    end
+
+    def value(n)
+      if @type == 'boolean'
+        (n % 2) == 0
+      elsif @type == 'integer'
+        n
+      else
+        "#{@name} #{n}"
+      end
+    end
+  end
+end

data/lib/generators/cucumber_rails_training_wheels/feature/templates/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/lib/generators/cucumber_rails_training_wheels/feature/templates/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/lib/generators/cucumber_rails_training_wheels/install/USAGE

@@ -0,0 +1,15 @@
+Description:
+    Sets up Cucumber in your Rails project. After running this generator you will
+    get a new rake task called features.
+    
+    This also generates the necessary files in the features directory.
+    
+    Also see the cucumber:feature generator.
+    
+Examples:
+    `rails generate cucumber:install`
+
+    `rails generate cucumber:install --help`
+
+    You can also provide a language argument for localized web_steps:
+    `rails generate cucumber:install de`