Email::Send::Test(3)

💌 Email::Send::Test — the manual, but make it make sense

okay so bestie, this is Email::Send::Test(3) — a Perl module page, and honestly? It's a whole vibe. It's a fake mailer that just catches your emails so you can test stuff without bothering real humans. Iconic behavior fr fr. 🎀

---

✨ NAME ✨

Email::Send::Test — captures emails sent via Email::Send for testing 💅

---

🌸 SYNOPSIS 🌸

# Load as normal
use Email::Send;
use Email::Send::Test;

# Always clear the email trap before each test to prevent unexpected
# results, and thus spurious test results.
Email::Send::Test->clear;

### BEGIN YOUR CODE TO BE TESTED (example follows)
my $sender = Email::Send->new({ mailer => 'Test' });
$sender->send( $message );
### END YOUR CODE TO BE TESTED

# Check that the number and type (and content) of mails
# matched what you expect.
my @emails = Email::Send::Test->emails;
is( scalar(@emails), 1, 'Sent 1 email' );
isa_ok( $emails[0], 'Email::MIME' ); # Email::Simple subclasses pass through

---

🦋 DESCRIPTION 🦋

Email::Send::Test is a driver — literally made for testing apps that use Email::Send to send email. 🫶

So here's the thing: to use it in your tests, you're gonna need some kind of configuration mechanism that specifies the delivery method to be used, or some other way that, in your testing scripts, you can convince your code to use "Test" as the mailer instead of "Sendmail" or another real mailer. No cap. 💀

🧚 How does it Work

Email::Send::Test is a trap for emails. 🪤 When an email is sent, it adds the emails to an internal array without doing anything at all to them, and returns success to the caller. Like, it does not touch them. It's just holding them. Princess carry energy. 👑

If your application sends one email, there will be one in the trap. If you send 20, there will be 20, and so on. Math is math. ✨

A typical test will involve running some code that should result in an email being sent, and then checking in the trap to see if the code did actually send out the email.

If you want, you can get the emails out the trap and examine them. And if you only care that something got sent, you can simply clear the trap and move on to your next test. Lowkey the easiest path. 🍓

🌈 The Email Trap

The email trap is a simple array that fills with whatever is sent. 🎀

When you send an email, it is pushed onto the end of the array. You can access the array directly if you wish, or use the methods provided. Your choice, bestie, both are valid. 💖

---

💅 METHODS 💅

📨 send $message

As for every other Email::Send mailer, "send" takes the message to be sent.

However, in our case there are no arguments of any value to us, and so they are ignored. 🙈

It's worth noting that we do NOTHING to check or alter the email. For example, if we are passed undef, it ends up as is in the trap. In this manner, you can see exactly what was sent without any possible tampering on the part of the testing mailer. She's honest. She's transparent. 🫶

of course, this doesn't prevent any tampering by Email::Send itself :)

Always returns true. ✅

📬 emails

The "emails" method is the preferred and recommended method of getting access to the email trap. Like, this is the way. 👑

• In list context, returns the content of the trap array as a list.
• In scalar context, returns the number of items in the trap.

🧹 clear

The "clear" method resets the trap, emptying it. Poof. Gone. 🪄

It is recommended you always clear the trap before each test to ensure any existing emails are removed and don't create a spurious test result.

Always returns true. ✅

📦 deliveries

This method returns a list of arrayrefs, one for each call to "send" that has been made. Each arrayref is in the form:

[ $mailer, $email, \@rest ]

The first element is the invocant on which "send" was called. The second is the email that was given to "send". The third is the rest of the arguments given to "send". Receipts. 🧾

---

👑 AUTHOR 👑

Adam Kennedy <cpan@ali.as>, <http://ali.as/>.

---

💜 CONTRIBUTORS 💜

• Chase Whitener, <capoeirab@cpan.org>.
• Ricardo SIGNES, <rjbs@cpan.org>.

---

📜 COPYRIGHT AND LICENSE 📜

Copyright (c) 2004 - 2005 Adam Kennedy. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's the whole page, bestie — no notes, she ate 💅✨

signed, sealed, delivered by perl v5.42.0, dated 2024-08-17 — mwah 🎀🦋