dwaite-cucumber 0.3.101

data/features/rake_task.feature

@@ -0,0 +1,178 @@
+Feature: Rake task
+  In order to ease the development process
+  As a developer and CI server administrator
+  Cucumber features should be executable via Rake
+
+  Background:
+    Given a standard Cucumber project directory structure
+    And a file named "features/missing_step_definitions.feature" with:
+      """
+      Feature: Sample
+
+        Scenario: Wanted
+          Given I want to run this
+
+        Scenario: Unwanted
+          Given I don't want this ran
+      """
+
+
+  Scenario: rake task with a defined profile
+    Given the following profile is defined:
+      """
+      foo: --quiet --no-color features/missing_step_definitions.feature:3
+      """
+    And a file named "Rakefile" with:
+      """
+      $LOAD_PATH.unshift(CUCUMBER_LIB)
+      require 'cucumber/rake/task'
+
+      Cucumber::Rake::Task.new(:features) do |t|
+        t.profile = "foo"
+      end
+      """
+    When I run rake features
+    Then it should pass
+    And the output should contain
+      """
+      Feature: Sample
+
+        Scenario: Wanted
+          Given I want to run this
+
+      1 scenario (1 undefined)
+      1 step (1 undefined)
+      """
+
+  Scenario: rake task with a defined profile and cucumber_opts
+    Given the following profile is defined:
+      """
+      bar: ['features/missing_step_definitions.feature:3']
+      """
+    And a file named "Rakefile" with:
+      """
+      $LOAD_PATH.unshift(CUCUMBER_LIB)
+      require 'cucumber/rake/task'
+
+      Cucumber::Rake::Task.new(:features) do |t|
+        t.profile = "bar"
+        t.cucumber_opts = %w{--quiet --no-color}
+      end
+      """
+    When I run rake features
+    Then it should pass
+    And the output should contain
+      """
+      Feature: Sample
+
+        Scenario: Wanted
+          Given I want to run this
+
+      1 scenario (1 undefined)
+      1 step (1 undefined)
+      """
+
+  Scenario: rake task with a defined profile and feature list
+    Given a file named "features/the_one_i_want_to_run.feature" with:
+      """
+      Feature: Desired
+
+        Scenario: Something
+          Given this is missing
+      """
+    Given the following profile is defined:
+      """
+      baz: ['--quiet', '--no-color']
+      """
+    And a file named "Rakefile" with:
+      """
+      $LOAD_PATH.unshift(CUCUMBER_LIB)
+      require 'cucumber/rake/task'
+
+      Cucumber::Rake::Task.new(:features) do |t|
+        t.profile = "baz"
+        t.feature_list = ['features/the_one_i_want_to_run.feature']
+      end
+      """
+    When I run rake features
+    Then it should pass
+    And the output should contain
+      """
+      Feature: Desired
+
+        Scenario: Something
+          Given this is missing
+
+      1 scenario (1 undefined)
+      1 step (1 undefined)
+      """
+
+  Scenario: deprecation warnings
+    Given a file named "Rakefile" with:
+      """
+      $LOAD_PATH.unshift(CUCUMBER_LIB)
+      require 'cucumber/rake/task'
+
+      Cucumber::Rake::Task.new(:features) do |t|
+        t.feature_list = ['features/missing_step_definitions.feature']
+      end
+      """
+    When I run rake features
+    Then it should pass
+    And STDERR should match
+      """
+      Cucumber::Rake::Task#feature_list is deprecated and will be removed in 0.4.0.  Please use profiles for complex settings: http://wiki.github.com/aslakhellesoy/cucumber/using-rake#profiles
+      """
+
+  Scenario: respect requires
+    Given a file named "features/support/env.rb"
+    And a file named "features/support/dont_require_me.rb"
+    And the following profile is defined:
+      """
+      no_bomb: features/missing_step_definitions.feature:3 --require features/support/env.rb --verbose
+      """
+    And a file named "Rakefile" with:
+      """
+      $LOAD_PATH.unshift(CUCUMBER_LIB)
+      require 'cucumber/rake/task'
+
+      Cucumber::Rake::Task.new(:features) do |t|
+        t.profile = "no_bomb"
+        t.cucumber_opts = %w{--quiet --no-color}
+      end
+      """
+
+    When I run rake features
+    Then it should pass
+    And the output should not contain
+      """
+        * features/support/dont_require_me.rb
+      """
+
+  Scenario: feature files with spaces
+    Given a file named "features/spaces are nasty.feature" with:
+       """
+       Feature: The futures green
+
+         Scenario: Orange
+           Given this is missing
+       """
+    And a file named "Rakefile" with:
+       """
+       $LOAD_PATH.unshift(CUCUMBER_LIB)
+       require 'cucumber/rake/task'
+
+       Cucumber::Rake::Task.new(:features) do |t|
+         t.cucumber_opts = %w{--quiet --no-color}
+       end
+       """
+    When I run rake features
+    Then it should pass
+    And the output should contain
+       """
+       Feature: The futures green
+
+         Scenario: Orange
+           Given this is missing
+
+       """

