# NAME

Email::Sender::Server - Eventual Email Delivery System

# VERSION

version 0.35

# SYNOPSIS

    $ ess help start

then ...

    $ ess start

then ...

    package main;
    

    # eventual emailer
    

    my $mailer  = Email::Sender::Server::Client->new;
    

    unless ($mailer->send(to => '...', subject => '...', body => '...')) {
        

        print $mailer->errors_to_string;
        

    }

maybe ...

    $ ess config # set some defaults in ./ess_data/ess.cfg

maybe ...

    $ tree ./ess_data/ # ... peek behind the curtain

also, send email from the command-line ...

    $ ess email to:anewkirk@ana.io from:you@yoursite.com subject:Howdy ...
    

    # or .. err
    

    $ cat textfile.txt | ess email :text to:anewkirk@ana.io  ...

# DESCRIPTION

Email::Sender::Server is designed to provide a simple API for sending
emails from your applications in a non-blocking fashion. It accomplishes this by
separating the email creation and delivery events, thus email delivery becomes
eventual in-that email messages are not required to be delivered immediately.

This is very much a work in-progress, more documentation soon to come, see
[Email::Sender::Server::Client](http://search.cpan.org/perldoc?Email::Sender::Server::Client) for usage exmaples.

# METHODS

## run

The run method is used to execute [Email::Sender::Server::Controller](http://search.cpan.org/perldoc?Email::Sender::Server::Controller) commands.
Most commands exit abruptly and prints to STDOUT. This method is intended to be
used at the command-line.

    use Email::Sender::Server;
    

    my $server = Email::Sender::Server->new;
    

    $server->run('start', 'w:1'); # start the server with 1 worker

# AUTHOR

Al Newkirk <awncorp@cpan.org>

# COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by awncorp.

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