Skip to Content Skip to Search
Methods
A
F
P
T
Included Modules

Constants

Assertion = Minitest::Assertion
 

Class Public methods

fixture_paths

Returns the ActiveRecord::FixtureSet collection.

In your test_helper.rb you must have require "rails/test_help".

# File activesupport/lib/active_support/test_case.rb, line 122 

fixture_paths=(fixture_paths)

Sets the given path to the fixture set.

Can also append multiple paths.

ActiveSupport::TestCase.fixture_paths << "component1/test/fixtures" 

In your test_helper.rb you must have require "rails/test_help".

# File activesupport/lib/active_support/test_case.rb, line 128 

parallelize(workers: :number_of_processors, with: :processes, threshold: ActiveSupport.test_parallelization_threshold)

Parallelizes the test suite.

Takes a workers argument that controls how many times the process is forked. For each process a new database will be created suffixed with the worker number.

test-database-0 test-database-1 

If ENV["PARALLEL_WORKERS"] is set the workers argument will be ignored and the environment variable will be used instead. This is useful for CI environments, or other environments where you may need more workers than you do for local testing.

If the number of workers is set to 1 or fewer, the tests will not be parallelized.

If workers is set to :number_of_processors, the number of workers will be set to the actual core count on the machine you are on.

The default parallelization method is to fork processes. If you’d like to use threads instead you can pass with: :threads to the parallelize method. Note the threaded parallelization does not create multiple databases and will not work with system tests.

parallelize(workers: :number_of_processors, with: :threads) 

The threaded parallelization uses minitest’s parallel executor directly. The processes parallelization uses a Ruby DRb server.

Because parallelization presents an overhead, it is only enabled when the number of tests to run is above the threshold param. The default value is 50, and it’s configurable via config.active_support.test_parallelization_threshold.

# File activesupport/lib/active_support/test_case.rb, line 81 def parallelize(workers: :number_of_processors, with: :processes, threshold: ActiveSupport.test_parallelization_threshold) workers = Concurrent.processor_count if workers == :number_of_processors workers = ENV["PARALLEL_WORKERS"].to_i if ENV["PARALLEL_WORKERS"] Minitest.parallel_executor = ActiveSupport::Testing::ParallelizeExecutor.new(size: workers, with: with, threshold: threshold) end

parallelize_setup(&block)

Set up hook for parallel testing. This can be used if you have multiple databases or any behavior that needs to be run after the process is forked but before the tests run.

Note: this feature is not available with the threaded parallelization.

In your test_helper.rb add the following:

class ActiveSupport::TestCase parallelize_setup do # create databases end end 
# File activesupport/lib/active_support/test_case.rb, line 101 def parallelize_setup(&block) ActiveSupport::Testing::Parallelization.after_fork_hook(&block) end

parallelize_teardown(&block)

Clean up hook for parallel testing. This can be used to drop databases if your app uses multiple write/read databases or other clean up before the tests finish. This runs before the forked process is closed.

Note: this feature is not available with the threaded parallelization.

In your test_helper.rb add the following:

class ActiveSupport::TestCase parallelize_teardown do # drop databases end end 
# File activesupport/lib/active_support/test_case.rb, line 118 def parallelize_teardown(&block) ActiveSupport::Testing::Parallelization.run_cleanup_hook(&block) end

test_order()

Returns the order in which test cases are run.

ActiveSupport::TestCase.test_order # => :random 

Possible values are :random, :parallel, :alpha, :sorted. Defaults to :random.

# File activesupport/lib/active_support/test_case.rb, line 44 def test_order ActiveSupport.test_order ||= :random end

test_order=(new_order)

Sets the order in which test cases are run.

ActiveSupport::TestCase.test_order = :random # => :random 

Valid values are:

  • :random (to run tests in random order)

  • :parallel (to run tests in parallel)

  • :sorted (to run tests alphabetically by method name)

  • :alpha (equivalent to :sorted)

# File activesupport/lib/active_support/test_case.rb, line 34 def test_order=(new_order) ActiveSupport.test_order = new_order end

Instance Public methods

assert_no_match(matcher, obj, msg = nil)

Alias for: refute_match

# File activesupport/lib/active_support/test_case.rb, line 233 

assert_not_empty(obj, msg = nil)

Alias for: refute_empty

# File activesupport/lib/active_support/test_case.rb, line 156 

assert_not_equal(exp, act, msg = nil)

Alias for: refute_equal

# File activesupport/lib/active_support/test_case.rb, line 167 

assert_not_in_delta(exp, act, delta = 0.001, msg = nil)

Alias for: refute_in_delta

# File activesupport/lib/active_support/test_case.rb, line 178 

assert_not_in_epsilon(a, b, epsilon = 0.001, msg = nil)

Alias for: refute_in_epsilon

# File activesupport/lib/active_support/test_case.rb, line 189 

assert_not_includes(collection, obj, msg = nil)

Alias for: refute_includes

# File activesupport/lib/active_support/test_case.rb, line 200 

assert_not_instance_of(cls, obj, msg = nil)

Alias for: refute_instance_of

# File activesupport/lib/active_support/test_case.rb, line 211 

assert_not_kind_of(cls, obj, msg = nil)

Alias for: refute_kind_of

# File activesupport/lib/active_support/test_case.rb, line 222 

assert_not_nil(obj, msg = nil)

Alias for: refute_nil

# File activesupport/lib/active_support/test_case.rb, line 244 

assert_not_operator(o1, op, o2 = UNDEFINED, msg = nil)

Alias for: refute_operator

# File activesupport/lib/active_support/test_case.rb, line 255 

assert_not_predicate(o1, op, msg = nil)

Alias for: refute_predicate

# File activesupport/lib/active_support/test_case.rb, line 266 

assert_not_respond_to(obj, meth, msg = nil)

Alias for: refute_respond_to

# File activesupport/lib/active_support/test_case.rb, line 277 

assert_not_same(exp, act, msg = nil)

Alias for: refute_same

# File activesupport/lib/active_support/test_case.rb, line 288