data/features/report_called_undefined_steps.feature

@@ -0,0 +1,35 @@
+Feature: Cucumber command line
+  In order to find out what step definitions need to be implemented
+  Developers should always see what step definition is missing
+
+  @mri186
+  Scenario: Get info at arbitrary levels of nesting
+    When I run cucumber features/call_undefined_step_from_step_def.feature
+    Then it should pass with
+      """
+      Feature: Calling undefined step
+
+        Scenario: Call directly                                # features/call_undefined_step_from_step_def.feature:3
+          Given a step definition that calls an undefined step # features/step_definitions/sample_steps.rb:19
+            Undefined step: "this does not exist" (Cucumber::Undefined)
+            ./features/step_definitions/sample_steps.rb:20:in `/^a step definition that calls an undefined step$/'
+            features/call_undefined_step_from_step_def.feature:4:in `Given a step definition that calls an undefined step'
+
+        Scenario: Call via another                                         # features/call_undefined_step_from_step_def.feature:6
+          Given call step "a step definition that calls an undefined step" # features/step_definitions/sample_steps.rb:23
+            Undefined step: "this does not exist" (Cucumber::Undefined)
+            ./features/step_definitions/sample_steps.rb:20:in `/^a step definition that calls an undefined step$/'
+            features/call_undefined_step_from_step_def.feature:7:in `Given call step "a step definition that calls an undefined step"'
+
+      2 scenarios (2 undefined)
+      2 steps (2 undefined)
+
+      You can implement step definitions for undefined steps with these snippets:
+
+      Given /^this does not exist$/ do
+        pending
+      end
+
+
+      """
+

data/features/snippet.feature

@@ -0,0 +1,22 @@
+Feature: Snippets
+  In order to help speed up writing step definitions
+  As a feature editor
+  I want snippet suggestions for undefined step definitions
+
+  Scenario: Snippet for undefined step with a pystring
+    When I run cucumber features/undefined_multiline_args.feature:3 -s
+    Then the output should contain
+      """
+      Given /^a pystring$/ do |string|
+        pending
+      end
+      """
+  Scenario: Snippet for undefined step with a step table
+    When I run cucumber features/undefined_multiline_args.feature:9 -s
+    Then the output should contain
+      """
+      Given /^a table$/ do |table|
+        # table is a Cucumber::Ast::Table
+        pending
+      end
+      """

data/features/step_definitions/cucumber_steps.rb

