minitest-rails 5.1.0 → 7.1.0

data/lib/minitest/rails/assertions/action_cable.rb

@@ -0,0 +1,232 @@
+class ActionCable::TestCase
+  ##
+  # Asserts that the number of broadcasted messages to the stream matches the given number.
+  #
+  #   def test_broadcasts
+  #     assert_broadcasts 'messages', 0
+  #     ActionCable.server.broadcast 'messages', { text: 'hello' }
+  #     assert_broadcasts 'messages', 1
+  #     ActionCable.server.broadcast 'messages', { text: 'world' }
+  #     assert_broadcasts 'messages', 2
+  #   end
+  #
+  # If a block is passed, that block should cause the specified number of
+  # messages to be broadcasted.
+  #
+  #   def test_broadcasts_again
+  #     assert_broadcasts('messages', 1) do
+  #       ActionCable.server.broadcast 'messages', { text: 'hello' }
+  #     end
+  #
+  #     assert_broadcasts('messages', 2) do
+  #       ActionCable.server.broadcast 'messages', { text: 'hi' }
+  #       ActionCable.server.broadcast 'messages', { text: 'how are you?' }
+  #     end
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::TestHelper#must_have_broadcasts
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_broadcasts
+  #
+  # :method: assert_broadcasts
+  # :call-seq: assert_broadcasts(stream, number)
+
+  ##
+  # Asserts that no messages have been sent to the stream.
+  #
+  #   def test_no_broadcasts
+  #     refute_broadcasts 'messages'
+  #     ActionCable.server.broadcast 'messages', { text: 'hi' }
+  #     assert_broadcasts 'messages', 1
+  #   end
+  #
+  # If a block is passed, that block should not cause any message to be sent.
+  #
+  #   def test_broadcasts_again
+  #     refute_broadcasts 'messages' do
+  #       # No job messages should be sent from this block
+  #     end
+  #   end
+  #
+  # Note: This assertion is simply a shortcut for:
+  #
+  #   assert_broadcasts 'messages', 0, &block
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::TestHelper#wont_have_broadcasts
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_no_broadcasts
+  #
+  # :method: refute_broadcasts
+  # :call-seq: refute_broadcasts(stream, &block)
+  alias refute_broadcasts assert_no_broadcasts
+
+  ##
+  # Asserts that the specified message has been sent to the stream.
+  #
+  #   def test_assert_transmitted_message
+  #     ActionCable.server.broadcast 'messages', text: 'hello'
+  #     assert_broadcast_on('messages', text: 'hello')
+  #   end
+  #
+  # If a block is passed, that block should cause a message with the specified data to be sent.
+  #
+  #   def test_assert_broadcast_on_again
+  #     assert_broadcast_on('messages', text: 'hello') do
+  #       ActionCable.server.broadcast 'messages', text: 'hello'
+  #     end
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::TestHelper#must_broadcast_on
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_broadcast_on
+  #
+  # :method: assert_broadcast_on
+  # :call-seq: assert_broadcast_on(stream, data)
+end
+
+class ActionCable::Channel::TestCase
+  ##
+  # Asserts that the number of broadcasted messages to the stream matches the given number.
+  #
+  #   def test_broadcasts
+  #     assert_broadcasts 'messages', 0
+  #     ActionCable.server.broadcast 'messages', { text: 'hello' }
+  #     assert_broadcasts 'messages', 1
+  #     ActionCable.server.broadcast 'messages', { text: 'world' }
+  #     assert_broadcasts 'messages', 2
+  #   end
+  #
+  # If a block is passed, that block should cause the specified number of
+  # messages to be broadcasted.
+  #
+  #   def test_broadcasts_again
+  #     assert_broadcasts('messages', 1) do
+  #       ActionCable.server.broadcast 'messages', { text: 'hello' }
+  #     end
+  #
+  #     assert_broadcasts('messages', 2) do
+  #       ActionCable.server.broadcast 'messages', { text: 'hi' }
+  #       ActionCable.server.broadcast 'messages', { text: 'how are you?' }
+  #     end
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::TestHelper#must_have_broadcasts
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_broadcasts
+  #
+  # :method: assert_broadcasts
+  # :call-seq: assert_broadcasts(stream, number)
+
+  ##
+  # Asserts that no messages have been sent to the stream.
+  #
+  #   def test_no_broadcasts
+  #     refute_broadcasts 'messages'
+  #     ActionCable.server.broadcast 'messages', { text: 'hi' }
+  #     assert_broadcasts 'messages', 1
+  #   end
+  #
+  # If a block is passed, that block should not cause any message to be sent.
+  #
+  #   def test_broadcasts_again
+  #     refute_broadcasts 'messages' do
+  #       # No job messages should be sent from this block
+  #     end
+  #   end
+  #
+  # Note: This assertion is simply a shortcut for:
+  #
+  #   assert_broadcasts 'messages', 0, &block
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::TestHelper#wont_have_broadcasts
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_no_broadcasts
+  #
+  # :method: refute_broadcasts
+  # :call-seq: refute_broadcasts(stream, &block)
+  alias refute_broadcasts assert_no_broadcasts
+
+  ##
+  # Asserts that the specified message has been sent to the stream.
+  #
+  #   def test_assert_transmitted_message
+  #     ActionCable.server.broadcast 'messages', text: 'hello'
+  #     assert_broadcast_on('messages', text: 'hello')
+  #   end
+  #
+  # If a block is passed, that block should cause a message with the specified data to be sent.
+  #
+  #   def test_assert_broadcast_on_again
+  #     assert_broadcast_on('messages', text: 'hello') do
+  #       ActionCable.server.broadcast 'messages', text: 'hello'
+  #     end
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::TestHelper#must_broadcast_on
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_broadcast_on
+  #
+  # :method: assert_broadcast_on
+  # :call-seq: assert_broadcast_on(stream, data)
+
+  ##
+  # Asserts that no streams have been started.
+  #
+  #   def test_assert_no_started_stream
+  #     subscribe
+  #     assert_no_streams
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::Channel#wont_have_streams
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Channel/TestCase/Behavior.html#method-i-assert_no_streams
+  #
+  # :method: refute_streams
+  alias refute_streams assert_no_streams
+
+  ##
+  # Asserts that the specified stream has been started.
+  #
+  #   def test_assert_started_stream
+  #     subscribe
+  #     assert_has_stream 'messages'
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::Channel#must_have_streams
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Channel/TestCase/Behavior.html#method-i-assert_has_stream
+  #
+  # :method: assert_has_stream
+  # :call-seq: assert_has_stream(stream)
+
+  ##
+  # Asserts that the specified stream for a model has started.
+  #
+  #   def test_assert_started_stream_for
+  #     subscribe id: 42
+  #     assert_has_stream_for User.find(42)
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable::Channel#must_have_stream_for
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Channel/TestCase/Behavior.html#method-i-assert_has_stream_for
+  #
+  # :method: assert_has_stream_for
+  # :call-seq: assert_has_stream_for(object)
+end
+
+class ActionCable::Connection::TestCase
+  # Asserts that the connection is rejected (via +reject_unauthorized_connection+).
+  #
+  #   class ApplicationCable::ConnectionTest < ActionCable::Connection::TestCase
+  #     def test_connects_with_proper_cookie
+  #       # Simulate the connection request with a cookie.
+  #       cookies["user_id"] = users(:john).id
+  #
+  #       connect
+  #
+  #       # Assert the connection identifier matches the fixture.
+  #       assert_equal users(:john).id, connection.user.id
+  #     end
+  #
+  #     def test_rejects_connection_without_proper_cookie
+  #       assert_reject_connection { connect }
+  #     end
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionCable#must_reject_connection
+  # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Connection/Assertions.html#method-i-assert_reject_connection
+  #
+  # :method: assert_reject_connection
+end

