Tom Molesworth

NAME

Net::Async::SMTP::Client - sending email with IO::Async

VERSION

version 0.002

SYNOPSIS

 #!/usr/bin/env perl
 use strict;
 use warnings;
 use IO::Async::Loop;
 use Net::Async::SMTP::Client;
 use Email::Simple;
 my $email = Email::Simple->create(
        header => [
                From    => 'someone@example.com',
                To      => 'other@example.com',
                Subject => 'NaSMTP test',
        ],
        attributes => {
                encoding => "8bitmime",
                charset  => "UTF-8",
        },
        body_str => '... text ...',
 );
 my $loop = IO::Async::Loop->new;
 $loop->add(
        my $smtp = Net::Async::SMTP::Client->new(
                domain => 'example.com',
        )
 );
 $smtp->connected->then(sub {
        $smtp->login(
                user => '...',
                pass => '...',
        )
 })->then(sub {
        $smtp->send(
                to   => 'someone@example.com',
                from => 'other@example.com',
                data => $email->as_string,
        )
 })->get;

DESCRIPTION

Provides basic email sending capability for IO::Async, using the Protocol::SMTP implementation.

See "DESCRIPTION" in Protocol::SMTP for a list of supported features and usage instructions.

METHODS

connection

Establishes or returns the TCP connection to the SMTP server.

  • If we had a host, we'll connect directly.

  • If we have a domain, then we'll do an MX lookup on it.

  • If we don't have either, you'll probably just see errors or unresolved futures.

Returns the Future representing the connection. Attach events via methods on Future such as on_done, then etc.

See also: "connected"

mx_lookup

Looks up MX records for the given domain.

Returns a Future which will resolve to the list of records found.

configure

Overrides IO::Async::Notifier configure to apply SMTP-specific config.

connected

Returns the Future indicating our SMTP connection.

Resolves to a Net::Async::SMTP::Connection instance on success.

ssl_parameters

Returns any defined SSL parameters as passed to the constructor or "configure".

login

Attempts login, connecting first if required.

Returns a Future which will resolve with this instance when the login completes.

send

Attempts to send message(s), connecting first if required.

If this server requires login, you'll need to call "login" yourself.

See "send" in Protocol::SMTP::Client.

Returns a Future.

METHODS - Accessors

port

Returns the port used for communicating with the server, or undef for default (25).

host

Returns the host we're going to connect to.

domain

Returns the domain used for the email server.

auth

Returns the auth method used for server authentication.

INHERITED METHODS

IO::Async::Notifier

add_child, can_event, children, debug_printf, get_loop, invoke_event, loop, make_event_cb, maybe_invoke_event, maybe_make_event_cb, new, notifier_name, parent, remove_child, remove_from_parent

AUTHOR

Tom Molesworth <cpan@entitymodel.com>

LICENSE

Copyright Tom Molesworth 2012-2014. Licensed under the same terms as Perl itself.