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 80 def initialize(name=:test) @name = name @libs = ["lib"] @pattern = nil @options = nil @test_files = nil @verbose = false @warning = false @loader = :rake @ruby_opts = [] @description = "Run tests" + (@name == :test ? "" : " for #{@name}") 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 97 def define desc @description 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
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 75 def test_files=(list) @test_files = list end