data/lib/minitest/rails/assertions/action_mailer.rb

@@ -25,7 +25,7 @@ class ActionMailer::TestCase
   #   end
   #
   # See also Minitest::Rails::Expectations::ActionMailer#must_have_emails
-  # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_emails
+  # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_emails
   #
   # :method: assert_emails
   # :call-seq: assert_emails(number, &block)
@@ -51,7 +51,7 @@ class ActionMailer::TestCase
   #   assert_emails 0, &block
   #
   # See also Minitest::Rails::Expectations::ActionMailer#wont_have_emails
-  # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_emails
+  # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_emails
   #
   # :method: refute_emails
   # :call-seq: refute_emails(&block)
@@ -84,11 +84,49 @@ class ActionMailer::TestCase
   #   end
   #
   # See also Minitest::Rails::Expectations::ActionMailer#must_have_enqueued_emails
-  # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_enqueued_emails
+  # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_enqueued_emails
   #
   # :method: assert_enqueued_emails
   # :call-seq: assert_enqueued_emails(number, &block)
 
+  ##
+  # Asserts that a specific email has been enqueued, optionally
+  # matching arguments.
+  #
+  #   def test_email
+  #     ContactMailer.welcome.deliver_later
+  #     assert_enqueued_email_with ContactMailer, :welcome
+  #   end
+  #
+  #   def test_email_with_arguments
+  #     ContactMailer.welcome("Hello", "Goodbye").deliver_later
+  #     assert_enqueued_email_with ContactMailer, :welcome, args: ["Hello", "Goodbye"]
+  #   end
+  #
+  # If a block is passed, that block should cause the specified email
+  # to be enqueued.
+  #
+  #   def test_email_in_block
+  #     assert_enqueued_email_with ContactMailer, :welcome do
+  #       ContactMailer.welcome.deliver_later
+  #     end
+  #   end
+  #
+  # If +args+ is provided as a Hash, a parameterized email is matched.
+  #
+  #   def test_parameterized_email
+  #     assert_enqueued_email_with ContactMailer, :welcome,
+  #       args: {email: 'user@example.com'} do
+  #       ContactMailer.with(email: 'user@example.com').welcome.deliver_later
+  #     end
+  #   end
+  #
+  # See also Minitest::Rails::Expectations::ActionMailer#must_enqueue_email_with
+  # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_enqueued_email_with
+  #
+  # :method: assert_enqueued_email_with
+  # :call-seq: assert_enqueued_email_with(mailer, method, args: nil, queue: "mailers", &block)
+
   ##
   # Asserts that no emails are enqueued for later delivery.
   #
