Poppy(3p)

NAME
Poppy - General Purpose POP3/IMAP/SMTP Class

NOTE
This module is experimental. Details of its interface are likely to change in the future.

SYNOPSIS
    use Poppy;

    # Constructor
    $poppy = Poppy->connect(user_name => "pop3_user_name",
                            user_pass => "password",
                            server_name => "pop3_server_name",
                            server_proto => "pop3"
                            debug => 1);

    FIXME: Should use some other methods

DESCRIPTION
FIXME:

CONSTRUCTOR

$poppy = Poppy->connect(%options)
    describe

METHODS
Unless otherwise stated all methods return either a true or false value, with false meaning that the operation failed. When a method stats that it returns a value, failure will be returned as undef or an empty list.

$poppy->debug([$value])
$poppy->is_pop3
$poppy->is_imap
$poppy->stats
$poppy->delete($msg_num)
$poppy->msg_size($msg_num)
$poppy->abort_read
$poppy->last_header_num
$poppy->header($msg_num)
$poppy->get_header($search_pattern, [@msg_header])
    FIXME: Add in predefined search patterns

$poppy->message($msg_num, [*FH])
$poppy->message_mbox($msg_num, [*FH])
$poppy->body($msg_num, [*FH])
$poppy->abort
$poppy->disconnect
$poppy->connect_smtp(%options)
$poppy->reply([@msg_header])
$poppy->send_header(@msg_header)
$poppy->send_file([*FH])
$poppy->send_str($msg_str)
$poppy->disconnect_smtp

AUTHOR
Chris Bagwell <chris@cnpbagwell.com>

COPYRIGHT and DISCLAIMER
This program is Copyright 2002 by Chris Bagwell. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of either: a) the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or b) the "Artistic License" which comes with Perl.

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. See either the GNU General Public License or the Artistic License for more details.

POD ERRORS
Hey! The above document had some coding errors, which are explained below:

Around line 1045:
    You forgot a '=back' before '=head1'