- A
- F
- P
- T
- ActiveSupport::Testing::Assertions
- ActiveSupport::Testing::ErrorReporterAssertions
- ActiveSupport::Testing::EventReporterAssertions
- ActiveSupport::Testing::NotificationAssertions
- ActiveSupport::Testing::Deprecation
- ActiveSupport::Testing::ConstantStubbing
- ActiveSupport::Testing::TimeHelpers
- ActiveSupport::Testing::FileFixtures
Constants
Assertion | = | Minitest::Assertion |
Class Public methods
fixture_paths Link
Returns the ActiveRecord::FixtureSet
collection.
In your test_helper.rb
you must have require "rails/test_help"
.
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 170
fixture_paths=(fixture_paths) Link
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"
.
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 176
parallel_worker_id() Link
Returns the current parallel worker ID if tests are running in parallel, nil otherwise.
ActiveSupport::TestCase.parallel_worker_id # => 2
parallelize(workers: :number_of_processors, with: :processes, threshold: ActiveSupport.test_parallelization_threshold, parallelize_databases: ActiveSupport.parallelize_test_databases) Link
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
.
If you want to skip Rails
default creation of one database per process in favor of writing your own implementation, you can set parallelize_databases
, or configure it via config.active_support.parallelize_test_databases
.
parallelize(workers: :number_of_processors, parallelize_databases: false)
Note that your test suite may deadlock if you attempt to use only one database with multiple processes.
# File activesupport/lib/active_support/test_case.rb, line 107 def parallelize(workers: :number_of_processors, with: :processes, threshold: ActiveSupport.test_parallelization_threshold, parallelize_databases: ActiveSupport.parallelize_test_databases) case when ENV["PARALLEL_WORKERS"] workers = ENV["PARALLEL_WORKERS"].to_i when workers == :number_of_processors workers = (Concurrent.available_processor_count || Concurrent.processor_count).floor end if with == :processes ActiveSupport.parallelize_test_databases = parallelize_databases end Minitest.parallel_executor = ActiveSupport::Testing::ParallelizeExecutor.new(size: workers, with: with, threshold: threshold) end
parallelize_before_fork(&block) Link
Before fork hook for parallel testing. This can be used to run anything before the processes are forked.
In your test_helper.rb
add the following:
class ActiveSupport::TestCase
parallelize_before_fork do
# run this before fork
end
end
parallelize_setup(&block) Link
Setup 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
parallelize_teardown(&block) Link
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
test_order() Link
Returns the order in which test cases are run.
ActiveSupport::TestCase.test_order # => :random
Possible values are :random
, :parallel
, :alpha
, :sorted
. Defaults to :random
.
test_order=(new_order) Link
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
)
Instance Public methods
assert_no_match(matcher, obj, msg = nil) Link
Alias for: refute_match
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 288
assert_not_empty(obj, msg = nil) Link
Alias for: refute_empty
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 211
assert_not_equal(exp, act, msg = nil) Link
Alias for: refute_equal
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 222
assert_not_in_delta(exp, act, delta = 0.001, msg = nil) Link
Alias for: refute_in_delta
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 233
assert_not_in_epsilon(a, b, epsilon = 0.001, msg = nil) Link
Alias for: refute_in_epsilon
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 244
assert_not_includes(collection, obj, msg = nil) Link
Alias for: refute_includes
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 255
assert_not_instance_of(cls, obj, msg = nil) Link
Alias for: refute_instance_of
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 266
assert_not_kind_of(cls, obj, msg = nil) Link
Alias for: refute_kind_of
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 277
assert_not_nil(obj, msg = nil) Link
Alias for: refute_nil
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 299
assert_not_operator(o1, op, o2 = UNDEFINED, msg = nil) Link
Alias for: refute_operator
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 310
assert_not_predicate(o1, op, msg = nil) Link
Alias for: refute_predicate
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 321
assert_not_respond_to(obj, meth, msg = nil) Link
Alias for: refute_respond_to
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 332
assert_not_same(exp, act, msg = nil) Link
Alias for: refute_same
Source: on GitHub
# File activesupport/lib/active_support/test_case.rb, line 343