@@ -107,7 +145,7 @@ class ActionMailer::TestCase
   #   end
   #
   # See also Minitest::Rails::Expectations::ActionMailer#wont_have_enqueued_emails
-  # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_enqueued_emails
+  # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_enqueued_emails
   #
   # :method: refute_enqueued_emails
   # :call-seq: refute_enqueued_emails(&block)

data/lib/minitest/rails/assertions/active_job.rb

@@ -149,3 +149,8 @@ class ActiveJob::TestCase
   # :method: assert_performed_with
   # :call-seq: assert_performed_with(args)
 end
+
+module ActiveJob::TestHelper # :nodoc:
+  alias refute_enqueued_jobs assert_no_enqueued_jobs # :nodoc:
+  alias refute_performed_jobs assert_no_performed_jobs # :nodoc:
+end

data/lib/minitest/rails/assertions/active_support.rb

@@ -8,7 +8,7 @@ class ActiveSupport::TestCase
   #   end
   #
   # See also Minitest::Rails::Expectations::ActiveSupport#must_change
-  # See https://api.rubyonrails.org/v5.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_changes
+  # See https://api.rubyonrails.org/v7.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_changes
   #
   # :method: assert_changes
   # :call-seq: assert_changes(expression, message = nil, from: UNTRACKED, to: UNTRACKED, &block)
@@ -22,7 +22,7 @@ class ActiveSupport::TestCase
   #   end
   #
   # See also Minitest::Rails::Expectations::ActiveSupport#wont_change
-  # See https://api.rubyonrails.org/v5.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_no_changes
+  # See https://api.rubyonrails.org/v7.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_no_changes
   #
   # :args: expression, message = nil, &block
   alias refute_changes assert_no_changes
