cucumber 0.1.16 → 0.2.0

data/lib/cucumber/version.rb

@@ -1,8 +1,8 @@
 module Cucumber #:nodoc:
   class VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 1
-    TINY  = 16
+    MINOR = 2
+    TINY  = 0
     PATCH = nil # Set to nil for official release
 
     STRING = [MAJOR, MINOR, TINY, PATCH].compact.join('.')

data/lib/cucumber/world.rb

@@ -1 +1,53 @@
-%w{pending}.each{|f| require "cucumber/world/#{f}"}
+module Cucumber
+  # All steps are run in the context of an object that extends this module
+  module World
+    class << self
+      def alias_adverb(adverb)
+        alias_method adverb, :__cucumber_invoke
+      end
+    end
+    
+    attr_writer :__cucumber_step_mother, :__cucumber_visitor, :__cucumber_current_step
+
+    # Call a step from within a step definition
+    def __cucumber_invoke(name, multiline_argument=nil) #:nodoc:
+      begin
+        step_match = @__cucumber_step_mother.step_match(name)
+        step_match.invoke(self, multiline_argument)
+      rescue Exception => e
+        e.nested! if Undefined === e
+        @__cucumber_current_step.exception = e
+        raise e
+      end
+    end
+    
+    def table(text, file=nil, line_offset=0)
+      @table_parser ||= Parser::TableParser.new
+      @table_parser.parse_or_fail(text.strip, file, line_offset)
+    end
+
+    # Output +announcement+ alongside the formatted output.
+    # This is an alternative to using Kernel#puts - it will display
+    # nicer, and in all outputs (in case you use several formatters)
+    #
+    # Beware that the output will be printed *before* the corresponding
+    # step. This is because the step itself will not be printed until
+    # after it has run, so it can be coloured according to its status.
+    def announce(announcement)
+      @__cucumber_visitor.announce(announcement)
+    end
+
+    def pending(message = "TODO")
+      if block_given?
+        begin
+          yield
+        rescue Exception => e
+          raise Pending.new(message)
+        end
+        raise Pending.new("Expected pending '#{message}' to fail. No Error was raised. No longer pending?")
+      else
+        raise Pending.new(message)
+      end
+    end
+  end
+end

data/rails_generators/cucumber/cucumber_generator.rb

@@ -4,13 +4,16 @@ require 'rbconfig'
 class CucumberGenerator < Rails::Generator::Base
   DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
                               Config::CONFIG['ruby_install_name'])
+
+  attr_accessor :framework
+
   def manifest
     record do |m|
       m.directory 'features/step_definitions'
-      m.file      'webrat_steps.rb', 'features/step_definitions/webrat_steps.rb'
+      m.template  'webrat_steps.rb', 'features/step_definitions/webrat_steps.rb'
 
       m.directory 'features/support'
-      m.file      'env.rb',           'features/support/env.rb'
+      m.template  'env.rb',           'features/support/env.rb'
       m.file      'paths.rb',         'features/support/paths.rb'
 
       m.directory 'lib/tasks'
@@ -22,10 +25,26 @@ class CucumberGenerator < Rails::Generator::Base
     end
   end
 
+  def framework
+    options[:framework] || :rspec
+  end
+
 protected
 
   def banner
     "Usage: #{$0} cucumber"
   end
 
-end
+  def add_options!(opt)
+    opt.separator ''
+    opt.separator 'Options:'
+    opt.on('--rspec', 'Setup cucumber for use with RSpec (default)') do |value|
+      options[:framework] = :rspec
+    end
+
+    opt.on('--testunit', 'Setup cucumber for use with test/unit') do |value|
+      options[:framework] = :testunit
+    end
+  end
+
+end

data/rails_generators/cucumber/templates/cucumber

@@ -1,7 +1,8 @@
 #!/usr/bin/env ruby
 begin
   load File.expand_path(File.dirname(__FILE__) + "/../vendor/plugins/cucumber/bin/cucumber")
-rescue LoadError
+rescue LoadError => e
+  raise unless e.to_s =~ /cucumber/  
   require "rubygems"
   load File.join(Gem.bindir, "cucumber")
 end

