Methods
- assert_no_match
- assert_not_empty
- assert_not_equal
- assert_not_in_delta
- assert_not_in_epsilon
- assert_not_includes
- assert_not_instance_of
- assert_not_kind_of
- assert_not_nil
- assert_not_operator
- assert_not_predicate
- assert_not_respond_to
- assert_not_same
- fixture_paths
- fixture_paths=
- parallelize
- parallelize_setup
- parallelize_teardown
- test_order
- test_order=
Included Modules
- ActiveSupport::Testing::Assertions
- ActiveSupport::Testing::ErrorReporterAssertions
- ActiveSupport::Testing::Deprecation
- ActiveSupport::Testing::ConstantStubbing
- ActiveSupport::Testing::TimeHelpers
- ActiveSupport::Testing::FileFixtures
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"
.
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"
.
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
.
π Source code
# File activesupport/lib/active_support/test_case.rb, line 80
def parallelize(workers: :number_of_processors, with: :processes, threshold: ActiveSupport.test_parallelization_threshold)
workers = Concurrent.physical_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
π See on GitHub
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
π Source code
# File activesupport/lib/active_support/test_case.rb, line 100
def parallelize_setup(&block)
ActiveSupport::Testing::Parallelization.after_fork_hook(&block)
end
π See on GitHub
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
π Source code
# File activesupport/lib/active_support/test_case.rb, line 117
def parallelize_teardown(&block)
ActiveSupport::Testing::Parallelization.run_cleanup_hook(&block)
end
π See on GitHub
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
.
π Source code
# File activesupport/lib/active_support/test_case.rb, line 43
def test_order
ActiveSupport.test_order ||= :random
end
π See on GitHub
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
)
π Source code
# File activesupport/lib/active_support/test_case.rb, line 33
def test_order=(new_order)
ActiveSupport.test_order = new_order
end
π See on GitHub
Instance Public methods
assert_not_in_delta(exp, act, delta = 0.001, msg = nil)
Alias for: refute_in_delta
assert_not_in_epsilon(a, b, epsilon = 0.001, msg = nil)
Alias for: refute_in_epsilon
assert_not_operator(o1, op, o2 = UNDEFINED, msg = nil)
Alias for: refute_operator