@@ -36,7 +36,7 @@ class ActiveSupport::TestCase
   #     end
   #
   # See also Minitest::Rails::Expectations::ActiveSupport#must_change
-  # See https://api.rubyonrails.org/v5.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_difference
+  # See https://api.rubyonrails.org/v7.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_difference
   #
   # :method: assert_difference
   # :call-seq: assert_difference(expression, *args, &block)
@@ -50,7 +50,7 @@ class ActiveSupport::TestCase
   #   end
   #
   # See also Minitest::Rails::Expectations::ActiveSupport#wont_change
-  # See https://api.rubyonrails.org/v5.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_no_difference
+  # See https://api.rubyonrails.org/v7.1/classes/ActiveSupport/Testing/Assertions.html#method-i-assert_no_difference
   #
   # :args: expression, message = nil, &block
   alias refute_difference assert_no_difference

data/lib/minitest/rails/assertions.rb

@@ -2,4 +2,5 @@ require "minitest/rails/assertions/active_support"
 require "minitest/rails/assertions/action_view"
 require "minitest/rails/assertions/action_dispatch"
 require "minitest/rails/assertions/active_job" if defined? ActiveJob
+require "minitest/rails/assertions/action_cable" if defined? ActionCable
 require "minitest/rails/assertions/action_mailer" if defined? ActionMailer

data/lib/minitest/rails/capybara.rb

@@ -1,3 +1,4 @@
+require "minitest/rails"
 require "capybara/minitest"
 require "capybara/minitest/spec"
 

data/lib/minitest/rails/expectations/action_cable.rb

