Module: Tap::Test::SubsetTest

Defined in:
lib/tap/test/subset_test.rb,
lib/tap/test/subset_test/class_methods.rb

Overview

SubsetTest provides methods to conditionally run tests.

require 'tap/test'

class Test::Unit::TestCase
  # only true if running on windows
  condition(:windows) { match_platform?('mswin') }

  # only true if running on anything but windows
  condition(:non_windows) { match_platform?('non_mswin') }
end

Here the WindowsOnlyTest will only run on a Windows platform. Conditions like these may be targeted at specific tests when only some tests need to be skipped.

class RunOnlyAFewTest < Test::Unit::TestCase
  include SubsetTest

  def test_runs_all_the_time
    assert true
  end

  def test_runs_only_if_non_windows_condition_is_true
    condition_test(:non_windows) { assert true }
    end
  end

  def test_runs_only_when_ENV_variable_EXTENDED_is_true
    extended_test { assert true }
  end

  def test_runs_only_when_ENV_variable_BENCHMARK_is_true
    benchmark_test do |x|
      x.report("init speed") { 10000.times { Object.new } }
    end
  end

  def test_runs_only_when_ENV_variable_CUSTOM_is_true
    subset_test('CUSTOM') { assert true }
  end
end

In the example, the ENV variables EXTENDED, BENCHMARK, and CUSTOM act as flags to run specific tests. See SubsetTest::ClassMethods for more information.

Defined Under Namespace

Modules: ClassMethods

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object

:nodoc:



55
56
57
58
 
# File 'lib/tap/test/subset_test.rb', line 55

def self.included(base) # :nodoc:
  super
  base.extend SubsetTest::ClassMethods
end

Instance Method Details

#benchmark_test(length = 10, &block) ⇒ Object

Declares a subset_test for the ENV variable ‘BENCHMARK’. If run, benchmark_test sets up benchmarking using the Benchmark.bm method using the input length and block. Prints ‘b’ if the test is not run.

include Benchmark
def test_speed
  benchmark_test(10) {|x| ... }
end



191
192
193
194
195
196
197
 
# File 'lib/tap/test/subset_test.rb', line 191

def benchmark_test(length=10, &block) 
  subset_test("BENCHMARK") do
    puts
    puts name
    Benchmark.bm(length, &block)
  end
end

#condition_test(*condition_names) ⇒ Object

Conditonal test. Only runs if the specified conditions are satisfied. If no conditons are explicitly set, condition_test only runs if ALL conditions for the test are satisfied.

condition(:is_true) { true }
condition(:is_false) { false }

def test_only_if_true_is_satisfied
  condition_test(:is_true) { # runs }
end

def test_only_if_all_conditions_are_satisfied
  condition_test {  # does not run }
end

See SubsetTestClass#condition for more details.



113
114
115
116
117
118
119
 
# File 'lib/tap/test/subset_test.rb', line 113

def condition_test(*condition_names)
  if self.class.unsatisfied_conditions(*condition_names).empty?
    yield
  else
    print ' '
  end
end

#extended_test(&block) ⇒ Object

Declares a subset_test for the ENV variable ‘EXTENDED’. Prints ‘x’ if the test is not run.

def test_some_long_process
  extended_test { ... }
end



179
180
181
 
# File 'lib/tap/test/subset_test.rb', line 179

def extended_test(&block) 
  subset_test("EXTENDED", "x", &block)
end

#match_regexp?(type, str, default = true) ⇒ Boolean

Returns true if the input string matches the regexp specified in ENV. Returns the default value if ENV is ‘true’, and the default if type is not specified in ENV.

Returns:

  • (Boolean) 


74
75
76
77
78
79
 
# File 'lib/tap/test/subset_test.rb', line 74

def match_regexp?(type, str, default=true)
  return true if ENV["ALL"] == 'true'
  return default unless value = ENV[type]
    
  str =~ Regexp.new(value) ? true : false
end

#platform_test(*platforms) ⇒ Object

Platform-specific test. Useful for specifying test that should only be run on a subset of platforms. Prints ‘ ’ if the test is not run.

def test_only_on_windows
  platform_test('mswin') { ... }
end

See SubsetTestClass#match_platform? for matching details.



89
90
91
92
93
94
95
 
# File 'lib/tap/test/subset_test.rb', line 89

def platform_test(*platforms)
  if self.class.match_platform?(*platforms)
    yield
  else
    print ' '
  end
end

#run_subset?(type) ⇒ Boolean

Returns true if the subset type (ex ‘BENCHMARK’) or ‘ALL’ is specified in ENV.

Returns:

  • (Boolean) 


67
68
69
 
# File 'lib/tap/test/subset_test.rb', line 67

def run_subset?(type)
  self.class.run_subset?(type)
end

#satisfied?(*condition_names) ⇒ Boolean

Returns true if the specified conditions are satisfied.

Returns:

  • (Boolean) 


61
62
63
 
# File 'lib/tap/test/subset_test.rb', line 61

def satisfied?(*condition_names)
  self.class.satisfied?(*condition_names)
end

#subset_test(type, skip = type[0..0].downcase) ⇒ Object

Defines a subset test. The provided block will only run if:

  • the subset type is specified in ENV

  • the subset ‘ALL’ is specified in ENV

  • the test method name matches the regexp provided in the <TYPE>_TEST ENV variable

Otherwise the block will be skipped and skip will be printed in the test output. By default skip is the first letter of type.

For example, with these methods:

def test_one
  subset_test('CUSTOM') { assert true }
end

def test_two
  subset_test('CUSTOM') { assert true }
end

Condition                    Tests that get run
ENV['ALL']=true              test_one, test_two
ENV['CUSTOM']=true           test_one, test_two
ENV['CUSTOM_TEST']=test_     test_one, test_two
ENV['CUSTOM_TEST']=test_one  test_one
ENV['CUSTOM']=nil            no tests get run

If you’re running your tests with rake (or rap), ENV variables may be set from the command line.

# all tests
% rap test all=true

# custom subset tests
% rap test custom=true

# just test_one (it is the only test
# matching the '.est_on.' pattern)
% rap test custom_test=.est_on.



160
161
162
163
164
165
166
167
168
169
170
171
 
# File 'lib/tap/test/subset_test.rb', line 160

def subset_test(type, skip=type[0..0].downcase)
  type = type.upcase
  if run_subset?(type) || ENV["#{type}_TEST"]
    if match_regexp?("#{type}_TEST", name.to_s)
      yield
    else
      print skip
    end
  else
    print skip
  end
end