NAME

       Email::Sender - a library for sending email

VERSION

       version 1.300010

SYNOPSIS

         my $message = Email::MIME->create( ... );
         # produce an Email::Abstract compatible message object,
         # e.g. produced by Email::Simple, Email::MIME, Email::Stuff

         use Email::Sender::Simple qw(sendmail);
         use Email::Sender::Transport::SMTP qw();
         use Try::Tiny;

         try {
           sendmail(
             $message,
             {
               from => $SMTP_ENVELOPE_FROM_ADDRESS,
               transport => Email::Sender::Transport::SMTP->new({
                   host => $SMTP_HOSTNAME,
                   port => $SMTP_PORT,
               })
             }
           );
         } catch {
             warn "sending failed: $_";
         };

OVERVIEW

       Email::Sender replaces the old and sometimes problematic Email::Send library, which did a
       decent job at handling very simple email sending tasks, but was not suitable for serious
       use, for a variety of reasons.

       Most users will be able to use Email::Sender::Simple to send mail.  Users with more
       specific needs should look at the available Email::Sender::Transport classes.

       Documentation may be found in Email::Sender::Manual, and new users should start with
       Email::Sender::Manual::QuickStart.

IMPLEMENTING

       Email::Sender itelf is a Moo role.  Any class that implements Email::Sender is required to
       provide a method called "send".  This method should accept any input that can be
       understood by Email::Abstract, followed by a hashref containing "to" and "from" arguments
       to be used as the envelope.  The method should return an Email::Sender::Success object on
       success or throw an Email::Sender::Failure on failure.

AUTHOR

       Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2014 by Ricardo Signes.

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