Maintenance of Ruby 2.0.0 ended on February 24, 2016. Read more
Create a task that runs a set of tests.
Example:
Rake::TestTask.new do |t| t.libs << "test" t.test_files = FileList['test/test*.rb'] t.verbose = true end
If rake is invoked with a “TEST=filename” command line option, then the list of test files will be overridden to include only the filename specified on the command line. This provides an easy way to run just one test.
If rake is invoked with a “TESTOPTS=options” command line option, then the given options are passed to the test process after a '–'. This allows Test::Unit options to be passed to the test suite.
Examples:
rake test # run tests normally rake test TEST=just_one_file.rb # run just one test file. rake test TESTOPTS="-v" # run in verbose mode rake test TESTOPTS="--runner=fox" # use the fox test runner
Style of test loader to use. Options are:
:rake – Rake provided test loading script (default).
:testrb – Ruby provided test loading script.
:direct – Load tests using command line loader.
Create a testing task.
# File rake/testtask.rb, line 79 def initialize(name=:test) @name = name @libs = ["lib"] @pattern = nil @options = nil @test_files = nil @verbose = false @warning = false @loader = :rake @ruby_opts = [] yield self if block_given? @pattern = 'test/test*.rb' if @pattern.nil? && @test_files.nil? define end
Create the tasks defined by this task lib.
# File rake/testtask.rb, line 95 def define desc "Run tests" + (@name==:test ? "" : " for #{@name}") task @name do FileUtilsExt.verbose(@verbose) do args = "#{ruby_opts_string} #{run_code} #{file_list_string} #{option_list}" ruby args do |ok, status| if !ok && status.respond_to?(:signaled?) && status.signaled? raise SignalException.new(status.termsig) elsif !ok fail "Command failed with status (#{status.exitstatus}): [ruby #{args}]" end end end end self end
# File rake/testtask.rb, line 132 def file_list_string file_list.collect { |fn| "\"#{fn}\"" }.join(' ') end
# File rake/testtask.rb, line 128 def lib_path @libs.join(File::PATH_SEPARATOR) end
# File rake/testtask.rb, line 121 def ruby_opts_string opts = @ruby_opts.dup opts.unshift( "-I\"#{lib_path}\"" ) unless @libs.empty? opts.unshift( "-w" ) if @warning opts.join(" ") end
# File rake/testtask.rb, line 156 def ruby_version RUBY_VERSION end
# File rake/testtask.rb, line 160 def run_code case @loader when :direct "-e \"ARGV.each{|f| require f}\"" when :testrb "-S testrb #{fix}" when :rake "-I\"#{rake_lib_dir}\" \"#{rake_loader}\"" end end
Explicitly define the list of test files to be included in a test.
list
is expected to be an array of file names (a FileList is acceptable). If both
pattern
and test_files
are used, then the list of
test files is the union of the two.
# File rake/testtask.rb, line 74 def test_files=(list) @test_files = list end