@@ -0,0 +1,154 @@
+require 'tempfile'
+
+Given /^I am in (.*)$/ do |example_dir_relative_path|
+  @current_dir = examples_dir(example_dir_relative_path)
+end
+
+Given /^a standard Cucumber project directory structure$/ do
+  @current_dir = working_dir
+  in_current_dir do
+    FileUtils.mkdir_p 'features/support'
+    FileUtils.mkdir 'features/step_definitions'
+  end
+end
+
+Given /^the (.*) directory is empty$/ do |directory|
+  in_current_dir do
+    FileUtils.remove_dir(directory) rescue nil
+    FileUtils.mkdir 'tmp'
+  end
+end
+
+Given /^a file named "([^\"]*)"$/ do |file_name|
+  create_file(file_name, '')
+end
+
+Given /^a file named "([^\"]*)" with:$/ do |file_name, file_content|
+  create_file(file_name, file_content)
+end
+
+Given /^the following profiles? (?:are|is) defined:$/ do |profiles|
+  create_file('cucumber.yml', profiles)
+end
+
+Given /^I am running spork in the background$/ do
+  run_spork_in_background
+end
+
+Given /^I am running spork in the background on port (\d+)$/ do |port|
+  run_spork_in_background(port.to_i)
+end
+
+Given /^I am not running (?:.*) in the background$/ do
+  # no-op
+end
+
+Given /^I have environment variable (\w+) set to "([^\"]*)"$/ do |variable, value|
+  set_env_var(variable, value)
+end
+
+When /^I run cucumber (.*)$/ do |cucumber_opts|
+  run "#{Cucumber::RUBY_BINARY} #{Cucumber::BINARY} --no-color #{cucumber_opts}"
+end
+
+When /^I run rake (.*)$/ do |rake_opts|
+  run "rake #{rake_opts} --trace"
+end
+
+Then /^it should (fail|pass)$/ do |success|
+  if success == 'fail'
+    last_exit_status.should_not == 0
+  else
+    if last_exit_status != 0
+      raise "Failed with exit status #{last_exit_status}\nSTDOUT:\n#{last_stdout}\nSTDERR:\n#{last_stderr}"
+    end
+  end
+end
+
+Then /^it should (fail|pass) with$/ do |success, output|
+  last_stdout.should == output
+  Then("it should #{success}")
+end
+
+Then /^the output should contain$/ do |text|
+  last_stdout.should include(text)
+end
+
+Then /^the output should not contain$/ do |text|
+  last_stdout.should_not include(text)
+end
+
+Then /^the output should be$/ do |text|
+  last_stdout.should == text
+end
+
+
+Then /^"([^\"]*)" should contain$/ do |file, text|
+  strip_duration(IO.read(file)).should == text
+end
+
+Then /^"([^\"]*)" with junit duration "([^\"]*)" should contain$/ do |actual_file, duration_replacement, text|
+  actual = IO.read(actual_file)
+  actual = replace_junit_duration(actual, duration_replacement) 
+  actual = strip_ruby186_extra_trace(actual)
+  actual.should == text
+end
+
+Then /^"([^\"]*)" should match "([^\"]*)"$/ do |file, text|
+  IO.read(file).should =~ Regexp.new(text)
+end
+
+Then /^"([^\"]*)" should have the same contents as "([^\"]*)"$/ do |actual_file, expected_file|
+  actual = IO.read(actual_file)
+  actual = replace_duration(actual, '0m30.005s')
+  # Comment out to replace expected file. Use with care!
+  File.open(expected_file, "w") {|io| io.write(actual)}
+  actual.should == IO.read(expected_file)
+end
+
+Then /^STDERR should match$/ do |text|
+  last_stderr.should =~ /#{text}/
+end
+
+Then /^STDERR should not match$/ do |text|
+  last_stderr.should_not =~ /#{text}/
+end
+
+Then /^STDERR should be$/ do |text|
+  last_stderr.should == text
+end
+
+Then /^STDERR should be empty$/ do
+  last_stderr.should == ""
+end
+
+Then /^"([^\"]*)" should exist$/ do |file|
+  File.exists?(file).should be_true
+  FileUtils.rm(file)
+end
+
+Then /^"([^\"]*)" should not be required$/ do |file_name|
+  last_stdout.should_not include("* #{file_name}")
+end
+
+Then /^"([^\"]*)" should be required$/ do |file_name|
+  last_stdout.should include("* #{file_name}")
+end
+
+Then /^exactly these files should be loaded:\s*(.*)$/ do |files|
+  last_stdout.scan(/^  \* (.*\.rb)$/).flatten.should == files.split(/,\s+/)
+end
+
+Then /^exactly these features should be ran:\s*(.*)$/ do |files|
+  last_stdout.scan(/^  \* (.*\.feature)$/).flatten.should == files.split(/,\s+/)
+end
+
+Then /^the (.*) profile should be used$/ do |profile|
+  last_stdout.should =~ /Using the #{profile} profile/
+end
+
+Then /^print output$/ do
+  puts last_stdout
+end
+
+

data/features/step_definitions/extra_steps.rb

@@ -0,0 +1,2 @@
+Given /^missing$/ do
+end

data/features/steps_formatter.feature

