Class: Cucumber::Rake::Task
Overview
Defines a Rake task for running features.
The simplest use of it goes something like:
Cucumber::Rake::Task.new
This will define a task named cucumber
described as ‘Run Cucumber features’. It will use steps from ‘features/*/.rb’ and features in ‘features/*/.feature’.
To further configure the task, you can pass a block:
Cucumber::Rake::Task.new do |t|
t.cucumber_opts = %w{--format progress}
end
This task can also be configured to be run with RCov:
Cucumber::Rake::Task.new do |t|
t.rcov = true
end
See the attributes for additional configuration possibilities.
Defined Under Namespace
Classes: ForkedCucumberRunner, InProcessCucumberRunner, RCovCucumberRunner
Constant Summary collapse
- LIB =
:nodoc:
File.(File.dirname(__FILE__) + '/../..')
Instance Attribute Summary collapse
-
#binary ⇒ Object
Name of the cucumber binary to use for running features.
-
#cucumber_opts ⇒ Object
Extra options to pass to the cucumber binary.
-
#fork ⇒ Object
Whether or not to fork a new ruby interpreter.
-
#libs ⇒ Object
Directories to add to the Ruby $LOAD_PATH.
-
#profile ⇒ Object
Define what profile to be used.
-
#rcov ⇒ Object
Run cucumber with RCov? Defaults to false.
-
#rcov_opts ⇒ Object
Extra options to pass to rcov.
Instance Method Summary collapse
-
#cucumber_opts_with_profile ⇒ Object
:nodoc:.
-
#define_task ⇒ Object
:nodoc:.
-
#feature_files ⇒ Object
:nodoc:.
-
#initialize(task_name = "cucumber", desc = "Run Cucumber features") {|_self| ... } ⇒ Task
constructor
Define Cucumber Rake task.
- #make_command_line_safe(list) ⇒ Object
-
#runner(task_args = nil) ⇒ Object
:nodoc:.
Constructor Details
#initialize(task_name = "cucumber", desc = "Run Cucumber features") {|_self| ... } ⇒ Task
Define Cucumber Rake task
125 126 127 128 129 130 131 132 133 134 135 136 137 |
# File 'lib/cucumber/rake/task.rb', line 125 def initialize(task_name = "cucumber", desc = "Run Cucumber features") @task_name, @desc = task_name, desc @fork = true @libs = ['lib'] @rcov_opts = %w{--rails --exclude osx\/objc,gems\/} yield self if block_given? @binary = binary.nil? ? Cucumber::BINARY : File.(binary) @libs.insert(0, LIB) if binary == Cucumber::BINARY define_task end |
Instance Attribute Details
#binary ⇒ Object
Name of the cucumber binary to use for running features. Defaults to Cucumber::BINARY
95 96 97 |
# File 'lib/cucumber/rake/task.rb', line 95 def binary @binary end |
#cucumber_opts ⇒ Object
Extra options to pass to the cucumber binary. Can be overridden by the CUCUMBER_OPTS environment variable. It’s recommended to pass an Array, but if it’s a String it will be #split by ‘ ’.
99 100 101 |
# File 'lib/cucumber/rake/task.rb', line 99 def cucumber_opts @cucumber_opts end |
#fork ⇒ Object
Whether or not to fork a new ruby interpreter. Defaults to true. You may gain some startup speed if you set it to false, but this may also cause issues with your load path and gems.
118 119 120 |
# File 'lib/cucumber/rake/task.rb', line 118 def fork @fork end |
#libs ⇒ Object
Directories to add to the Ruby $LOAD_PATH
92 93 94 |
# File 'lib/cucumber/rake/task.rb', line 92 def libs @libs end |
#profile ⇒ Object
Define what profile to be used. When used with cucumber_opts it is simply appended to it. Will be ignored when CUCUMBER_OPTS is used.
122 123 124 |
# File 'lib/cucumber/rake/task.rb', line 122 def profile @profile end |
#rcov ⇒ Object
Run cucumber with RCov? Defaults to false. If you set this to true, fork
is implicit.
106 107 108 |
# File 'lib/cucumber/rake/task.rb', line 106 def rcov @rcov end |
#rcov_opts ⇒ Object
Extra options to pass to rcov. It’s recommended to pass an Array, but if it’s a String it will be #split by ‘ ’.
110 111 112 |
# File 'lib/cucumber/rake/task.rb', line 110 def rcov_opts @rcov_opts end |
Instance Method Details
#cucumber_opts_with_profile ⇒ Object
:nodoc:
157 158 159 |
# File 'lib/cucumber/rake/task.rb', line 157 def cucumber_opts_with_profile #:nodoc: @profile ? [cucumber_opts, '--profile', @profile] : cucumber_opts end |
#define_task ⇒ Object
:nodoc:
139 140 141 142 143 144 |
# File 'lib/cucumber/rake/task.rb', line 139 def define_task #:nodoc: desc @desc task @task_name do runner.run end end |
#feature_files ⇒ Object
:nodoc:
161 162 163 |
# File 'lib/cucumber/rake/task.rb', line 161 def feature_files #:nodoc: make_command_line_safe(FileList[ ENV['FEATURE'] || [] ]) end |
#make_command_line_safe(list) ⇒ Object
165 166 167 |
# File 'lib/cucumber/rake/task.rb', line 165 def make_command_line_safe(list) list.map{|string| string.gsub(' ', '\ ')} end |
#runner(task_args = nil) ⇒ Object
:nodoc:
146 147 148 149 150 151 152 153 154 155 |
# File 'lib/cucumber/rake/task.rb', line 146 def runner(task_args = nil) #:nodoc: cucumber_opts = [(ENV['CUCUMBER_OPTS'] ? ENV['CUCUMBER_OPTS'].split(/\s+/) : nil) || cucumber_opts_with_profile] if(@rcov) RCovCucumberRunner.new(libs, binary, cucumber_opts, feature_files, rcov_opts) elsif(@fork) ForkedCucumberRunner.new(libs, binary, cucumber_opts, feature_files) else InProcessCucumberRunner.new(libs, cucumber_opts, feature_files) end end |