NAME
Emailesque - Lightweight To-The-Point Email
VERSION
version 1.27
SYNOPSIS
use Emailesque qw(
email
);
email {
to => '...',
from => '...',
subject => '...',
message => '...',
};DESCRIPTION
Emailesque provides an easy way of handling text or html email messages with or without attachments. Simply define how you wish to send the email, then call the email keyword passing the necessary parameters as outlined above. This module is basically a wrapper around the email interface Email::Stuffer. The following is an example of the object-oriented interface:
OVERVIEW
use Emailesque;
my $email = Emailesque->new(
to => '...',
from => '...',
subject => '...',
message => '...',
files => [ '/path/to/file/1', '/path/to/file/2' ],
);
my $result = $email->send;
if ($result->isa('Email::Sender::Failure')) {
die $result->message;
}The Emailesque object-oriented interface is designed to accept parameters at instatiation and when calling the send method. This allows you to build-up an email object with a few base parameters, then create and send multiple email messages by calling the send method with only the unique parameters. The following is an example of that:
use Emailesque;
my $email = Emailesque->new(
from => '...',
subject => '...',
x_mailer => "MyApp-Newletter 0.019876",
x_url => "https://mail.to/u/123/welcome",
type => 'text',
);
for my $user (@users) {
my $message = msg_generation $user;
$email->send({ to => $user, message => $message });
}The default email format is plain-text, this can be changed to html by setting the option 'type' to 'html'. The following are options that can be passed within the hashref of arguments to the keyword, constructor and/or the send method:
# send message to
$email->to('...')
# send messages from
$email->from('...')
# email subject
$email->subject('...')
# message body
$email->message('...') # html or text data
# email message content type (type: text, html, or multi)
$email->send({ type => 'text' })
# message multipart content
$email->type('multi') # must set type to multi
$email->message({ text => $text_message, html => $html_messase })
# carbon-copy other email addresses
$email->send({ cc => 'user@site.com' })
$email->send({ cc => 'usr1@site.com, usr2@site.com, usr3@site.com' })
$email->send({ cc => [qw(usr1@site.com usr2@site.com usr3@site.com)] })
# blind carbon-copy other email addresses
$email->send({ bcc => 'user@site.com' })
$email->send({ bcc => 'usr1@site.com, usr2@site.com, usr3@site.com' })
$email->send({ bcc => [qw(usr1@site.com usr2@site.com usr3@site.com)] })
# specify where email responses should be directed
$email->send({ reply_to => 'other_email@website.com' })
# attach files to the email
$email->send({ files => [ $file_path_1, $file_path_2 ] })
# attach files to the email (and specify attachment name)
# set attachment name to undef to use the filename
$email->send({ attach => [ $file_path => $attachment_name ] })
$email->send({ attach => [ $file_path => undef ] })
# send additional headers explicitly
$email->send({ headers => { 'X-Mailer' => '...' } })
# send additional headers implicitly
$email->send({ x_mailer => '...' } # simplerThe default email transport is sendmail. This can be changed by specifying a different driver parameter, e.g. smtp, as well as any additional arguments required by the transport:
# send mail via smtp
$email->send({
...,
driver => 'smtp',
host => 'smtp.googlemail.com',
user => 'account@gmail.com',
pass => '****'
})
# send mail via smtp via Google (gmail)
$email->send({
...,
ssl => 1,
driver => 'smtp',
host => 'smtp.googlemail.com',
port => 465,
user => 'account@gmail.com',
pass => '****'
})
# send mail via smtp via Mailchimp (mandrill)
$email->send({
...,
ssl => 0,
driver => 'smtp',
host => 'smtp.mandrillapp.com',
port => 587,
user => 'account@domain.com',
pass => '****'
})
# send mail via sendmail
# path is optional if installed in a standard location
$email->send({
...,
driver => 'sendmail',
path => '/usr/bin/sendmail',
})METHODS
accept_language
my $header = $email->accept_language;
$header = $email->accept_language('...');The accept_language method is a shortcut for getting and setting the Accept-Language header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
alternate_recipient
my $header = $email->alternate_recipient;
$header = $email->alternate_recipient('...');The alternate_recipient method is a shortcut for getting and setting the Alternate-Recipient header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
apparently_to
my $header = $email->apparently_to;
$header = $email->apparently_to('...');The apparently_to method is a shortcut for getting and setting the Apparently-To header. This header is described in more detail within RFC2076 http://www.iana.org/go/rfc2076.
archived_at
my $header = $email->archived_at;
$header = $email->archived_at('...');The archived_at method is a shortcut for getting and setting the Archived-At header. This header is described in more detail within RFC5064 http://www.iana.org/go/rfc5064.
authentication_results
my $header = $email->authentication_results;
$header = $email->authentication_results('...');The authentication_results method is a shortcut for getting and setting the Authentication-Results header. This header is described in more detail within RFC7001 http://www.iana.org/go/rfc7001.
auto_submitted
my $header = $email->auto_submitted;
$header = $email->auto_submitted('...');The auto_submitted method is a shortcut for getting and setting the Auto-Submitted header. This header is described in more detail within RFC3834 http://www.iana.org/go/rfc3834.
autoforwarded
my $header = $email->autoforwarded;
$header = $email->autoforwarded('...');The autoforwarded method is a shortcut for getting and setting the Autoforwarded header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
autosubmitted
my $header = $email->autosubmitted;
$header = $email->autosubmitted('...');The autosubmitted method is a shortcut for getting and setting the Autosubmitted header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
bcc
my $header = $email->bcc;
$header = $email->bcc('...');The bcc method is a shortcut for getting and setting the Bcc header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
cc
my $header = $email->cc;
$header = $email->cc('...');The cc method is a shortcut for getting and setting the Cc header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
comments
my $header = $email->comments;
$header = $email->comments('...');The comments method is a shortcut for getting and setting the Comments header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
content_identifier
my $header = $email->content_identifier;
$header = $email->content_identifier('...');The content_identifier method is a shortcut for getting and setting the Content-Identifier header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
content_return
my $header = $email->content_return;
$header = $email->content_return('...');The content_return method is a shortcut for getting and setting the Content-Return header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
conversion
my $header = $email->conversion;
$header = $email->conversion('...');The conversion method is a shortcut for getting and setting the Conversion header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
conversion_with_loss
my $header = $email->conversion_with_loss;
$header = $email->conversion_with_loss('...');The conversion_with_loss method is a shortcut for getting and setting the Conversion-With-Loss header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
dkim_signature
my $header = $email->dkim_signature;
$header = $email->dkim_signature('...');The dkim_signature method is a shortcut for getting and setting the DKIM-Signature header. This header is described in more detail within RFC6376 http://www.iana.org/go/rfc6376.
dl_expansion_history
my $header = $email->dl_expansion_history;
$header = $email->dl_expansion_history('...');The dl_expansion_history method is a shortcut for getting and setting the DL-Expansion-History header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
date
my $header = $email->date;
$header = $email->date('...');The date method is a shortcut for getting and setting the Date header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
deferred_delivery
my $header = $email->deferred_delivery;
$header = $email->deferred_delivery('...');The deferred_delivery method is a shortcut for getting and setting the Deferred-Delivery header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
delivery_date
my $header = $email->delivery_date;
$header = $email->delivery_date('...');The delivery_date method is a shortcut for getting and setting the Delivery-Date header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
discarded_x400_ipms_extensions
my $header = $email->discarded_x400_ipms_extensions;
$header = $email->discarded_x400_ipms_extensions('...');The discarded_x400_ipms_extensions method is a shortcut for getting and setting the Discarded-X400-IPMS-Extensions header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
discarded_x400_mts_extensions
my $header = $email->discarded_x400_mts_extensions;
$header = $email->discarded_x400_mts_extensions('...');The discarded_x400_mts_extensions method is a shortcut for getting and setting the Discarded-X400-MTS-Extensions header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
disclose_recipients
my $header = $email->disclose_recipients;
$header = $email->disclose_recipients('...');The disclose_recipients method is a shortcut for getting and setting the Disclose-Recipients header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
disposition_notification_options
my $header = $email->disposition_notification_options;
$header = $email->disposition_notification_options('...');The disposition_notification_options method is a shortcut for getting and setting the Disposition-Notification-Options header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
disposition_notification_to
my $header = $email->disposition_notification_to;
$header = $email->disposition_notification_to('...');The disposition_notification_to method is a shortcut for getting and setting the Disposition-Notification-To header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
downgraded_bcc
my $header = $email->downgraded_bcc;
$header = $email->downgraded_bcc('...');The downgraded_bcc method is a shortcut for getting and setting the Downgraded-Bcc header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_cc
my $header = $email->downgraded_cc;
$header = $email->downgraded_cc('...');The downgraded_cc method is a shortcut for getting and setting the Downgraded-Cc header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_disposition_notification_to
my $header = $email->downgraded_disposition_notification_to;
$header = $email->downgraded_disposition_notification_to('...');The downgraded_disposition_notification_to method is a shortcut for getting and setting the Downgraded-Disposition-Notification-To header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_final_recipient
my $header = $email->downgraded_final_recipient;
$header = $email->downgraded_final_recipient('...');The downgraded_final_recipient method is a shortcut for getting and setting the Downgraded-Final-Recipient header. This header is described in more detail within RFC6857 http://www.iana.org/go/rfc6857.
downgraded_from
my $header = $email->downgraded_from;
$header = $email->downgraded_from('...');The downgraded_from method is a shortcut for getting and setting the Downgraded-From header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_in_reply_to
my $header = $email->downgraded_in_reply_to;
$header = $email->downgraded_in_reply_to('...');The downgraded_in_reply_to method is a shortcut for getting and setting the Downgraded-In-Reply-To header. This header is described in more detail within RFC6857 http://www.iana.org/go/rfc6857.
downgraded_mail_from
my $header = $email->downgraded_mail_from;
$header = $email->downgraded_mail_from('...');The downgraded_mail_from method is a shortcut for getting and setting the Downgraded-Mail-From header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_message_id
my $header = $email->downgraded_message_id;
$header = $email->downgraded_message_id('...');The downgraded_message_id method is a shortcut for getting and setting the Downgraded-Message-Id header. This header is described in more detail within RFC6857 http://www.iana.org/go/rfc6857.
downgraded_original_recipient
my $header = $email->downgraded_original_recipient;
$header = $email->downgraded_original_recipient('...');The downgraded_original_recipient method is a shortcut for getting and setting the Downgraded-Original-Recipient header. This header is described in more detail within RFC6857 http://www.iana.org/go/rfc6857.
downgraded_rcpt_to
my $header = $email->downgraded_rcpt_to;
$header = $email->downgraded_rcpt_to('...');The downgraded_rcpt_to method is a shortcut for getting and setting the Downgraded-Rcpt-To header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_references
my $header = $email->downgraded_references;
$header = $email->downgraded_references('...');The downgraded_references method is a shortcut for getting and setting the Downgraded-References header. This header is described in more detail within RFC6857 http://www.iana.org/go/rfc6857.
downgraded_reply_to
my $header = $email->downgraded_reply_to;
$header = $email->downgraded_reply_to('...');The downgraded_reply_to method is a shortcut for getting and setting the Downgraded-Reply-To header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_resent_bcc
my $header = $email->downgraded_resent_bcc;
$header = $email->downgraded_resent_bcc('...');The downgraded_resent_bcc method is a shortcut for getting and setting the Downgraded-Resent-Bcc header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_resent_cc
my $header = $email->downgraded_resent_cc;
$header = $email->downgraded_resent_cc('...');The downgraded_resent_cc method is a shortcut for getting and setting the Downgraded-Resent-Cc header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_resent_from
my $header = $email->downgraded_resent_from;
$header = $email->downgraded_resent_from('...');The downgraded_resent_from method is a shortcut for getting and setting the Downgraded-Resent-From header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_resent_reply_to
my $header = $email->downgraded_resent_reply_to;
$header = $email->downgraded_resent_reply_to('...');The downgraded_resent_reply_to method is a shortcut for getting and setting the Downgraded-Resent-Reply-To header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_resent_sender
my $header = $email->downgraded_resent_sender;
$header = $email->downgraded_resent_sender('...');The downgraded_resent_sender method is a shortcut for getting and setting the Downgraded-Resent-Sender header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_resent_to
my $header = $email->downgraded_resent_to;
$header = $email->downgraded_resent_to('...');The downgraded_resent_to method is a shortcut for getting and setting the Downgraded-Resent-To header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_return_path
my $header = $email->downgraded_return_path;
$header = $email->downgraded_return_path('...');The downgraded_return_path method is a shortcut for getting and setting the Downgraded-Return-Path header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_sender
my $header = $email->downgraded_sender;
$header = $email->downgraded_sender('...');The downgraded_sender method is a shortcut for getting and setting the Downgraded-Sender header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
downgraded_to
my $header = $email->downgraded_to;
$header = $email->downgraded_to('...');The downgraded_to method is a shortcut for getting and setting the Downgraded-To header. This header is described in more detail within RFC5504 http://www.iana.org/go/rfc5504 and RFC6857 http://www.iana.org/go/rfc6857.
ediint_features
my $header = $email->ediint_features;
$header = $email->ediint_features('...');The ediint_features method is a shortcut for getting and setting the EDIINT-Features header. This header is described in more detail within RFC6017 http://www.iana.org/go/rfc6017.
encoding
my $header = $email->encoding;
$header = $email->encoding('...');The encoding method is a shortcut for getting and setting the Encoding header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
encrypted
my $header = $email->encrypted;
$header = $email->encrypted('...');The encrypted method is a shortcut for getting and setting the Encrypted header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
errors_to
my $header = $email->errors_to;
$header = $email->errors_to('...');The errors_to method is a shortcut for getting and setting the Errors-To header. This header is described in more detail within RFC2076 http://www.iana.org/go/rfc2076.
expires
my $header = $email->expires;
$header = $email->expires('...');The expires method is a shortcut for getting and setting the Expires header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
expiry_date
my $header = $email->expiry_date;
$header = $email->expiry_date('...');The expiry_date method is a shortcut for getting and setting the Expiry-Date header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
from
my $header = $email->from;
$header = $email->from('...');The from method is a shortcut for getting and setting the From header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322 and RFC6854 http://www.iana.org/go/rfc6854.
generate_delivery_report
my $header = $email->generate_delivery_report;
$header = $email->generate_delivery_report('...');The generate_delivery_report method is a shortcut for getting and setting the Generate-Delivery-Report header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
header
my $header = $email->header('X-Tag');
$header = $email->header('X-Tag', '...');The header method is used for getting and setting arbitrary headers by name.
importance
my $header = $email->importance;
$header = $email->importance('...');The importance method is a shortcut for getting and setting the Importance header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
in_reply_to
my $header = $email->in_reply_to;
$header = $email->in_reply_to('...');The in_reply_to method is a shortcut for getting and setting the In-Reply-To header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
incomplete_copy
my $header = $email->incomplete_copy;
$header = $email->incomplete_copy('...');The incomplete_copy method is a shortcut for getting and setting the Incomplete-Copy header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
jabber_id
my $header = $email->jabber_id;
$header = $email->jabber_id('...');The jabber_id method is a shortcut for getting and setting the Jabber-ID header. This header is described in more detail within RFC7259 http://www.iana.org/go/rfc7259.
keywords
my $header = $email->keywords;
$header = $email->keywords('...');The keywords method is a shortcut for getting and setting the Keywords header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
language
my $header = $email->language;
$header = $email->language('...');The language method is a shortcut for getting and setting the Language header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
latest_delivery_time
my $header = $email->latest_delivery_time;
$header = $email->latest_delivery_time('...');The latest_delivery_time method is a shortcut for getting and setting the Latest-Delivery-Time header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
list_archive
my $header = $email->list_archive;
$header = $email->list_archive('...');The list_archive method is a shortcut for getting and setting the List-Archive header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
list_help
my $header = $email->list_help;
$header = $email->list_help('...');The list_help method is a shortcut for getting and setting the List-Help header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
list_id
my $header = $email->list_id;
$header = $email->list_id('...');The list_id method is a shortcut for getting and setting the List-ID header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
list_owner
my $header = $email->list_owner;
$header = $email->list_owner('...');The list_owner method is a shortcut for getting and setting the List-Owner header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
list_post
my $header = $email->list_post;
$header = $email->list_post('...');The list_post method is a shortcut for getting and setting the List-Post header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
list_subscribe
my $header = $email->list_subscribe;
$header = $email->list_subscribe('...');The list_subscribe method is a shortcut for getting and setting the List-Subscribe header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
list_unsubscribe
my $header = $email->list_unsubscribe;
$header = $email->list_unsubscribe('...');The list_unsubscribe method is a shortcut for getting and setting the List-Unsubscribe header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
mmhs_acp127_message_identifier
my $header = $email->mmhs_acp127_message_identifier;
$header = $email->mmhs_acp127_message_identifier('...');The mmhs_acp127_message_identifier method is a shortcut for getting and setting the MMHS-Acp127-Message-Identifier header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_codress_message_indicator
my $header = $email->mmhs_codress_message_indicator;
$header = $email->mmhs_codress_message_indicator('...');The mmhs_codress_message_indicator method is a shortcut for getting and setting the MMHS-Codress-Message-Indicator header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_copy_precedence
my $header = $email->mmhs_copy_precedence;
$header = $email->mmhs_copy_precedence('...');The mmhs_copy_precedence method is a shortcut for getting and setting the MMHS-Copy-Precedence header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_exempted_address
my $header = $email->mmhs_exempted_address;
$header = $email->mmhs_exempted_address('...');The mmhs_exempted_address method is a shortcut for getting and setting the MMHS-Exempted-Address header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_extended_authorisation_info
my $header = $email->mmhs_extended_authorisation_info;
$header = $email->mmhs_extended_authorisation_info('...');The mmhs_extended_authorisation_info method is a shortcut for getting and setting the MMHS-Extended-Authorisation-Info header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_handling_instructions
my $header = $email->mmhs_handling_instructions;
$header = $email->mmhs_handling_instructions('...');The mmhs_handling_instructions method is a shortcut for getting and setting the MMHS-Handling-Instructions header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_message_instructions
my $header = $email->mmhs_message_instructions;
$header = $email->mmhs_message_instructions('...');The mmhs_message_instructions method is a shortcut for getting and setting the MMHS-Message-Instructions header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_message_type
my $header = $email->mmhs_message_type;
$header = $email->mmhs_message_type('...');The mmhs_message_type method is a shortcut for getting and setting the MMHS-Message-Type header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_originator_plad
my $header = $email->mmhs_originator_plad;
$header = $email->mmhs_originator_plad('...');The mmhs_originator_plad method is a shortcut for getting and setting the MMHS-Originator-PLAD header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_originator_reference
my $header = $email->mmhs_originator_reference;
$header = $email->mmhs_originator_reference('...');The mmhs_originator_reference method is a shortcut for getting and setting the MMHS-Originator-Reference header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_other_recipients_indicator_cc
my $header = $email->mmhs_other_recipients_indicator_cc;
$header = $email->mmhs_other_recipients_indicator_cc('...');The mmhs_other_recipients_indicator_cc method is a shortcut for getting and setting the MMHS-Other-Recipients-Indicator-CC header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_other_recipients_indicator_to
my $header = $email->mmhs_other_recipients_indicator_to;
$header = $email->mmhs_other_recipients_indicator_to('...');The mmhs_other_recipients_indicator_to method is a shortcut for getting and setting the MMHS-Other-Recipients-Indicator-To header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_primary_precedence
my $header = $email->mmhs_primary_precedence;
$header = $email->mmhs_primary_precedence('...');The mmhs_primary_precedence method is a shortcut for getting and setting the MMHS-Primary-Precedence header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mmhs_subject_indicator_codes
my $header = $email->mmhs_subject_indicator_codes;
$header = $email->mmhs_subject_indicator_codes('...');The mmhs_subject_indicator_codes method is a shortcut for getting and setting the MMHS-Subject-Indicator-Codes header. This header is described in more detail within RFC6477 http://www.iana.org/go/rfc6477 and ACP123 http://jcs.dtic.mil/j6/cceb/acps/acp123/ACP123B.pdf.
mt_priority
my $header = $email->mt_priority;
$header = $email->mt_priority('...');The mt_priority method is a shortcut for getting and setting the MT-Priority header. This header is described in more detail within RFC6758 http://www.iana.org/go/rfc6758.
message
my $data = $email->message({
text => '...',
html => '...',
});The message method is used for getting and setting the message attribute which is used along with the type attribute to determine how the email message should be constructed. This attribute can be assigned a string or hash reference with text and/or html key/value pairs.
message_context
my $header = $email->message_context;
$header = $email->message_context('...');The message_context method is a shortcut for getting and setting the Message-Context header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
message_id
my $header = $email->message_id;
$header = $email->message_id('...');The message_id method is a shortcut for getting and setting the Message-ID header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
message_type
my $header = $email->message_type;
$header = $email->message_type('...');The message_type method is a shortcut for getting and setting the Message-Type header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
obsoletes
my $header = $email->obsoletes;
$header = $email->obsoletes('...');The obsoletes method is a shortcut for getting and setting the Obsoletes header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
original_encoded_information_types
my $header = $email->original_encoded_information_types;
$header = $email->original_encoded_information_types('...');The original_encoded_information_types method is a shortcut for getting and setting the Original-Encoded-Information-Types header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
original_from
my $header = $email->original_from;
$header = $email->original_from('...');The original_from method is a shortcut for getting and setting the Original-From header. This header is described in more detail within RFC5703 http://www.iana.org/go/rfc5703.
original_message_id
my $header = $email->original_message_id;
$header = $email->original_message_id('...');The original_message_id method is a shortcut for getting and setting the Original-Message-ID header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
original_recipient
my $header = $email->original_recipient;
$header = $email->original_recipient('...');The original_recipient method is a shortcut for getting and setting the Original-Recipient header. This header is described in more detail within RFC3798 http://www.iana.org/go/rfc3798 and RFC5337 http://www.iana.org/go/rfc5337.
original_subject
my $header = $email->original_subject;
$header = $email->original_subject('...');The original_subject method is a shortcut for getting and setting the Original-Subject header. This header is described in more detail within RFC5703 http://www.iana.org/go/rfc5703.
originator_return_address
my $header = $email->originator_return_address;
$header = $email->originator_return_address('...');The originator_return_address method is a shortcut for getting and setting the Originator-Return-Address header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
pics_label
my $header = $email->pics_label;
$header = $email->pics_label('...');The pics_label method is a shortcut for getting and setting the PICS-Label header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
prevent_nondelivery_report
my $header = $email->prevent_nondelivery_report;
$header = $email->prevent_nondelivery_report('...');The prevent_nondelivery_report method is a shortcut for getting and setting the Prevent-NonDelivery-Report header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
priority
my $header = $email->priority;
$header = $email->priority('...');The priority method is a shortcut for getting and setting the Priority header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
privicon
my $header = $email->privicon;
$header = $email->privicon('...');The privicon method is a shortcut for getting and setting the Privicon header. This header is described in more detail within http://www.iana.org/go/draft-koenig-privicons.
received
my $header = $email->received;
$header = $email->received('...');The received method is a shortcut for getting and setting the Received header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322 and RFC5321 http://www.iana.org/go/rfc5321.
received_spf
my $header = $email->received_spf;
$header = $email->received_spf('...');The received_spf method is a shortcut for getting and setting the Received-SPF header. This header is described in more detail within RFC7208 http://www.iana.org/go/rfc7208.
references
my $header = $email->references;
$header = $email->references('...');The references method is a shortcut for getting and setting the References header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
reply_by
my $header = $email->reply_by;
$header = $email->reply_by('...');The reply_by method is a shortcut for getting and setting the Reply-By header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
reply_to
my $header = $email->reply_to;
$header = $email->reply_to('...');The reply_to method is a shortcut for getting and setting the Reply-To header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
require_recipient_valid_since
my $header = $email->require_recipient_valid_since;
$header = $email->require_recipient_valid_since('...');The require_recipient_valid_since method is a shortcut for getting and setting the Require-Recipient-Valid-Since header. This header is described in more detail within RFC7293 http://www.iana.org/go/rfc7293.
resent_bcc
my $header = $email->resent_bcc;
$header = $email->resent_bcc('...');The resent_bcc method is a shortcut for getting and setting the Resent-Bcc header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
resent_cc
my $header = $email->resent_cc;
$header = $email->resent_cc('...');The resent_cc method is a shortcut for getting and setting the Resent-Cc header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
resent_date
my $header = $email->resent_date;
$header = $email->resent_date('...');The resent_date method is a shortcut for getting and setting the Resent-Date header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
resent_from
my $header = $email->resent_from;
$header = $email->resent_from('...');The resent_from method is a shortcut for getting and setting the Resent-From header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322 and RFC6854 http://www.iana.org/go/rfc6854.
resent_message_id
my $header = $email->resent_message_id;
$header = $email->resent_message_id('...');The resent_message_id method is a shortcut for getting and setting the Resent-Message-ID header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
resent_reply_to
my $header = $email->resent_reply_to;
$header = $email->resent_reply_to('...');The resent_reply_to method is a shortcut for getting and setting the Resent-Reply-To header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
resent_sender
my $header = $email->resent_sender;
$header = $email->resent_sender('...');The resent_sender method is a shortcut for getting and setting the Resent-Sender header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322 and RFC6854 http://www.iana.org/go/rfc6854.
resent_to
my $header = $email->resent_to;
$header = $email->resent_to('...');The resent_to method is a shortcut for getting and setting the Resent-To header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
return_path
my $header = $email->return_path;
$header = $email->return_path('...');The return_path method is a shortcut for getting and setting the Return-Path header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
sio_label
my $header = $email->sio_label;
$header = $email->sio_label('...');The sio_label method is a shortcut for getting and setting the SIO-Label header. This header is described in more detail within RFC7444 http://www.iana.org/go/rfc7444.
sio_label_history
my $header = $email->sio_label_history;
$header = $email->sio_label_history('...');The sio_label_history method is a shortcut for getting and setting the SIO-Label-History header. This header is described in more detail within RFC7444 http://www.iana.org/go/rfc7444.
send
my $result = $email->send($attributes, @transport_args);The send method generates a Email::Stuffer object based on the stashed and passed in attributes, and attempts delivery using the configured transport.
sender
my $header = $email->sender;
$header = $email->sender('...');The sender method is a shortcut for getting and setting the Sender header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322 and RFC6854 http://www.iana.org/go/rfc6854.
sensitivity
my $header = $email->sensitivity;
$header = $email->sensitivity('...');The sensitivity method is a shortcut for getting and setting the Sensitivity header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
solicitation
my $header = $email->solicitation;
$header = $email->solicitation('...');The solicitation method is a shortcut for getting and setting the Solicitation header. This header is described in more detail within RFC3865 http://www.iana.org/go/rfc3865.
subject
my $header = $email->subject;
$header = $email->subject('...');The subject method is a shortcut for getting and setting the Subject header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
supersedes
my $header = $email->supersedes;
$header = $email->supersedes('...');The supersedes method is a shortcut for getting and setting the Supersedes header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
to
my $header = $email->to;
$header = $email->to('...');The to method is a shortcut for getting and setting the To header. This header is described in more detail within RFC5322 http://www.iana.org/go/rfc5322.
vbr_info
my $header = $email->vbr_info;
$header = $email->vbr_info('...');The vbr_info method is a shortcut for getting and setting the VBR-Info header. This header is described in more detail within RFC5518 http://www.iana.org/go/rfc5518.
x_archived_at
my $header = $email->x_archived_at;
$header = $email->x_archived_at('...');The x_archived_at method is a shortcut for getting and setting the X-Archived-At header. This header is described in more detail within RFC5064 http://www.iana.org/go/rfc5064.
x400_content_identifier
my $header = $email->x400_content_identifier;
$header = $email->x400_content_identifier('...');The x400_content_identifier method is a shortcut for getting and setting the X400-Content-Identifier header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
x400_content_return
my $header = $email->x400_content_return;
$header = $email->x400_content_return('...');The x400_content_return method is a shortcut for getting and setting the X400-Content-Return header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
x400_content_type
my $header = $email->x400_content_type;
$header = $email->x400_content_type('...');The x400_content_type method is a shortcut for getting and setting the X400-Content-Type header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
x400_mts_identifier
my $header = $email->x400_mts_identifier;
$header = $email->x400_mts_identifier('...');The x400_mts_identifier method is a shortcut for getting and setting the X400-MTS-Identifier header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
x400_originator
my $header = $email->x400_originator;
$header = $email->x400_originator('...');The x400_originator method is a shortcut for getting and setting the X400-Originator header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
x400_received
my $header = $email->x400_received;
$header = $email->x400_received('...');The x400_received method is a shortcut for getting and setting the X400-Received header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
x400_recipients
my $header = $email->x400_recipients;
$header = $email->x400_recipients('...');The x400_recipients method is a shortcut for getting and setting the X400-Recipients header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
x400_trace
my $header = $email->x400_trace;
$header = $email->x400_trace('...');The x400_trace method is a shortcut for getting and setting the X400-Trace header. This header is described in more detail within RFC4021 http://www.iana.org/go/rfc4021.
AUTHOR
Al Newkirk <anewkirk@ana.io>
CONTRIBUTORS
Andrew Beverley <a.beverley@ctrlo.com>
Eric Johnson <eric.git@iijo.org>
Martin H. Sluka <martin@sluka.de>
Stefan Hornburg <racke@linuxia.de>
Martin Sluka <perl@sluka.de>
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Al Newkirk.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.