@@ -0,0 +1,197 @@
+require "active_support/concern"
+
+module Minitest
+  module Rails
+    module Expectations
+      module ActionCable
+        module TestHelper
+          ##
+          # Asserts that the number of broadcasted messages to the stream matches the given number.
+          #
+          #   def test_broadcasts
+          #     must_have_broadcasts 'messages', 0
+          #     ActionCable.server.broadcast 'messages', { text: 'hello' }
+          #     must_have_broadcasts 'messages', 1
+          #     ActionCable.server.broadcast 'messages', { text: 'world' }
+          #     must_have_broadcasts 'messages', 2
+          #   end
+          #
+          # If a block is passed, that block should cause the specified number of
+          # messages to be broadcasted.
+          #
+          #   def test_broadcasts_again
+          #     must_have_broadcasts('messages', 1) do
+          #       ActionCable.server.broadcast 'messages', { text: 'hello' }
+          #     end
+          #
+          #     must_have_broadcasts('messages', 2) do
+          #       ActionCable.server.broadcast 'messages', { text: 'hi' }
+          #       ActionCable.server.broadcast 'messages', { text: 'how are you?' }
+          #     end
+          #   end
+          #
+          # See also ActionCable::TestHelper#assert_broadcasts
+          # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_broadcasts
+          #
+          # :method: must_have_broadcasts
+          # :call-seq: must_have_broadcasts(stream, number)
+
+          ##
+          # Asserts that no messages have been sent to the stream.
+          #
+          #   def test_no_broadcasts
+          #     wont_have_broadcasts 'messages'
+          #     ActionCable.server.broadcast 'messages', { text: 'hi' }
+          #     must_have_broadcasts 'messages', 1
+          #   end
+          #
+          # If a block is passed, that block should not cause any message to be sent.
+          #
+          #   def test_broadcasts_again
+          #     wont_have_broadcasts 'messages' do
+          #       # No job messages should be sent from this block
+          #     end
+          #   end
+          #
+          # Note: This assertion is simply a shortcut for:
+          #
+          #   must_have_broadcasts 'messages', 0, &block
+          #
+          # See also ActionCable::TestHelper#wont_have_broadcasts
+          # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_no_broadcasts
+          #
+          # :method: wont_have_broadcasts
+          # :call-seq: wont_have_broadcasts(stream, &block)
+
+          ##
+          # Asserts that the specified message has been sent to the stream.
+          #
+          #   def test_assert_transmitted_message
+          #     ActionCable.server.broadcast 'messages', text: 'hello'
+          #     must_broadcast_on('messages', text: 'hello')
+          #   end
+          #
+          # If a block is passed, that block should cause a message with the specified data to be sent.
+          #
+          #   def test_assert_broadcast_on_again
+          #     must_broadcast_on('messages', text: 'hello') do
+          #       ActionCable.server.broadcast 'messages', text: 'hello'
+          #     end
+          #   end
+          #
+          # See also ActionCable::TestHelper#assert_broadcast_on
+          # See https://api.rubyonrails.org/v7.1/classes/ActionCable/TestHelper.html#method-i-assert_broadcast_on
+          #
+          # :method: must_broadcast_on
+          # :call-seq: must_broadcast_on(stream, data)
+
+          extend ::ActiveSupport::Concern
+
+          included do
+            alias_method :must_have_broadcasts, :assert_broadcasts
+            alias_method :wont_have_broadcasts, :assert_no_broadcasts
+            alias_method :must_broadcast_on, :assert_broadcast_on
+          end
+        end
+
+        module Channel
+          ##
+          # Asserts that no streams have been started.
+          #
+          #   def test_assert_no_started_stream
+          #     subscribe
+          #     wont_have_streams
+          #   end
+          #
+          # See also ActionCable::Channel::TestCase#assert_no_streams
+          # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Channel/TestCase/Behavior.html#method-i-assert_no_streams
+          #
+          # :method: wont_have_streams
+
+          ##
+          # Asserts that the specified stream has been started.
+          #
+          #   def test_assert_started_stream
+          #     subscribe
+          #     must_have_streams 'messages'
+          #   end
+          #
+          # See also ActionCable::Channel::TestCase#assert_has_stream
+          # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Channel/TestCase/Behavior.html#method-i-assert_has_stream
+          #
+          # :method: must_have_streams
+          # :call-seq: must_have_streams(stream)
+
+          ##
+          # Asserts that the specified stream for a model has started.
+          #
+          #   def test_assert_started_stream_for
+          #     subscribe id: 42
+          #     must_have_stream_for User.find(42)
+          #   end
+          #
+          # See also ActionCable::Channel::TestCase#assert_has_stream_for
+          # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Channel/TestCase/Behavior.html#method-i-assert_has_stream_for
+          #
+          # :method: must_have_stream_for
+          # :call-seq: must_have_stream_for(object)
+
+          extend ::ActiveSupport::Concern
+
+          included do
+            alias_method :wont_have_streams, :assert_no_streams
+            alias_method :must_have_streams, :assert_has_stream
+            alias_method :must_have_stream_for, :assert_has_stream_for
+          end
+        end
+
+        module Connection
+          ##
+          # Asserts that the connection is rejected (via +reject_unauthorized_connection+).
+          #
+          #   describe "Application Connections", :connection do
+          #     it "connects with proper cookie" do
+          #       # Simulate the connection request with a cookie.
+          #       cookies["user_id"] = users(:john).id
+          #
+          #       connect
+          #
+          #       # Assert the connection identifier matches the fixture.
+          #       value(connection.user.id).must_equal users(:john).id
+          #     end
+          #
+          #     it "rejects connection without proper cookie" do
+          #       must_reject_connection { connect }
+          #     end
+          #   end
+          #
+          # See also ActionCable::Connection::TestCase#assert_reject_connection
+          # See https://api.rubyonrails.org/v7.1/classes/ActionCable/Connection/Assertions.html#method-i-assert_reject_connection
+          #
+          # :method: must_reject_connection
+
+          extend ::ActiveSupport::Concern
+
+          included do
+            alias_method :must_reject_connection, :assert_reject_connection
+          end
+        end
+      end
+    end
+  end
+end
+
+unless ENV["MT_NO_EXPECTATIONS"]
+  class ActionCable::TestCase # :nodoc:
+    include Minitest::Rails::Expectations::ActionCable::TestHelper
+  end
+
+  class ActionCable::Channel::TestCase # :nodoc:
+    include Minitest::Rails::Expectations::ActionCable::TestHelper
+    include Minitest::Rails::Expectations::ActionCable::Channel
+  end
+
+  class ActionCable::Connection::TestCase # :nodoc:
+    include Minitest::Rails::Expectations::ActionCable::Connection
+  end
+end

