NAME

Mail::Abuse::Reader::POP3 - Reads a Mail::Abuse::Report out of a POP3 account

SYNOPSIS

  use Mail::Abuse::Report;
  use Mail::Abuse::Reader::POP3;
  my $r = new Mail::Abuse::Reader::POP3;
  my $report = new Mail::Abuse::Report (reader => $r);

DESCRIPTION

This class reads in each message in a POP3 mailbox into the text of a Mail::Abuse::Report object.

A number of configuration keys are used for establishing the operational parameters. These config keys are described below:

pop3 server

Must be set to the name or address of the POP3 server where reports are to be fetched from.

pop3 username

The username used for the POP3 session.

pop3 password

The corresponding password.

pop3 delete

Set to a true value to cause messages to be deleted after reading them.

pop3 filter

A regular expression that, if matches, discards the current message. This is useful to avoid processing bounces.

pop3 debug

If set to a true value, debug messages will be sent through warn().

The following methods are implemented within this class.

read($report)

Populates the text of the given $report using the ->text method. Must return true if succesful or false otherwise.

DESTROY

In order to effectively delete any messages, this method terminates gracefully the POP3 session using the ->quit method of Net::POP3.

EXPORT

None by default.

HISTORY

0.01

Original version; created by h2xs 1.2 with options

  -ACOXcfkn
        Mail::Abuse
        -v
        0.01

LICENSE AND WARRANTY

This code and all accompanying software comes with NO WARRANTY. You use it at your own risk.

This code and all accompanying software can be used freely under the same terms as Perl itself.

AUTHOR

Luis E. Muñoz <luismunoz@cpan.org>

SEE ALSO

perl(1).