Given a $option__values hashref, transform it to an arrayref suitable for sending as multipart/form-data. The core logic here is that array references are modified from:
option => [ value1, value2, ... ]
to
[ option => value1, option => value2, ... ]
WWW::Mailgun - Perl wrapper for Mailgun (http://mailgun.org)
use WWW::Mailgun; my $mg = WWW::Mailgun->new({ key => 'key-yOuRapiKeY', domain => 'YourDomain.mailgun.org', from => 'elb0w <elb0w@YourDomain.mailgun.org>' # Optionally set here, you can set it when you send }); #sending examples below # Get stats http://documentation.mailgun.net/api-stats.html my $obj = $mg->stats; # Get logs http://documentation.mailgun.net/api-logs.html my $obj = $mg->logs;
Mailgun is a email service which provides email over a http restful API. These bindings goal is to create a perl interface which allows you to easily leverage it.
Creates your mailgun object
from => the only optional field, it can be set in the message.
Send takes in a hash of settings Takes all specificed here http://documentation.mailgun.net/api-sending.html 'from' is optionally set here, otherwise you can set it in the constructor and it can be used for everything
$mg->send({ to => 'some_email@gmail.com', subject => 'hello', html => '<html><h3>hello</h3><strong>world</strong></html>', attachment => ['/Users/elb0w/GIT/Personal/Mailgun/test.pl'] });
$mg->send({ to => 'some_email@gmail.com', subject => 'hello', text => 'Hello there' });
$mg->send({ to => 'some_email@gmail.com', subject => 'hello', text => 'Hello there', html => '<b>Hello there</b>' });
Helper methods all take a method argument (del, post, get) http://documentation.mailgun.net/api_reference.html 'post' optionally takes a hash of properties
# View all unsubscribes L<http://documentation.mailgun.net/api-unsubscribes.html> my $all = $mg->unsubscribes; # Unsubscribe user from all $mg->unsubscribes('post',{address => 'user@website.com', tag => '*'}); # Delete a user from unsubscriptions $mg->unsubscribes('del','user@website.com'); # Get a user from unsubscriptions $mg->unsubscribes('get','user@website.com');
# View all spam complaints L<http://documentation.mailgun.net/api-complaints.html> my $all = $mg->complaints; # Add a spam complaint for a address $mg->complaints('post',{address => 'user@website.com'}); # Remove a complaint $mg->complaints('del','user@website.com'); # Get a complaint for a adress $mg->complaints('get','user@website.com');
# View the list of bounces L<http://documentation.mailgun.net/api-bounces.html> my $all = $mg->bounces; # Add a permanent bounce $mg->bounces('post',{ address => 'user@website.com', code => 550, #This is default error => 'Error Description' #Empty by default }); # Remove a bounce $mg->bounces('del','user@website.com'); # Get a bounce for a specific address $mg->bounces('get','user@website.com');
George Tsafas <elb0w@elbowrage.com>
elb0w on irc.freenode.net #perl https://github.com/gtsafas/mailgun.perl
http://documentation.mailgun.net/
6 POD Errors
The following errors were encountered while parsing the POD:
'=item' outside of any '=over'
You forgot a '=back' before '=head2'
You forgot a '=back' before '=head1'
To install WWW::Mailgun, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::Mailgun
CPAN shell
perl -MCPAN -e shell install WWW::Mailgun
For more information on module installation, please visit the detailed CPAN module installation guide.