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

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

NAME

       Email::Folder - read all the messages from a folder as Email::Simple objects.

SYNOPSIS

	use Email::Folder;

	my $folder = Email::Folder->new("some_file");

	print join "
", map { $_->header("Subject") } $folder->messages;

METHODS

   new($folder, %options)
       Takes the name of a folder, and a hash of options

       If a 'reader' option is passed in then that is used as the class to read in messages with.

   messages
       Returns a list containing all of the messages in the folder.  Can only be called once as it drains the iterator.

   next_message
       acts as an iterator.  reads the next message from a folder.  returns false at the end of the folder

   bless_message($message)
       Takes a raw RFC822 message and blesses it into a class.

       By default this is an Email::Simple object but can easily be overriden in a subclass.

       For example, this simple subclass just returns the raw rfc822 messages, and exposes the speed of the parser.

	package Email::RawFolder;
	use base 'Email::Folder';
	sub bless_message { $_[1] };
	1;

   reader
       read-only accessor to the underlying Email::Reader subclass instance

PERL EMAIL PROJECT

       This module is maintained by the Perl Email Project

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

AUTHORS

       Simon Wistow <simon@thegestalt.org>

       Richard Clamp <richardc@unixbeard.net>

COPYING

       Copyright 2006, Simon Wistow

       Distributed under the same terms as Perl itself.

       This software is under no warranty and will probably ruin your life, kill your friends, burn your house and bring about the doobie
       brothers.

SEE ALSO

       Email::LocalDelivery, Email::FolderType, Email::Simple

perl v5.10.0							    2009-07-27							Email::Folder(3pm)

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

NAME

       Email::Sender - a library for sending email

VERSION

       version 0.110005

SYNOPSIS

	 my $message = Email::MIME->create( ... );
	 # produce an Email::Abstract compatible message object,
	 # e.g. produced by Email::Simple, Email::MIME, Email::Stuff

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

	 try {
	   sendmail(
	     $message,
	     {
	       from => $SMTP_ENVELOPE_FROM_ADDRESS,
	       transport => Email::Sender::Transport::SMTP->new({
		   host => $SMTP_HOSTNAME,
		   port => $SMTP_PORT,
	       })
	     }
	   );
	 } catch {
	     warn "sending failed: $_";
	 };

OVERVIEW

       Email::Sender replaces the old and sometimes problematic Email::Send library, which did a decent job at handling very simple email sending
       tasks, but was not suitable for serious use, for a variety of reasons.

       Most users will be able to use Email::Sender::Simple to send mail.  Users with more specific needs should look at the available
       Email::Sender::Transport classes.

       Documentation may be found in Email::Sender::Manual, and new users should start with Email::Sender::Manual::QuickStart.

IMPLEMENTING

       Email::Sender itelf is a Moose role.  Any class that implements Email::Sender is required to provide a method called "send".  This method
       should accept any input that can be understood by Email::Abstract, followed by a hashref containing "to" and "from" arguments to be used as
       the envelope.  The method should return an Email::Sender::Success object on success or throw an Email::Sender::Failure on failure.

AUTHOR

       Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Ricardo Signes.

       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-03-06							Email::Sender(3pm)