data/lib/minitest/rails/expectations/action_mailer.rb

@@ -30,7 +30,7 @@ module Minitest
         #   end
         #
         # See also ActionMailer::TestClass#assert_emails
-        # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_emails
+        # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_emails
         #
         # :method: must_have_emails
         # :call-seq: must_have_emails(number, &block)
@@ -56,7 +56,7 @@ module Minitest
         #   must_have_emails 0, &block
         #
         # See also ActionMailer::TestClass#wont_have_emails
-        # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_emails
+        # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_emails
         #
         # :method: wont_have_emails
         # :call-seq: wont_have_emails(&block)
@@ -88,11 +88,49 @@ module Minitest
         #   end
         #
         # See also ActionMailer::TestClass#assert_enqueued_emails
-        # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_enqueued_emails
+        # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_enqueued_emails
         #
         # :method: must_have_enqueued_emails
         # :call-seq: must_have_enqueued_emails(number, &block)
 
+        ##
+        # Asserts that a specific email has been enqueued, optionally
+        # matching arguments.
+        #
+        #   def test_email
+        #     ContactMailer.welcome.deliver_later
+        #     must_enqueue_email_with ContactMailer, :welcome
+        #   end
+        #
+        #   def test_email_with_arguments
+        #     ContactMailer.welcome("Hello", "Goodbye").deliver_later
+        #     must_enqueue_email_with ContactMailer, :welcome, args: ["Hello", "Goodbye"]
+        #   end
+        #
+        # If a block is passed, that block should cause the specified email
+        # to be enqueued.
+        #
+        #   def test_email_in_block
+        #     must_enqueue_email_with ContactMailer, :welcome do
+        #       ContactMailer.welcome.deliver_later
+        #     end
+        #   end
+        #
+        # If +args+ is provided as a Hash, a parameterized email is matched.
+        #
+        #   def test_parameterized_email
+        #     must_enqueue_email_with ContactMailer, :welcome,
+        #       args: {email: 'user@example.com'} do
+        #       ContactMailer.with(email: 'user@example.com').welcome.deliver_later
+        #     end
+        #   end
+        #
+        # See also ActionMailer::TestClass#assert_enqueued_email_with
+        # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_enqueued_email_with
+        #
+        # :method: must_enqueue_email_with
+        # :call-seq: must_enqueue_email_with(mailer, method, args: nil, queue: "mailers", &block)
+
         ##
         # Asserts that no emails are enqueued for later delivery.
         #
@@ -111,7 +149,7 @@ module Minitest
         #   end
         #
         # See also ActionMailer::TestClass#assert_no_enqueued_emails
-        # See https://api.rubyonrails.org/v5.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_enqueued_emails
+        # See https://api.rubyonrails.org/v7.1/classes/ActionMailer/TestHelper.html#method-i-assert_no_enqueued_emails
         #
         # :method: wont_have_enqueued_emails
         # :call-seq: wont_have_enqueued_emails(&block)
@@ -122,6 +160,7 @@ module Minitest
           alias_method :must_have_emails, :assert_emails
           alias_method :wont_have_emails, :assert_no_emails
           alias_method :must_have_enqueued_emails, :assert_enqueued_emails
+          alias_method :must_enqueue_email_with, :assert_enqueued_email_with
           alias_method :wont_have_enqueued_emails, :assert_no_enqueued_emails
         end
       end

data/lib/minitest/rails/expectations/active_job.rb

@@ -176,6 +176,10 @@ module Minitest
 end
 
 unless ENV["MT_NO_EXPECTATIONS"]
+  class ActionDispatch::IntegrationTest # :nodoc:
+    include Minitest::Rails::Expectations::ActiveJob
+  end
+
   class ActiveJob::TestCase # :nodoc:
     include Minitest::Rails::Expectations::ActiveJob
   end