Test::Smoke::Mailer.3pm

Langue: en

Version: 2008-07-19 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

Test::Smoke::Mailer - Wrapper to send the report.

SYNOPSIS

     use Test::Smoke::Mailer;
 
     my %args = ( mhowto => 'smtp', mserver => 'smtp.your.domain' );
     my $mailer = Test::Smoke::Mailer->new( $ddir, %args );
 
     $mailer->mail or die "Problem in mailing: " . $mailer->error;
 
 

DESCRIPTION

This little wrapper still allows you to use the sendmail, mail or mailx programs, but prefers to use the Mail::Sendmail module (which comes with this distribution) to send the reports.

METHODS

Test::Smoke::Mailer->new( $mailer[, %args] )
Can we provide sensible defaults for the mail stuff?
     mhowto  => [Module::Name|sendmail|mail|mailx]
     mserver => an SMTP server || localhost
     mbin    => the full path to the mail binary
     mto     => list of addresses (comma separated!)
     mfrom   => single address
     mcc     => list of addresses (coma separated!)
 
 
$mailer->fetch_report( )
"fetch_report()" reads mktest.rpt from "{ddir}" and return the subject line for the mail-message.
$mailer->error( )
"error()" returns the value of "$mailer->{error}".
$self->_get_cc( $subject )
"_get_cc()" implements the "--ccp5p_onfail" option. It looks at the subject to see if the smoke FAILed and then adds the perl5-porters mailing-list to the "Cc:" field unless it is already part of "To:" or "Cc:".

The new behaviour is to only return "Cc:" on fail. This is determined by the new global regex kept in $Test::Smoke::Mailer::NOCC_RE.

Test::Smoke::Mailer->config( $key[, $value] )
"config()" is an interface to the package lexical %CONFIG, which holds all the default values for the "new()" arguments.

With the special key all_defaults this returns a reference to a hash holding all the default values.

Test::Smoke::Mailer::Sendmail

This handles sending the message by piping it to the sendmail program.
Test::Smoke::Mailer::Sendmail->new( %args )
Keys for %args:
   * ddir
   * sendmailbin
   * to
   * from
   * cc
   * v
 
 
$mailer->mail( )
"mail()" sets up a header and body and pipes them to the sendmail program.

Test::Smoke::Mailer::Mail_X

This handles sending the message with either the mail or mailx program.
Test::Smoke::Mailer::Mail_X->new( %args )
Keys for %args:
   * ddir
   * mailbin/mailxbin
   * to
   * cc
   * v
 
 
$mailer->mail( )
"mail()" sets up the commandline and body and pipes it to either the mail or the mailx program.

Test::Smoke::Mailer::Mail_Sendmail

This handles sending the message using the Mail::Sendmail module.
Test::Smoke::Mailer::Mail_Sendmail->new( %args )
Keys for %args:
   * ddir
   * mserver
   * to
   * from
   * cc
   * v
 
 
$mailer->mail( )
"mail()" sets up the message to be send by Mail::Sendmail.

Test::Smoke::Mailer::MIME_Lite

This handles sending the message using the MIME::Lite module.
Test::Smoke::Mailer::MIME_Lite->new( %args )
Keys for %args:
   * ddir
   * mserver
   * to
   * from
   * cc
   * v
 
 
$mailer->mail( )
"mail()" sets up the message to be send by MIME::Lite.
(c) 2002-2003, All rights reserved.
   * Abe Timmerman <abeltje@cpan.org>
 
 

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

See:

   * <http://www.perl.com/perl/misc/Artistic.html>,
   * <http://www.gnu.org/copyleft/gpl.html>
 
 

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.