data/rails_generators/cucumber/templates/cucumber.rake

@@ -1,7 +1,15 @@
-$:.unshift(RAILS_ROOT + '/vendor/plugins/cucumber/lib')
-require 'cucumber/rake/task'
+$LOAD_PATH.unshift(RAILS_ROOT + '/vendor/plugins/cucumber/lib') if File.directory?(RAILS_ROOT + '/vendor/plugins/cucumber/lib')
 
-Cucumber::Rake::Task.new(:features) do |t|
-  t.cucumber_opts = "--format pretty"
+begin
+  require 'cucumber/rake/task'
+
+  Cucumber::Rake::Task.new(:features) do |t|
+    t.cucumber_opts = "--format pretty"
+  end
+  task :features => 'db:test:prepare'
+rescue LoadError
+  desc 'Cucumber rake task not available'
+  task :features do
+    abort 'Cucumber rake task is not available. Be sure to install cucumber as a gem or plugin'
+  end
 end
-task :features => 'db:test:prepare'

data/rails_generators/cucumber/templates/env.rb

@@ -1,5 +1,5 @@
 # Sets up the Rails environment for Cucumber
-ENV["RAILS_ENV"] = "test"
+ENV["RAILS_ENV"] ||= "test"
 require File.expand_path(File.dirname(__FILE__) + '/../../config/environment')
 require 'cucumber/rails/world'
 require 'cucumber/formatters/unicode' # Comment out this line if you don't want Cucumber Unicode support
@@ -10,7 +10,8 @@ require 'webrat'
 Webrat.configure do |config|
   config.mode = :rails
 end
+<% if framework == :rspec -%>
 
-# Comment out the next two lines if you're not using RSpec's matchers (should / should_not) in your steps.
 require 'cucumber/rails/rspec'
-require 'webrat/rspec-rails'
+require 'webrat/core/matchers'
+<% end -%>

data/rails_generators/cucumber/templates/paths.rb

@@ -1,12 +1,19 @@
-def path_to(page_name)
-  case page_name
-  
-  when /the homepage/i
-    root_path
-  
-  # Add more page name => path mappings here
-  
-  else
-    raise "Can't find mapping from \"#{page_name}\" to a path."
+module NavigationHelpers
+  def path_to(page_name)
+    case page_name
+    
+    when /the homepage/
+      root_path
+    
+    # Add more page name => path mappings here
+    
+    else
+      raise "Can't find mapping from \"#{page_name}\" to a path."
+    end
   end
-end
+end
+
+World do |world|
+  world.extend NavigationHelpers
+  world
+end

data/rails_generators/cucumber/templates/webrat_steps.rb

