Mail::SendEasy(3pm)

✨ Mail::SendEasy ✨

okay bestie, sit down, hydrate, and let me tell you about Mail::SendEasy — it's a Perl module from the User Contributed Perl Documentation crew, and it's literally here to send your emails for you. 🫶

---

💌 NAME

Mail::SendEasy — send plain/html e-mails through SMTP servers (platform independent). Supports SMTP authentication and attachments. 💅

---

🌸 DESCRIPTION

So this module sends e-mails the easy way, and the way that it has no dependencies? Iconic. Fr fr, you do not need to install libnet. Not even a little bit. 🎀

It supports SMTP authentication and attachments. That's the whole vibe. ✨

---

🦋 USAGE

💖 OO

use Mail::SendEasy ;

my $mail = new Mail::SendEasy(
smtp => 'localhost' ,
user => 'foo' ,
pass => 123 ,
) ;

my $status = $mail->send(
from    => 'sender@foo.com' ,
from_title => 'Foo Name' ,
reply   => 're@foo.com' ,
error   => 'error@foo.com' ,
to      => 'recp@domain.foo' ,
cc      => 'recpcopy@domain.foo' ,
subject => "MAIL Test" ,
msg     => "The Plain Msg..." ,
html    => "<b>The HTML Msg...</b>" ,
msgid   => "0101" ,
) ;

if (!$status) { print $mail->error ;}

🌈 STRUCTURED

use Mail::SendEasy ;

my $status = Mail::SendEasy::send(
smtp => 'localhost' ,
user => 'foo' ,
pass => 123 ,
from    => 'sender@foo.com' ,
from_title => 'Foo Name' ,
reply   => 're@foo.com' ,
error   => 'error@foo.com' ,
to      => 'recp@domain.foo' ,
cc      => 'recpcopy@domain.foo' ,
subject => "MAIL Test" ,
msg     => "The Plain Msg..." ,
html    => "<b>The HTML Msg...</b>" ,
msgid   => "0101" ,
) ;

if (!$status) { Mail::SendEasy::error ;}

---

👑 METHODS

🌟 new (%OPTIONS)

here's your %OPTIONS menu, bestie:

• smtp — the SMTP server. (Default: localhost) 🖥️
• port — the SMTP port. (Default: 25) 🔌
• timeout — how long it waits for the connection and data. (Default: 120) ⏳
• user — the username for authentication. 🪪
• pass — the password for authentication. 🔐

🌟 send (%OPTIONS)

and here's the %OPTIONS for sending, no cap:

• from — the e-mail adress of the sender. (Only accept one adress). 📮
• from_title — the name or title of the sender. 🏷️
• reply — e-mail used to reply to your e-mail. ↩️
• error — e-mail to send error messages. 🚨
• to — recipient e-mail adresses. 📬
• cc — adresses to receive a copy. 📋
• subject — the subject of your e-mail. ✏️
• msg — the plain message. 📝
• html — the HTML message. If used with MSG (plain), the format "multipart/alternative" will be used. Readers that can read HTML messages will use the HTML argument, and readers with only plain messages will use MSG. 💻
• msgid — an ID to insert in the e-mail Headers. The header will be: Msg-ID: xxxxx 🆔
• anex — send file(s) attached. Just put the right path in the machine for the file. For more than one file use ARRAY ref: ['file1','file2'] 📎

** Will load all the files in the memory.

• zipanex — compress with zip the ANEX (attached) file(s). All the files will be inside the same zip file. 🗜️

If the argument has the extension .zip, will be used for the name of the zip file. If not, the file will be "anex.zip", and if exist only one ANEX, the name will be the same of the ANEX, but with the extension .zip.

** Need the module Archive::Zip installed or the argument will be skipped.

** This will generate the zip file in the memory.

---

🧚 SEE ALSO

Mail::SendEasy::SMTP, Mail::SendEasy::AUTH, HPL.

This module was created to handle the e-mail system of HPL. 💜

---

💀 AUTHOR

Graciliano M. P. <gm@virtuasites.com.br>

I will appreciate any type of feedback (include your opinions and/or suggestions). ;-P 🙈

---

📜 COPYRIGHT

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

---

okay that's the whole page, bestie!! this lil gem is from perl v5.32.0, dated 2021-01-05, and it's living its best life as Mail::SendEasy(3pm) in the User Contributed Perl Documentation collection. go send some emails, you got this 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