Class: Rake::TestTask

Inherits:

TaskLib

• Object
• TaskLib
• Rake::TestTask

show all

Defined in:

lib/rake/testtask.rb

Overview

Rake::TestTask.new do |t|
  t.libs << "test"
  t.test_files = FileList['test/test*.rb']
  t.verbose = true
end

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

Instance Attribute Summary (collapse)

• - (Object) libs

  List of directories to added to $LOAD_PATH before running the tests.

• - (Object) loader

  Style of test loader to use.

• - (Object) name

  Name of test task.

• - (Object) options

  Test options passed to the test suite.

• - (Object) pattern

  Glob pattern to match test files.

• - (Object) ruby_opts

  Array of commandline options to pass to ruby when running test loader.

• - (Object) verbose

  True if verbose test output desired.

• - (Object) warning

  Request that the tests be run with the warning flag set.

Instance Method Summary (collapse)

• - (Object) define

  Create the tasks defined by this task lib.

• - (Object) file_list

  :nodoc:.

• - (Object) find_file(fn)

  :nodoc:.

• - (TestTask) initialize(name = :test) {|_self| ... } constructor

  Create a testing task.

• - (Object) option_list

  :nodoc:.

• - (Object) rake_loader

  :nodoc:.

• - (Object) test_files=(list)

  Explicitly define the list of test files to be included in a test.

Methods inherited from TaskLib

#paste

Methods included from Cloneable

#clone, #dup

79
80
81
82
83
84
85
86
87
88
89
90
91
92

# File 'lib/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

42
43
44

# File 'lib/rake/testtask.rb', line 42

def libs
  @libs
end

65
66
67

# File 'lib/rake/testtask.rb', line 65

def loader
  @loader
end

38
39
40

# File 'lib/rake/testtask.rb', line 38

def name
  @name
end

50
51
52

# File 'lib/rake/testtask.rb', line 50

def options
  @options
end

57
58
59

# File 'lib/rake/testtask.rb', line 57

def pattern
  @pattern
end

68
69
70

# File 'lib/rake/testtask.rb', line 68

def ruby_opts
  @ruby_opts
end

45
46
47

# File 'lib/rake/testtask.rb', line 45

def verbose
  @verbose
end

54
55
56

# File 'lib/rake/testtask.rb', line 54

def warning
  @warning
end

95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# File 'lib/rake/testtask.rb', line 95

def define
  lib_path = @libs.join(File::PATH_SEPARATOR)
  desc "Run tests" + (@name==:test ? "" : " for #{@name}")
  task @name do
    run_code = ''
    RakeFileUtils.verbose(@verbose) do
      run_code =
        case @loader
        when :direct
          "-e 'ARGV.each{|f| load f}'"
        when :testrb
          "-S testrb"
        when :rake
          rake_loader
        end
      @ruby_opts.unshift( "-I\"#{lib_path}\"" )
      @ruby_opts.unshift( "-w" ) if @warning
      ruby @ruby_opts.join(" ") +
        " \"#{run_code}\" " +
        file_list.collect { |fn| "\"#{fn}\"" }.join(' ') +
        " #{option_list}"
    end
  end
  self
end

125
126
127
128
129
130
131
132
133
134

# File 'lib/rake/testtask.rb', line 125

def file_list # :nodoc:
  if ENV['TEST']
    FileList[ ENV['TEST'] ]
  else
    result = []
    result += @test_files.to_a if @test_files
    result += FileList[ @pattern ].to_a if @pattern
    FileList[result]
  end
end

141
142
143
144
145
146
147

# File 'lib/rake/testtask.rb', line 141

def find_file(fn) # :nodoc:
  $LOAD_PATH.each do |path|
    file_path = File.join(path, "#{fn}.rb")
    return file_path if File.exist? file_path
  end
  nil
end

121
122
123

# File 'lib/rake/testtask.rb', line 121

def option_list # :nodoc:
  ENV['TESTOPTS'] || @options || ""
end

136
137
138
139

# File 'lib/rake/testtask.rb', line 136

def rake_loader # :nodoc:
  find_file('rake/rake_test_loader') or
    fail "unable to find rake test loader"
end

74
75
76

# File 'lib/rake/testtask.rb', line 74

def test_files=(list)
  @test_files = list
end