@@ -3,97 +3,113 @@ require File.expand_path(File.join(File.dirname(__FILE__), "..", "support", "pat
 # Commonly used webrat steps
 # http://github.com/brynary/webrat
 
+Given /^I am on (.+)$/ do |page_name|
+  visit path_to(page_name)
+end
+
 When /^I go to (.+)$/ do |page_name|
   visit path_to(page_name)
 end
 
-When /^I press "(.*)"$/ do |button|
+When /^I press "([^\"]*)"$/ do |button|
   click_button(button)
 end
 
-When /^I follow "(.*)"$/ do |link|
+When /^I follow "([^\"]*)"$/ do |link|
   click_link(link)
 end
 
-When /^I fill in "(.*)" with "(.*)"$/ do |field, value|
+When /^I fill in "([^\"]*)" with "([^\"]*)"$/ do |field, value|
   fill_in(field, :with => value) 
 end
 
-When /^I select "(.*)" from "(.*)"$/ do |value, field|
+When /^I select "([^\"]*)" from "([^\"]*)"$/ do |value, field|
   select(value, :from => field) 
 end
 
 # Use this step in conjunction with Rail's datetime_select helper. For example:
 # When I select "December 25, 2008 10:00" as the date and time 
-When /^I select "(.*)" as the date and time$/ do |time|
+When /^I select "([^\"]*)" as the date and time$/ do |time|
   select_datetime(time)
 end
 
 # Use this step when using multiple datetime_select helpers on a page or 
 # you want to specify which datetime to select. Given the following view:
-#   <%= f.label :preferred %><br />
-#   <%= f.datetime_select :preferred %>
-#   <%= f.label :alternative %><br />
-#   <%= f.datetime_select :alternative %>
+#   <%%= f.label :preferred %><br />
+#   <%%= f.datetime_select :preferred %>
+#   <%%= f.label :alternative %><br />
+#   <%%= f.datetime_select :alternative %>
 # The following steps would fill out the form:
 # When I select "November 23, 2004 11:20" as the "Preferred" data and time
 # And I select "November 25, 2004 10:30" as the "Alternative" data and time
-When /^I select "(.*)" as the "(.*)" date and time$/ do |datetime, datetime_label|
+When /^I select "([^\"]*)" as the "([^\"]*)" date and time$/ do |datetime, datetime_label|
   select_datetime(datetime, :from => datetime_label)
 end
 
-# Use this step in conjuction with Rail's time_select helper. For example:
+# Use this step in conjunction with Rail's time_select helper. For example:
 # When I select "2:20PM" as the time
 # Note: Rail's default time helper provides 24-hour time-- not 12 hour time. Webrat
 # will convert the 2:20PM to 14:20 and then select it. 
-When /^I select "(.*)" as the time$/ do |time|
+When /^I select "([^\"]*)" as the time$/ do |time|
   select_time(time)
 end
 
 # Use this step when using multiple time_select helpers on a page or you want to
 # specify the name of the time on the form.  For example:
 # When I select "7:30AM" as the "Gym" time
-When /^I select "(.*)" as the "(.*)" time$/ do |time, time_label|
+When /^I select "([^\"]*)" as the "([^\"]*)" time$/ do |time, time_label|
   select_time(time, :from => time_label)
 end
 
-# Use this step in conjuction with Rail's date_select helper.  For example:
+# Use this step in conjunction with Rail's date_select helper.  For example:
 # When I select "February 20, 1981" as the date
-When /^I select "(.*)" as the date$/ do |date|
+When /^I select "([^\"]*)" as the date$/ do |date|
   select_date(date)
 end
 
 # Use this step when using multiple date_select helpers on one page or
 # you want to specify the name of the date on the form. For example:
 # When I select "April 26, 1982" as the "Date of Birth" date
-When /^I select "(.*)" as the "(.*)" date$/ do |date, date_label|
+When /^I select "([^\"]*)" as the "([^\"]*)" date$/ do |date, date_label|
   select_date(date, :from => date_label)
 end
 
-When /^I check "(.*)"$/ do |field|
+When /^I check "([^\"]*)"$/ do |field|
   check(field) 
 end
 
-When /^I uncheck "(.*)"$/ do |field|
+When /^I uncheck "([^\"]*)"$/ do |field|
   uncheck(field) 
 end
 
-When /^I choose "(.*)"$/ do |field|
+When /^I choose "([^\"]*)"$/ do |field|
   choose(field)
 end
 
-When /^I attach the file at "(.*)" to "(.*)" $/ do |path, field|
+When /^I attach the file at "([^\"]*)" to "([^\"]*)"$/ do |path, field|
   attach_file(field, path)
 end
 
-Then /^I should see "(.*)"$/ do |text|
-  response.body.should =~ /#{text}/m
+Then /^I should see "([^\"]*)"$/ do |text|
+<% if framework == :rspec -%>
+  response.should contain(text)
+<% else -%>
+  assert_contain text
+<% end -%>
 end
 
-Then /^I should not see "(.*)"$/ do |text|
-  response.body.should_not =~ /#{text}/m
+Then /^I should not see "([^\"]*)"$/ do |text|
+<% if framework == :rspec -%>
+  response.should_not contain(text)
+<% else -%>
+  assert_not_contain text
+<% end -%>
 end
 
-Then /^the "(.*)" checkbox should be checked$/ do |label|
+Then /^the "([^\"]*)" checkbox should be checked$/ do |label|
+<% if framework == :rspec -%>
   field_labeled(label).should be_checked
+<% else -%>
+  assert field_labeled(label).checked?
+<% end -%>
 end

data/rails_generators/feature/feature_generator.rb

@@ -5,6 +5,10 @@ class FeatureGenerator < Rails::Generator::NamedBase
       m.directory 'features/step_definitions'
       m.template  'feature.erb', "features/manage_#{plural_name}.feature"
       m.template  'steps.erb', "features/step_definitions/#{singular_name}_steps.rb"
+
+      m.gsub_file 'features/support/paths.rb', /root_path/mi do |match|
+        "#{match}\n    when /the new #{singular_name} page/\n      new_#{singular_name}_path\n"
+      end
     end
   end
 

data/rails_generators/feature/templates/steps.erb

@@ -1,7 +1,3 @@
-Given /I am on the new <%= singular_name %> page/ do
-  visit "/<%= plural_name %>/new"
-end
-
 Given /^the following <%= plural_name %>:$/ do |<%= plural_name %>|
   <%= class_name %>.create!(<%= plural_name %>.hashes)
 end

data/spec/cucumber/ast/background_spec.rb

@@ -0,0 +1,49 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'cucumber/ast'
+
+module Cucumber
+  module Ast
+    describe Background do
+
+      before do
+        @step_mother = Object.new
+        @step_mother.extend(StepMother)
+        $x = $y = nil
+        @step_mother.Before do
+          $x = 2
+        end
+        @step_mother.Given /y is (\d+)/ do |n|
+          $y = $x * n.to_i
+        end
+        @visitor = Visitor.new(@step_mother)
+        @visitor.options = {}
+
+        @feature = mock('feature', :visit? => true).as_null_object
+      end
+
+      it "should execute Before blocks before background steps" do
+        background = Background.new(
+          comment=Comment.new(''),
+          line=2,
+          keyword="", 
+          steps=[
+            Step.new(7, "Given", "y is 5")
+          ])
+
+        scenario = Scenario.new(
+          background,
+          comment=Comment.new(""), 
+          tags=Tags.new(98,[]),
+          line=99,
+          keyword="", 
+          name="", 
+          steps=[])
+        background.feature = @feature
+        
+        @visitor.visit_background(background)
+        $x.should == 2
+        $y.should == 10
+      end
+    end
+  end
+end

data/spec/cucumber/ast/feature_factory.rb

@@ -0,0 +1,63 @@
+require 'cucumber/ast'
+require 'cucumber/step_mother'
+
+module Cucumber
+  module Ast
+    module FeatureFactory
+      class MyWorld
+        def flunk
+          raise "I flunked"
+        end
+      end
+      
+      def create_feature(step_mother)
+        step_mother.extend(StepMother)
+        step_mother.Given /^a (.*) step with an inline arg:$/ do |what, table|
+        end
+        step_mother.Given /^a (.*) step$/ do |what|
+          flunk if what == 'failing'
+        end
+        step_mother.World do
+          MyWorld.new
+        end
+
+        table = Ast::Table.new([
+          %w{1 22 333},
+          %w{4444 55555 666666}
+        ])
+        py_string = Ast::PyString.new(21, 22, %{
+           I like
+          Cucumber sandwich
+        }, 10)
+        
+        background = Ast::Background.new(Ast::Comment.new(""), 2, "Background:",
+          [
+            Step.new(3, "Given", "a passing step")
+          ]
+        )
+        
+        f = Ast::Feature.new(
+          background,
+          Ast::Comment.new("# My feature comment\n"),
+          Ast::Tags.new(6, ['one', 'two']),
+          "Pretty printing",
+          [Ast::Scenario.new(
+            background,
+            Ast::Comment.new("    # My scenario comment  \n# On two lines \n"),
+            Ast::Tags.new(8, ['three', 'four']),
+            9,
+            "Scenario:", "A Scenario",
+            [
+              Step.new(10, "Given", "a passing step with an inline arg:", table),
+              Step.new(11, "Given", "a happy step with an inline arg:", py_string),
+              Step.new(12, "Given", "a failing step")
+            ]
+          )]
+        )
+        f.file = 'features/pretty_printing.feature'
+        f.features = Features.new
+        f
+      end
+    end
+  end
+end