/ 
Test-Reporter-1.51_02
River stage two • 17 direct dependents • 33 total dependents
/ Test::Reporter::Transport

NAME

Test::Reporter::Transport - base class for Test::Reporter transports

SYNOPSIS

# Defines API that must be implemented by subclasses

my $sender = Test::Reporter::Transport::Subclass->new( @args );

$sender->send( $report )

DESCRIPTION

Transport subclasses provide the means by which CPAN Testers reports are transmitted to the CPAN Testers mailing list.

This module is an abstract base class that define an API for Test::Reporter::Transport subclasses. Individual subclasses MUST implement the methods described below.

USAGE

A transport method is specified to Test::Reporter using the transport option. The transport option expects just the module "suffix" that follows Test::Reporter::Transport. For example:

# use Test::Reporter::Transport::Net::SMTP for transport
my $report = Test::Reporter->new(
    transport => 'Net::SMTP'
);

# use Test::Reporter::Transport::Mail::Send for transport
my $report = Test::Reporter->new(
    transport => 'Mail::Send'
);

Configuration of the transport is specified with the transport_args option:

my $report = Test::Reporter->new(
    transport => 'Net::SMTP::TLS',
    transport_args => [ User => 'John', Password => '123' ],
);

These may also be specified with the transport or transport_args methods:

$report->transport_args( User => 'John', Password => '123' );

These may also be combined in the transport method itself:

$report->transport( 'Net::SMTP::TLS', User => 'John', Password => '123');

METHODS

The terms 'may', 'must', 'should', etc. used below have their usual RFC meanings.

new

my $sender = $subclass->new( @args );

The new method is the object constructor. It MAY take a list of any necessary configuration options. It MUST return a transport object if one is successfully created or undef if the object can not be created.

send

$sender->send( $report );

The send method MUST take a Test::Reporter object as its only argument. It MUST return true if the report is successfully sent. It SHOULD die with a message describing the failure if a report cannot be sent. It MUST NOT return a true value if the report cannot be sent.

AUTHOR

  • David A. Golden (DAGOLDEN)

  • Ricardo Signes (RJBS)

COPYRIGHT

Copyright (C) 2008 David A. Golden
Copyright (C) 2008 Ricardo Signes

All rights reserved.

LICENSE

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