rspec-rails 2.14.2 → 4.1.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- checksums.yaml.gz.sig +0 -0
- data/.document +1 -1
- data/.yardopts +4 -2
- data/Capybara.md +6 -57
- data/Changelog.md +715 -37
- data/{License.txt → LICENSE.md} +5 -2
- data/README.md +287 -362
- data/lib/generators/rspec/channel/channel_generator.rb +12 -0
- data/lib/generators/rspec/channel/templates/channel_spec.rb.erb +7 -0
- data/lib/generators/rspec/controller/controller_generator.rb +23 -5
- data/lib/generators/rspec/controller/templates/controller_spec.rb +5 -5
- data/lib/generators/rspec/controller/templates/request_spec.rb +19 -0
- data/lib/generators/rspec/controller/templates/routing_spec.rb +13 -0
- data/lib/generators/rspec/controller/templates/view_spec.rb +2 -2
- data/lib/generators/rspec/feature/feature_generator.rb +29 -0
- data/lib/generators/rspec/feature/templates/feature_singular_spec.rb +5 -0
- data/lib/generators/rspec/feature/templates/feature_spec.rb +5 -0
- data/lib/generators/rspec/generator/generator_generator.rb +24 -0
- data/lib/generators/rspec/generator/templates/generator_spec.rb +6 -0
- data/lib/generators/rspec/helper/helper_generator.rb +2 -1
- data/lib/generators/rspec/helper/templates/helper_spec.rb +2 -2
- data/lib/generators/rspec/install/install_generator.rb +44 -5
- data/lib/generators/rspec/install/templates/spec/rails_helper.rb +79 -0
- data/lib/generators/rspec/integration/integration_generator.rb +8 -13
- data/lib/generators/rspec/integration/templates/request_spec.rb +4 -9
- data/lib/generators/rspec/job/job_generator.rb +12 -0
- data/lib/generators/rspec/{observer/templates/observer_spec.rb → job/templates/job_spec.rb.erb} +2 -2
- data/lib/generators/rspec/mailbox/mailbox_generator.rb +14 -0
- data/lib/generators/rspec/mailbox/templates/mailbox_spec.rb.erb +7 -0
- data/lib/generators/rspec/mailer/mailer_generator.rb +9 -1
- data/lib/generators/rspec/mailer/templates/mailer_spec.rb +7 -7
- data/lib/generators/rspec/mailer/templates/preview.rb +13 -0
- data/lib/generators/rspec/model/model_generator.rb +21 -6
- data/lib/generators/rspec/model/templates/fixtures.yml +1 -1
- data/lib/generators/rspec/model/templates/model_spec.rb +2 -2
- data/lib/generators/rspec/request/request_generator.rb +10 -0
- data/lib/generators/rspec/scaffold/scaffold_generator.rb +88 -148
- data/lib/generators/rspec/scaffold/templates/api_controller_spec.rb +129 -0
- data/lib/generators/rspec/scaffold/templates/api_request_spec.rb +131 -0
- data/lib/generators/rspec/scaffold/templates/controller_spec.rb +105 -80
- data/lib/generators/rspec/scaffold/templates/edit_spec.rb +10 -14
- data/lib/generators/rspec/scaffold/templates/index_spec.rb +5 -12
- data/lib/generators/rspec/scaffold/templates/new_spec.rb +11 -15
- data/lib/generators/rspec/scaffold/templates/request_spec.rb +137 -0
- data/lib/generators/rspec/scaffold/templates/routing_spec.rb +19 -12
- data/lib/generators/rspec/scaffold/templates/show_spec.rb +5 -12
- data/lib/generators/rspec/system/system_generator.rb +26 -0
- data/lib/generators/rspec/system/templates/system_spec.rb +9 -0
- data/lib/generators/rspec/view/templates/view_spec.rb +2 -2
- data/lib/generators/rspec/view/view_generator.rb +3 -2
- data/lib/generators/rspec.rb +18 -10
- data/lib/rspec/rails/active_record.rb +25 -0
- data/lib/rspec/rails/adapters.rb +49 -47
- data/lib/rspec/rails/configuration.rb +194 -0
- data/lib/rspec/rails/example/channel_example_group.rb +93 -0
- data/lib/rspec/rails/example/controller_example_group.rb +188 -138
- data/lib/rspec/rails/example/feature_example_group.rb +43 -20
- data/lib/rspec/rails/example/helper_example_group.rb +28 -26
- data/lib/rspec/rails/example/job_example_group.rb +23 -0
- data/lib/rspec/rails/example/mailbox_example_group.rb +80 -0
- data/lib/rspec/rails/example/mailer_example_group.rb +30 -14
- data/lib/rspec/rails/example/model_example_group.rb +8 -7
- data/lib/rspec/rails/example/rails_example_group.rb +4 -2
- data/lib/rspec/rails/example/request_example_group.rb +23 -16
- data/lib/rspec/rails/example/routing_example_group.rb +49 -40
- data/lib/rspec/rails/example/system_example_group.rb +125 -0
- data/lib/rspec/rails/example/view_example_group.rb +178 -134
- data/lib/rspec/rails/example.rb +4 -33
- data/lib/rspec/rails/extensions/active_record/proxy.rb +5 -11
- data/lib/rspec/rails/extensions.rb +0 -1
- data/lib/rspec/rails/feature_check.rb +47 -0
- data/lib/rspec/rails/file_fixture_support.rb +17 -0
- data/lib/rspec/rails/fixture_file_upload_support.rb +35 -0
- data/lib/rspec/rails/fixture_support.rb +54 -23
- data/lib/rspec/rails/matchers/action_cable/have_broadcasted_to.rb +170 -0
- data/lib/rspec/rails/matchers/action_cable/have_streams.rb +58 -0
- data/lib/rspec/rails/matchers/action_cable.rb +65 -0
- data/lib/rspec/rails/matchers/action_mailbox.rb +64 -0
- data/lib/rspec/rails/matchers/active_job.rb +465 -0
- data/lib/rspec/rails/matchers/base_matcher.rb +179 -0
- data/lib/rspec/rails/matchers/be_a_new.rb +69 -62
- data/lib/rspec/rails/matchers/be_new_record.rb +24 -21
- data/lib/rspec/rails/matchers/be_valid.rb +42 -33
- data/lib/rspec/rails/matchers/have_enqueued_mail.rb +198 -0
- data/lib/rspec/rails/matchers/have_http_status.rb +385 -0
- data/lib/rspec/rails/matchers/have_rendered.rb +55 -31
- data/lib/rspec/rails/matchers/redirect_to.rb +30 -29
- data/lib/rspec/rails/matchers/relation_match_array.rb +2 -2
- data/lib/rspec/rails/matchers/routing_matchers.rb +107 -93
- data/lib/rspec/rails/matchers.rb +22 -14
- data/lib/rspec/rails/tasks/rspec.rake +8 -18
- data/lib/rspec/rails/vendor/capybara.rb +12 -11
- data/lib/rspec/rails/version.rb +3 -1
- data/lib/rspec/rails/view_assigns.rb +18 -18
- data/lib/rspec/rails/view_path_builder.rb +29 -0
- data/lib/rspec/rails/view_rendering.rb +100 -63
- data/lib/rspec/rails/view_spec_methods.rb +56 -0
- data/lib/rspec/rails.rb +10 -10
- data/lib/rspec-rails.rb +67 -3
- data.tar.gz.sig +0 -0
- metadata +121 -94
- metadata.gz.sig +0 -0
- data/lib/autotest/rails_rspec2.rb +0 -85
- data/lib/generators/rspec/install/templates/.rspec +0 -1
- data/lib/generators/rspec/install/templates/spec/spec_helper.rb.tt +0 -49
- data/lib/generators/rspec/observer/observer_generator.rb +0 -12
- data/lib/rspec/rails/extensions/active_record/base.rb +0 -58
- data/lib/rspec/rails/matchers/have_extension.rb +0 -36
- data/lib/rspec/rails/mocks.rb +0 -274
- data/lib/rspec/rails/module_inclusion.rb +0 -19
- data/lib/rspec/rails/vendor/webrat.rb +0 -33
@@ -1,76 +1,83 @@
|
|
1
|
-
module RSpec
|
2
|
-
|
1
|
+
module RSpec
|
2
|
+
module Rails
|
3
|
+
module Matchers
|
4
|
+
# @api private
|
5
|
+
#
|
6
|
+
# Matcher class for `be_a_new`. Should not be instantiated directly.
|
7
|
+
#
|
8
|
+
# @see RSpec::Rails::Matchers#be_a_new
|
9
|
+
class BeANew < RSpec::Rails::Matchers::BaseMatcher
|
10
|
+
# @private
|
11
|
+
def initialize(expected)
|
12
|
+
@expected = expected
|
13
|
+
end
|
3
14
|
|
4
|
-
|
5
|
-
|
6
|
-
|
15
|
+
# @private
|
16
|
+
def matches?(actual)
|
17
|
+
@actual = actual
|
18
|
+
actual.is_a?(expected) && actual.new_record? && attributes_match?(actual)
|
19
|
+
end
|
7
20
|
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
21
|
+
# @api public
|
22
|
+
# @see RSpec::Rails::Matchers#be_a_new
|
23
|
+
def with(expected_attributes)
|
24
|
+
attributes.merge!(expected_attributes)
|
25
|
+
self
|
26
|
+
end
|
13
27
|
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
28
|
+
# @private
|
29
|
+
def failure_message
|
30
|
+
[].tap do |message|
|
31
|
+
unless actual.is_a?(expected) && actual.new_record?
|
32
|
+
message << "expected #{actual.inspect} to be a new #{expected.inspect}"
|
33
|
+
end
|
34
|
+
unless attributes_match?(actual)
|
35
|
+
describe_unmatched_attributes = surface_descriptions_in(unmatched_attributes)
|
36
|
+
if unmatched_attributes.size > 1
|
37
|
+
message << "attributes #{describe_unmatched_attributes.inspect} were not set on #{actual.inspect}"
|
38
|
+
else
|
39
|
+
message << "attribute #{describe_unmatched_attributes.inspect} was not set on #{actual.inspect}"
|
40
|
+
end
|
41
|
+
end
|
42
|
+
end.join(' and ')
|
43
|
+
end
|
26
44
|
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
message << "expected #{actual.inspect} to be a new #{expected.inspect}"
|
45
|
+
private
|
46
|
+
|
47
|
+
def attributes
|
48
|
+
@attributes ||= {}
|
32
49
|
end
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
message << "attribute #{unmatched_attributes.inspect} was not set on #{actual.inspect}"
|
50
|
+
|
51
|
+
def attributes_match?(actual)
|
52
|
+
attributes.stringify_keys.all? do |key, value|
|
53
|
+
values_match?(value, actual.attributes[key])
|
38
54
|
end
|
39
55
|
end
|
40
|
-
end.join(' and ')
|
41
|
-
end
|
42
|
-
|
43
|
-
private
|
44
56
|
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
attributes.stringify_keys.all? do |key, value|
|
51
|
-
actual.attributes[key].eql?(value)
|
57
|
+
def unmatched_attributes
|
58
|
+
attributes.stringify_keys.reject do |key, value|
|
59
|
+
values_match?(value, actual.attributes[key])
|
60
|
+
end
|
61
|
+
end
|
52
62
|
end
|
53
|
-
end
|
54
63
|
|
55
|
-
|
56
|
-
|
57
|
-
|
64
|
+
# @api public
|
65
|
+
# Passes if actual is an instance of `model_class` and returns `true` for
|
66
|
+
# `new_record?`. Typically used to specify instance variables assigned to
|
67
|
+
# views by controller actions
|
68
|
+
#
|
69
|
+
# Use the `with` method to specify the specific attributes to match on the
|
70
|
+
# new record.
|
71
|
+
#
|
72
|
+
# @example
|
73
|
+
# get :new
|
74
|
+
# assigns(:thing).should be_a_new(Thing)
|
75
|
+
#
|
76
|
+
# post :create, :thing => { :name => "Illegal Value" }
|
77
|
+
# assigns(:thing).should be_a_new(Thing).with(:name => nil)
|
78
|
+
def be_a_new(model_class)
|
79
|
+
BeANew.new(model_class)
|
58
80
|
end
|
59
81
|
end
|
60
82
|
end
|
61
|
-
|
62
|
-
# Passes if actual is an instance of `model_class` and returns `false` for
|
63
|
-
# `persisted?`. Typically used to specify instance variables assigned to
|
64
|
-
# views by controller actions
|
65
|
-
#
|
66
|
-
# @example
|
67
|
-
#
|
68
|
-
# get :new
|
69
|
-
# assigns(:thing).should be_a_new(Thing)
|
70
|
-
#
|
71
|
-
# post :create, :thing => { :name => "Illegal Value" }
|
72
|
-
# assigns(:thing).should be_a_new(Thing).with(:name => nil)
|
73
|
-
def be_a_new(model_class)
|
74
|
-
BeANew.new(model_class)
|
75
|
-
end
|
76
83
|
end
|
@@ -1,27 +1,30 @@
|
|
1
|
-
module RSpec
|
2
|
-
|
1
|
+
module RSpec
|
2
|
+
module Rails
|
3
|
+
module Matchers
|
4
|
+
# @private
|
5
|
+
class BeANewRecord < RSpec::Rails::Matchers::BaseMatcher
|
6
|
+
def matches?(actual)
|
7
|
+
actual.new_record?
|
8
|
+
end
|
3
9
|
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
end
|
10
|
+
def failure_message
|
11
|
+
"expected #{actual.inspect} to be a new record, but was persisted"
|
12
|
+
end
|
8
13
|
|
9
|
-
|
10
|
-
|
11
|
-
|
14
|
+
def failure_message_when_negated
|
15
|
+
"expected #{actual.inspect} to be persisted, but was a new record"
|
16
|
+
end
|
17
|
+
end
|
12
18
|
|
13
|
-
|
14
|
-
|
19
|
+
# @api public
|
20
|
+
# Passes if actual returns `true` for `new_record?`.
|
21
|
+
#
|
22
|
+
# @example
|
23
|
+
# get :new
|
24
|
+
# expect(assigns(:thing)).to be_new_record
|
25
|
+
def be_new_record
|
26
|
+
BeANewRecord.new
|
27
|
+
end
|
15
28
|
end
|
16
29
|
end
|
17
|
-
|
18
|
-
# Passes if actual returns `false` for `persisted?`.
|
19
|
-
#
|
20
|
-
# @example
|
21
|
-
#
|
22
|
-
# get :new
|
23
|
-
# assigns(:thing).should be_new_record
|
24
|
-
def be_new_record
|
25
|
-
BeANewRecord.new
|
26
|
-
end
|
27
30
|
end
|
@@ -1,40 +1,49 @@
|
|
1
|
-
module RSpec
|
2
|
-
|
3
|
-
|
4
|
-
@
|
5
|
-
|
1
|
+
module RSpec
|
2
|
+
module Rails
|
3
|
+
module Matchers
|
4
|
+
# @private
|
5
|
+
class BeValid < RSpec::Matchers::BuiltIn::Be
|
6
|
+
def initialize(*args)
|
7
|
+
@args = args
|
8
|
+
end
|
6
9
|
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
end
|
10
|
+
def matches?(actual)
|
11
|
+
@actual = actual
|
12
|
+
actual.valid?(*@args)
|
13
|
+
end
|
12
14
|
|
13
|
-
|
14
|
-
|
15
|
-
message = "expected #{actual.inspect} to be valid"
|
16
|
-
if actual.respond_to?(:errors)
|
17
|
-
message << ", but got errors: #{actual.errors.full_messages.join(', ')}"
|
18
|
-
end
|
15
|
+
def failure_message
|
16
|
+
message = "expected #{actual.inspect} to be valid"
|
19
17
|
|
20
|
-
|
21
|
-
|
18
|
+
if actual.respond_to?(:errors) && actual.method(:errors).arity < 1
|
19
|
+
errors = if actual.errors.respond_to?(:full_messages)
|
20
|
+
actual.errors.full_messages
|
21
|
+
else
|
22
|
+
actual.errors
|
23
|
+
end
|
22
24
|
|
23
|
-
|
24
|
-
|
25
|
-
"expected #{actual.inspect} not to be valid"
|
26
|
-
end
|
27
|
-
end
|
25
|
+
message << ", but got errors: #{errors.map(&:to_s).join(', ')}"
|
26
|
+
end
|
28
27
|
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
28
|
+
message
|
29
|
+
end
|
30
|
+
|
31
|
+
def failure_message_when_negated
|
32
|
+
"expected #{actual.inspect} not to be valid"
|
33
|
+
end
|
34
|
+
end
|
35
|
+
|
36
|
+
# @api public
|
37
|
+
# Passes if the given model instance's `valid?` method is true, meaning
|
38
|
+
# all of the `ActiveModel::Validations` passed and no errors exist. If a
|
39
|
+
# message is not given, a default message is shown listing each error.
|
40
|
+
#
|
41
|
+
# @example
|
42
|
+
# thing = Thing.new
|
43
|
+
# expect(thing).to be_valid
|
44
|
+
def be_valid(*args)
|
45
|
+
BeValid.new(*args)
|
46
|
+
end
|
47
|
+
end
|
39
48
|
end
|
40
49
|
end
|
@@ -0,0 +1,198 @@
|
|
1
|
+
# We require the minimum amount of rspec-mocks possible to avoid
|
2
|
+
# conflicts with other mocking frameworks.
|
3
|
+
# See: https://github.com/rspec/rspec-rails/issues/2252
|
4
|
+
require "rspec/mocks/argument_matchers"
|
5
|
+
require "rspec/rails/matchers/active_job"
|
6
|
+
|
7
|
+
module RSpec
|
8
|
+
module Rails
|
9
|
+
module Matchers
|
10
|
+
# Matcher class for `have_enqueued_mail`. Should not be instantiated directly.
|
11
|
+
#
|
12
|
+
# @private
|
13
|
+
# @see RSpec::Rails::Matchers#have_enqueued_mail
|
14
|
+
class HaveEnqueuedMail < ActiveJob::HaveEnqueuedJob
|
15
|
+
MAILER_JOB_METHOD = 'deliver_now'.freeze
|
16
|
+
|
17
|
+
include RSpec::Mocks::ArgumentMatchers
|
18
|
+
|
19
|
+
def initialize(mailer_class, method_name)
|
20
|
+
super(nil)
|
21
|
+
@mailer_class = mailer_class
|
22
|
+
@method_name = method_name
|
23
|
+
@mail_args = []
|
24
|
+
end
|
25
|
+
|
26
|
+
def description
|
27
|
+
"enqueues #{mailer_class_name}.#{@method_name}"
|
28
|
+
end
|
29
|
+
|
30
|
+
def with(*args, &block)
|
31
|
+
@mail_args = args
|
32
|
+
block.nil? ? super : super(&yield_mail_args(block))
|
33
|
+
end
|
34
|
+
|
35
|
+
def matches?(block)
|
36
|
+
raise ArgumentError, 'have_enqueued_mail and enqueue_mail only work with block arguments' unless block.respond_to?(:call)
|
37
|
+
|
38
|
+
check_active_job_adapter
|
39
|
+
super
|
40
|
+
end
|
41
|
+
|
42
|
+
def failure_message
|
43
|
+
"expected to enqueue #{base_message}".tap do |msg|
|
44
|
+
msg << "\n#{unmatching_mail_jobs_message}" if unmatching_mail_jobs.any?
|
45
|
+
end
|
46
|
+
end
|
47
|
+
|
48
|
+
def failure_message_when_negated
|
49
|
+
"expected not to enqueue #{base_message}"
|
50
|
+
end
|
51
|
+
|
52
|
+
private
|
53
|
+
|
54
|
+
def base_message
|
55
|
+
[mailer_class_name, @method_name].compact.join('.').tap do |msg|
|
56
|
+
msg << " #{expected_count_message}"
|
57
|
+
msg << " with #{@mail_args}," if @mail_args.any?
|
58
|
+
msg << " on queue #{@queue}," if @queue
|
59
|
+
msg << " at #{@at.inspect}," if @at
|
60
|
+
msg << " but enqueued #{@matching_jobs.size}"
|
61
|
+
end
|
62
|
+
end
|
63
|
+
|
64
|
+
def expected_count_message
|
65
|
+
"#{message_expectation_modifier} #{@expected_number} #{@expected_number == 1 ? 'time' : 'times'}"
|
66
|
+
end
|
67
|
+
|
68
|
+
def mailer_class_name
|
69
|
+
@mailer_class ? @mailer_class.name : 'ActionMailer::Base'
|
70
|
+
end
|
71
|
+
|
72
|
+
def job_match?(job)
|
73
|
+
legacy_mail?(job) || parameterized_mail?(job) || unified_mail?(job)
|
74
|
+
end
|
75
|
+
|
76
|
+
def arguments_match?(job)
|
77
|
+
@args =
|
78
|
+
if @mail_args.any?
|
79
|
+
base_mailer_args + @mail_args
|
80
|
+
elsif @mailer_class && @method_name
|
81
|
+
base_mailer_args + [any_args]
|
82
|
+
elsif @mailer_class
|
83
|
+
[mailer_class_name, any_args]
|
84
|
+
else
|
85
|
+
[]
|
86
|
+
end
|
87
|
+
|
88
|
+
super(job)
|
89
|
+
end
|
90
|
+
|
91
|
+
def base_mailer_args
|
92
|
+
[mailer_class_name, @method_name.to_s, MAILER_JOB_METHOD]
|
93
|
+
end
|
94
|
+
|
95
|
+
def yield_mail_args(block)
|
96
|
+
proc { |*job_args| block.call(*(job_args - base_mailer_args)) }
|
97
|
+
end
|
98
|
+
|
99
|
+
def check_active_job_adapter
|
100
|
+
return if ::ActiveJob::QueueAdapters::TestAdapter === ::ActiveJob::Base.queue_adapter
|
101
|
+
|
102
|
+
raise StandardError, "To use HaveEnqueuedMail matcher set `ActiveJob::Base.queue_adapter = :test`"
|
103
|
+
end
|
104
|
+
|
105
|
+
def unmatching_mail_jobs
|
106
|
+
@unmatching_jobs.select do |job|
|
107
|
+
job_match?(job)
|
108
|
+
end
|
109
|
+
end
|
110
|
+
|
111
|
+
def unmatching_mail_jobs_message
|
112
|
+
msg = "Queued deliveries:"
|
113
|
+
|
114
|
+
unmatching_mail_jobs.each do |job|
|
115
|
+
msg << "\n #{mail_job_message(job)}"
|
116
|
+
end
|
117
|
+
|
118
|
+
msg
|
119
|
+
end
|
120
|
+
|
121
|
+
def mail_job_message(job)
|
122
|
+
mailer_method = job[:args][0..1].join('.')
|
123
|
+
|
124
|
+
mailer_args = job[:args][3..-1]
|
125
|
+
msg_parts = []
|
126
|
+
msg_parts << "with #{mailer_args}" if mailer_args.any?
|
127
|
+
msg_parts << "on queue #{job[:queue]}" if job[:queue] && job[:queue] != 'mailers'
|
128
|
+
msg_parts << "at #{Time.at(job[:at])}" if job[:at]
|
129
|
+
|
130
|
+
"#{mailer_method} #{msg_parts.join(', ')}".strip
|
131
|
+
end
|
132
|
+
|
133
|
+
def legacy_mail?(job)
|
134
|
+
job[:job] <= ActionMailer::DeliveryJob
|
135
|
+
end
|
136
|
+
|
137
|
+
def parameterized_mail?(job)
|
138
|
+
RSpec::Rails::FeatureCheck.has_action_mailer_parameterized? && job[:job] <= ActionMailer::Parameterized::DeliveryJob
|
139
|
+
end
|
140
|
+
|
141
|
+
def unified_mail?(job)
|
142
|
+
RSpec::Rails::FeatureCheck.has_action_mailer_unified_delivery? && job[:job] <= ActionMailer::MailDeliveryJob
|
143
|
+
end
|
144
|
+
end
|
145
|
+
# @api public
|
146
|
+
# Passes if an email has been enqueued inside block.
|
147
|
+
# May chain with to specify expected arguments.
|
148
|
+
# May chain at_least, at_most or exactly to specify a number of times.
|
149
|
+
# May chain at to specify a send time.
|
150
|
+
# May chain on_queue to specify a queue.
|
151
|
+
#
|
152
|
+
# @example
|
153
|
+
# expect {
|
154
|
+
# MyMailer.welcome(user).deliver_later
|
155
|
+
# }.to have_enqueued_mail
|
156
|
+
#
|
157
|
+
# expect {
|
158
|
+
# MyMailer.welcome(user).deliver_later
|
159
|
+
# }.to have_enqueued_mail(MyMailer)
|
160
|
+
#
|
161
|
+
# expect {
|
162
|
+
# MyMailer.welcome(user).deliver_later
|
163
|
+
# }.to have_enqueued_mail(MyMailer, :welcome)
|
164
|
+
#
|
165
|
+
# # Using alias
|
166
|
+
# expect {
|
167
|
+
# MyMailer.welcome(user).deliver_later
|
168
|
+
# }.to enqueue_mail(MyMailer, :welcome)
|
169
|
+
#
|
170
|
+
# expect {
|
171
|
+
# MyMailer.welcome(user).deliver_later
|
172
|
+
# }.to have_enqueued_mail(MyMailer, :welcome).with(user)
|
173
|
+
#
|
174
|
+
# expect {
|
175
|
+
# MyMailer.welcome(user).deliver_later
|
176
|
+
# MyMailer.welcome(user).deliver_later
|
177
|
+
# }.to have_enqueued_mail(MyMailer, :welcome).at_least(:once)
|
178
|
+
#
|
179
|
+
# expect {
|
180
|
+
# MyMailer.welcome(user).deliver_later
|
181
|
+
# }.to have_enqueued_mail(MyMailer, :welcome).at_most(:twice)
|
182
|
+
#
|
183
|
+
# expect {
|
184
|
+
# MyMailer.welcome(user).deliver_later(wait_until: Date.tomorrow.noon)
|
185
|
+
# }.to have_enqueued_mail(MyMailer, :welcome).at(Date.tomorrow.noon)
|
186
|
+
#
|
187
|
+
# expect {
|
188
|
+
# MyMailer.welcome(user).deliver_later(queue: :urgent_mail)
|
189
|
+
# }.to have_enqueued_mail(MyMailer, :welcome).on_queue(:urgent_mail)
|
190
|
+
def have_enqueued_mail(mailer_class = nil, mail_method_name = nil)
|
191
|
+
HaveEnqueuedMail.new(mailer_class, mail_method_name)
|
192
|
+
end
|
193
|
+
alias_method :have_enqueued_email, :have_enqueued_mail
|
194
|
+
alias_method :enqueue_mail, :have_enqueued_mail
|
195
|
+
alias_method :enqueue_email, :have_enqueued_mail
|
196
|
+
end
|
197
|
+
end
|
198
|
+
end
|