Assertions for counting outgoing mailables (#47655)

* Assertions for counting outgoing mailables

* Update MailFake.php

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: jasonmccreary

src/Illuminate/Support/Testing/Fakes/MailFake.php

@@ -224,6 +224,56 @@ public function assertNothingQueued()
         PHPUnit::assertEmpty($this->queuedMailables, 'The following mailables were queued unexpectedly: '.$mailableNames);
     }
 
+    /**
+     * Assert the total number of mailables that were sent.
+     *
+     * @param  int  $count
+     * @return void
+     */
+    public function assertSentCount($count)
+    {
+        $total = collect($this->mailables)->count();
+
+        PHPUnit::assertSame(
+            $count, $total,
+            "The total number of mailables sent was {$total} instead of {$count}."
+        );
+    }
+
+    /**
+     * Assert the total number of mailables that were queued.
+     *
+     * @param  int  $count
+     * @return void
+     */
+    public function assertQueuedCount($count)
+    {
+        $total = collect($this->queuedMailables)->count();
+
+        PHPUnit::assertSame(
+            $count, $total,
+            "The total number of mailables queued was {$total} instead of {$count}."
+        );
+    }
+
+    /**
+     * Assert the total number of mailables that were sent or queued.
+     *
+     * @param  int  $count
+     * @return void
+     */
+    public function assertOutgoingCount($count)
+    {
+        $total = collect($this->mailables)
+            ->concat($this->queuedMailables)
+            ->count();
+
+        PHPUnit::assertSame(
+            $count, $total,
+            "The total number of outgoing mailables was {$total} instead of {$count}."
+        );
+    }
+
     /**
      * Get all of the mailables matching a truth-test callback.
      *

tests/Support/SupportTestingMailFakeTest.php

@@ -133,6 +133,21 @@ public function testAssertSentTimes()
         $this->fake->assertSent(MailableStub::class, 2);
     }
 
+    public function testAssertSentCount()
+    {
+        $this->fake->to('[email protected]')->send($this->mailable);
+        $this->fake->to('[email protected]')->send($this->mailable);
+
+        try {
+            $this->fake->assertSentCount(1);
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString('The total number of mailables sent was 2 instead of 1.', $e->getMessage());
+        }
+
+        $this->fake->assertSentCount(2);
+    }
+
     public function testAssertQueued()
     {
         try {
@@ -162,6 +177,21 @@ public function testAssertQueuedTimes()
         $this->fake->assertQueued(MailableStub::class, 2);
     }
 
+    public function testAssertQueuedCount()
+    {
+        $this->fake->to('[email protected]')->queue($this->mailable);
+        $this->fake->to('[email protected]')->queue($this->mailable);
+
+        try {
+            $this->fake->assertQueuedCount(1);
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString('The total number of mailables queued was 2 instead of 1.', $e->getMessage());
+        }
+
+        $this->fake->assertQueuedCount(2);
+    }
+
     public function testSendQueuesAMailableThatShouldBeQueued()
     {
         $this->fake->to('[email protected]')->send(new QueueableMailableStub);
@@ -204,6 +234,24 @@ public function testAssertNothingQueued()
         }
     }
 
+    public function testAssertOutgoingCount()
+    {
+        $this->fake->assertNothingOutgoing();
+
+        $this->fake->to('[email protected]')->queue($this->mailable);
+
+        try {
+            $this->fake->assertOutgoingCount(2);
+            $this->fail();
+        } catch (ExpectationFailedException $e) {
+            $this->assertStringContainsString('The total number of outgoing mailables was 1 instead of 2.', $e->getMessage());
+        }
+
+        $this->fake->to('[email protected]')->send($this->mailable);
+
+        $this->fake->assertOutgoingCount(2);
+    }
+
     public function testAssertQueuedWithClosure()
     {
         $this->fake->to($user = new LocalizedRecipientStub)->queue($this->mailable);