@@ -0,0 +1,25 @@
+Feature: --formatter steps option - Steps Formatter
+  In order to easily see which steps are already defined,
+  specially when using 3rd party steps libraries,
+  Cucumber should show the available steps in a user-friendly format
+
+  Background:
+    Given I am in steps_library
+
+  Scenario: Printing steps
+    When I run cucumber -f steps features
+    Then it should pass with
+    """
+    features/step_definitions/steps_lib1.rb
+      /^I defined a first step$/           # features/step_definitions/steps_lib1.rb:1
+      /^I define a second step$/           # features/step_definitions/steps_lib1.rb:4
+      /^I should also have a third step$/  # features/step_definitions/steps_lib1.rb:7
+    
+    features/step_definitions/steps_lib2.rb
+      /^I defined a step 4$/                # features/step_definitions/steps_lib2.rb:1
+      /^I create a step 5$/                 # features/step_definitions/steps_lib2.rb:4
+      /^I should be too tired for step 6$/  # features/step_definitions/steps_lib2.rb:7
+    
+    6 step definition(s) in 2 source file(s).
+
+    """

data/features/support/env.rb

@@ -0,0 +1,139 @@
+require 'rubygems'
+require 'tempfile'
+require 'spec/expectations'
+require 'fileutils'
+require 'forwardable'
+begin
+  require 'spork'
+rescue Gem::LoadError => ex
+  gem 'spork', '>= 0.5.9' # Ensure correct spork version number to avoid false-negatives.
+end
+
+class CucumberWorld
+  extend Forwardable
+  def_delegators CucumberWorld, :examples_dir, :self_test_dir, :working_dir, :cucumber_lib_dir
+
+  def self.examples_dir(subdir=nil)
+    @examples_dir ||= File.expand_path(File.join(File.dirname(__FILE__), '../../examples'))
+    subdir ? File.join(@examples_dir, subdir) : @examples_dir
+  end
+
+  def self.self_test_dir
+    @self_test_dir ||= examples_dir('self_test')
+  end
+
+  def self.working_dir
+    @working_dir ||= examples_dir('self_test/tmp')
+  end
+
+  def cucumber_lib_dir
+    @cucumber_lib_dir ||= File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+  end
+
+  def initialize
+    @current_dir = self_test_dir
+  end
+
+  private
+  attr_reader :last_exit_status, :last_stderr
+
+  # The last standard out, with the duration line taken out (unpredictable)
+  def last_stdout
+    strip_duration(@last_stdout)
+  end
+
+  def strip_duration(s)
+    s.gsub(/^\d+m\d+\.\d+s\n/m, "")
+  end
+
+  def replace_duration(s, replacement)
+    s.gsub(/\d+m\d+\.\d+s/m, replacement)
+  end
+
+  def replace_junit_duration(s, replacement)
+    s.gsub(/\d+\.\d\d+/m, replacement)
+  end
+
+  def strip_ruby186_extra_trace(s)  
+    s.gsub(/^.*\.\/features\/step_definitions(.*)\n/, "")
+  end
+
+  def create_file(file_name, file_content)
+    file_content.gsub!("CUCUMBER_LIB", "'#{cucumber_lib_dir}'") # Some files, such as Rakefiles need to use the lib dir
+    in_current_dir do
+      File.open(file_name, 'w') { |f| f << file_content }
+    end
+  end
+
+  def set_env_var(variable, value)
+    @original_env_vars ||= {}
+    @original_env_vars[variable] = ENV[variable] 
+    ENV[variable]  = value
+  end
+
+  def background_jobs
+    @background_jobs ||= []
+  end
+
+  def in_current_dir(&block)
+    Dir.chdir(@current_dir, &block)
+  end
+
+  def run(command)
+    stderr_file = Tempfile.new('cucumber')
+    stderr_file.close
+    in_current_dir do
+      @last_stdout = `#{command} 2> #{stderr_file.path}`
+      mode = Cucumber::RUBY_1_9 ? {:external_encoding=>"UTF-8"} : 'r'
+      IO.popen("#{command} 2> #{stderr_file.path}", mode) do |io|
+        @last_stdout = io.read
+      end
+
+      @last_exit_status = $?.exitstatus
+    end
+    @last_stderr = IO.read(stderr_file.path)
+  end
+
+  def run_spork_in_background(port = nil)
+    pid = fork
+    in_current_dir do
+      if pid
+        background_jobs << pid
+      else
+        # STDOUT.close
+        # STDERR.close
+        port_arg = port ? "-p #{port}" : ''
+        cmd = "#{Cucumber::RUBY_BINARY} -I #{Cucumber::LIBDIR} #{Spork::BINARY} cuc #{port_arg}"
+        exec cmd
+      end
+    end
+    sleep 0.2
+  end
+
+  def terminate_background_jobs
+    if @background_jobs
+      @background_jobs.each do |pid|
+        Process.kill(Signal.list['TERM'], pid)
+      end
+    end
+  end
+
+  def restore_original_env_vars
+    @original_env_vars.each { |variable, value| ENV[variable] = value } if @original_env_vars
+  end
+
+end
+
+World do
+  CucumberWorld.new
+end
+
+Before do
+  FileUtils.rm_rf CucumberWorld.working_dir
+  FileUtils.mkdir CucumberWorld.working_dir
+end
+
+After do
+  terminate_background_jobs
+  restore_original_env_vars
+end

