email::messageid(3pm) [debian man page]

Email::MessageID(3pm)					User Contributed Perl Documentation				     Email::MessageID(3pm)

NAME

       Email::MessageID - Generate world unique message-ids.

SYNOPSIS

	 use Email::MessageID;

	 my $mid = Email::MessageID->new->in_brackets;

	 print "Message-ID: $midx0Ax0D";

DESCRIPTION

       Message-ids are optional, but highly recommended, headers that identify a message uniquely. This software generates a unique message-id.

METHODS

   new
	 my $mid = Email::MessageID->new;

	 my $new_mid = Email::MessageID->new( host => $myhost );

       This class method constructs an Email::Address object containing a unique message-id. You may specify custom "host" and "user" parameters.

       By default, the "host" is generated from "Sys::Hostname::hostname".

       By default, the "user" is generated using "Time::HiRes"'s "gettimeofday" and the process ID.

       Using these values we have the ability to ensure world uniqueness down to a specific process running on a specific host, and the exact time
       down to six digits of microsecond precision.

   create_host
	 my $domain_part = Email::MessageID->create_host;

       This method returns the domain part of the message-id.

   create_user
	 my $local_part = Email::MessageID->create_user;

       This method returns a unique local part for the message-id.  It includes some random data and some predictable data.

   in_brackets
       When using Email::MessageID directly to populate the "Message-ID" field, be sure to use "in_brackets" to get the string inside angle
       brackets:

	 header => [
	   ...
	   'Message-Id' => Email::MessageID->new->in_brackets,
	 ],

       Don't make this common mistake:

	 header => [
	   ...
	   'Message-Id' => Email::MessageID->new->as_string, # WRONG!
	 ],

SEE ALSO

       Email::Address, Time::HiRes, Sys::Hostname, perl.

PERL EMAIL PROJECT

       This module is maintained by the Perl Email Project.

       <http://emailproject.perl.org/wiki/Email::MessageID>

AUTHOR

       Casey West, <casey@geeknest.com>.

COPYRIGHT

	 Copyright (c) 2004 Casey West.  All rights reserved.
	 This module is free software; you can redistribute it and/or modify it
	 under the same terms as Perl itself.

perl v5.10.1							    2010-07-15						     Email::MessageID(3pm)

Email::Sender::Transport::SMTP::TLS(3pm)		User Contributed Perl Documentation		  Email::Sender::Transport::SMTP::TLS(3pm)

NAME

       Email::Sender::Transport::SMTP::TLS - Email::Sender with Net::SMTP::TLS (Eg. Gmail)

VERSION

       version 0.10

SYNOPSIS

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

	   my $transport = Email::Sender::Transport::SMTP::TLS->new(
	       host => 'smtp.gmail.com',
	       port => 587,
	       username => 'username@gmail.com',
	       password => 'password',
	       helo => 'fayland.org',
	   );

	   # my $message = Mail::Message->read($rfc822)
	   #	     || Email::Simple->new($rfc822)
	   #	     || Mail::Internet->new([split /
/, $rfc822])
	   #	     || ...
	   #	     || $rfc822;
	   # read L<Email::Abstract> for more details

	   use Email::Simple::Creator; # or other Email::
	   my $message = Email::Simple->create(
	       header => [
		   From    => 'username@gmail.com',
		   To	   => 'to@mail.com',
		   Subject => 'Subject title',
	       ],
	       body => 'Content.',
	   );

	   try {
	       sendmail($message, { transport => $transport });
	   } catch {
	       die "Error sending email: $_";
	   };

DESCRIPTION

       Email::Sender replaces the old and sometimes problematic Email::Send library, while this module replaces the Email::Send::SMTP::TLS.

       It is still alpha, but it works. use it at your own risk!

   ATTRIBUTES
       The following attributes may be passed to the constructor:

       host - the name of the host to connect to; defaults to localhost
       port - port to connect to; defaults to 587
       username - the username to use for auth; required
       password - the password to use for auth; required
       helo - what to say when saying HELO; no default
       allow_partial_success - if true, will send data even if some recipients were rejected

   PARTIAL SUCCESS
       If "allow_partial_success" was set when creating the transport, the transport may return Email::Sender::Success::Partial objects.  Consult
       that module's documentation.

AUTHOR

       Fayland Lam <fayland@gmail.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Fayland Lam.

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

perl v5.14.2							    2012-06-25				  Email::Sender::Transport::SMTP::TLS(3pm)