iwai****@users*****
iwai****@users*****
2009年 12月 18日 (金) 17:19:25 JST
Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/DevNull.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/DevNull.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/DevNull.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,29 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::DevNull - happily throw away your mail + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +This class implements L<Email::Sender::Transport>. Any mail sent through a +DevNull transport will be silently discarded. + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Failable.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Failable.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Failable.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,39 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::Failable - a wrapper to makes things fail predictably + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +This transport extends L<Email::Sender::Transport::Wrapper>, meaning that it +must be created with a C<transport> attribute of another +Email::Sender::Transport. It will proxy all email sending to that transport, +but only after first deciding if it should fail. + +It does this by calling each coderef in its C<failure_conditions> attribute, +which must be an arrayref of code references. Each coderef will be called and +will be passed the Failable transport, the Email::Abstract object, the +envelope, and a reference to an array containing the rest of the arguments to +C<send>. + +If any coderef returns a true value, the value will be used to signal failure. + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Maildir.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Maildir.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Maildir.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,38 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::Maildir - deliver mail to a maildir on disk + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +This transport delivers into a maildir. The maildir's location may be given as +the F<dir> argument to the constructor, and defaults to F<Maildir> in the +current directory (at the time of transport initialization). + +If the directory does not exist, it will be created. + +Three headers will be added: + + * X-Email-Sender-From - the envelope sender + * X-Email-Sender-To - the envelope recipients (one header per rcpt) + * Lines - the number of lines in the body + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Mbox.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Mbox.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Mbox.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,32 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::Mbox - deliver mail to an mbox on disk + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +This transport delivers into an mbox. The mbox file may be given by the +F<filename> argument to the constructor, and defaults to F<mbox>. + +The transport I<currently> assumes that the mbox is in F<mboxo> format, but +this may change or be configurable in the future. + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Print.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Print.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Print.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,30 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::Print - print email to a filehandle (like stdout) + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +When this transport is handed mail, it prints it to a filehandle. By default, +it will print to STDOUT, but it can be given any L<IO::Handle> object to print +to as its C<fh> attribute. + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/SMTP.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/SMTP.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/SMTP.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,65 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::SMTP - send email over SMTP + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +This transport is used to send email over SMTP, either with or without secure +sockets (SSL). It is one of the most complex transports available, capable of +partial success. + +For a potentially more efficient version of this transport, see +L<Email::Sender::Transport::SMTP::Persistent>. + +=head1 ATTRIBUTES + +The following attributes may be passed to the constructor: + +=over + +=item host - the name of the host to connect to; defaults to localhost + +=item ssl - if true, connect via SSL; defaults to false + +=item port - port to connect to; defaults to 25 for non-SSL, 465 for SSL + +=item sasl_username - the username to use for auth; optional + +=item sasl_password - the password to use for auth; must be provided if username is provided + +=item allow_partial_success - if true, will send data even if some recipients were rejected + +=item helo - what to say when saying HELO; no default + +=item localaddr - local address from which to connect + +=item localpart - local port from which to connect + +=back + +=head1 PARTIAL SUCCESS + +If C<allow_partial_success> was set when creating the transport, the transport +may return L<Email::Sender::Success::Partial> objects. Consult that module's +documentation. + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Sendmail.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Sendmail.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Sendmail.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,35 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::Sendmail - send mail via sendmail(1) + +=head1 VERSION + +version 0.093380 + +=head2 DESCRIPTION + +This transport sends mail by piping it to the F<sendmail> command. If the +location of the F<sendmail> command is not provided in the constructor (see +below) then the library will look for an executable file called F<sendmail> in +the path. + +To specify the location of sendmail: + + my $sender = Email::Sender::Transport::Sendmail->new({ sendmail => $path }); + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Test.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Test.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Test.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,67 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::Test - deliver mail in memory for testing + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +This transport is meant for testing email deliveries in memory. It will store +a record of any delivery made so that they can be inspected afterward. + +=head1 ATTRIBUTES + +=head2 deliveries + +=for Pod::Coverage recipient_failure delivery_failure + +By default, the Test transport will not allow partial success and will always +succeed. It can be made to fail predictably, however, if it is extended and +its C<recipient_failure> or C<delivery_failure> methods are overridden. These +methods are called as follows: + + $self->delivery_failure($email, $envelope); + + $self->recipient_failure($to); + +If they return true, the sending will fail. If the transport was created with +a true C<allow_partial_success> attribute, recipient failures can cause partial +success to be returned. + +For more flexible failure modes, you can override more aggressively or can use +L<Email::Sender::Transport::Failable>. + +=for Pod::Coverage clear_deliveries + +This attribute stores an arrayref of all the deliveries made via the transport. +It can be emptied by calling C<clear_deliveries>. + +Each delivery is a hashref, in the following format: + + { + email => $email, + envelope => $envelope, + successes => \@ok_rcpts, + failures => \@failures, + } + +Both successful and failed deliveries are stored. + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut + Index: docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Wrapper.pod diff -u /dev/null docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Wrapper.pod:1.1 --- /dev/null Fri Dec 18 17:19:25 2009 +++ docs/modules/Email-Sender-0.093380/lib/Email/Sender/Transport/Wrapper.pod Fri Dec 18 17:19:25 2009 @@ -0,0 +1,30 @@ +=pod + +=head1 NAME + +Email::Sender::Transport::Wrapper - a mailer to wrap a mailer for mailing mail + +=head1 VERSION + +version 0.093380 + +=head1 DESCRIPTION + +Email::Sender::Transport::Wrapper wraps a transport, provided as the +C<transport> argument to the constructor. It is provided as a simple way to +use method modifiers to create wrapping classes. + +=head1 AUTHOR + + Ricardo Signes <rjbs****@cpan*****> + +=head1 COPYRIGHT AND LICENSE + +This software is copyright (c) 2009 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. + + +=cut +