data/features/table_diffing.feature

@@ -0,0 +1,45 @@
+Feature: Table diffing
+  In order to more easily compare data in tables
+  step definition writers should be able to diff
+  a table with expected data and see the diff inline
+  
+  Scenario: Extra row
+    Given a standard Cucumber project directory structure
+    And a file named "features/tables.feature" with:
+      """
+      Feature: Tables
+        Scenario: Extra row
+          Then the table should be:
+            | x | y |
+            | a | b |
+      """
+    And a file named "features/step_definitions/table_steps.rb" with:
+      """
+      Then /the table should be:/ do |expected|
+        expected.diff!(table(%{
+          | x | y | 
+          | a | c |
+        }))
+      end
+      """
+    When I run cucumber -i features/tables.feature
+    Then it should fail with
+      """
+      Feature: Tables
+      
+        Scenario: Extra row         # features/tables.feature:2
+          Then the table should be: # features/step_definitions/table_steps.rb:1
+            | x | y |
+            | a | b |
+            | a | c |
+            Tables were not identical (RuntimeError)
+            ./features/step_definitions/table_steps.rb:2:in `/the table should be:/'
+            features/tables.feature:3:in `Then the table should be:'
+      
+      Failing Scenarios:
+      cucumber features/tables.feature:2 # Scenario: Extra row
+
+      1 scenario (1 failed)
+      1 step (1 failed)
+
+      """

data/features/transform.feature

@@ -0,0 +1,24 @@
+Feature: transform
+  In order to maintain modularity within step definitions
+  As a step definition editor
+  I want to register a regex to capture and tranform step definition arguments.
+
+  Scenario: run a specific scenario with a registered transform
+    When I run cucumber -q features/transform_sample.feature --require features
+    Then it should pass with
+    """
+    Feature: Step argument transformations
+    
+      Scenario: transform with matches
+        Then I should transform '10' to an Integer
+
+      Scenario: transform with matches that capture
+        Then I should transform 'abc' to a Symbol
+
+      Scenario: transform without matches
+        Then I should not transform '10' to an Integer
+
+    3 scenarios (3 passed)
+    3 steps (3 passed)
+    
+    """

data/features/unicode_table.feature

@@ -0,0 +1,35 @@
+Feature: Unicode in tables
+  In order to please the whole world,
+  unicode characters in tables should be
+  properly aligned
+  
+  Scenario: All sorts of weird stuff
+    Given a standard Cucumber project directory structure
+    And a file named "features/unicode.feature" with:
+      """
+      Feature: Featuring unicode
+
+        Scenario: So what, whatever
+          Given passing
+            | Brüno | abc |
+            | Bruno | æøå |
+      """
+    And a file named "features/env.rb" with:
+      """
+      $KCODE='u'
+      """
+    When I run cucumber -q --dry-run features/unicode.feature
+    Then it should pass with
+      """
+      Feature: Featuring unicode
+
+        Scenario: So what, whatever
+          Given passing
+            | Brüno | abc |
+            | Bruno | æøå |
+
+      1 scenario (1 undefined)
+      1 step (1 undefined)
+
+      """
+