view release on metacpan or  search on metacpan

README  view on Meta::CPAN

Mail::IMAPClient
================
Mail::IMAPClient is a Perl module that provides an interface for
communicating with an IMAP server as an IMAP client.

DEPENDENCIES
============
The following are the minimum requirements for using Mail::IMAPClient:

- Perl 5.8
    https://www.perl.org/
- Perl modules from CPAN:
    https://metacpan.org/
      Required:
        List::Util
        MIME::Base64
        Parse::RecDescent
      Optional:
        Authen::NTLM
        Authen::SASL
        Compress::Zlib
        Digest::HMAC_MD5
        Digest::MD5
        IO::Socket::SSL
- RFC 3501 (IMAP4REV1) compatible IMAP server
    https://tools.ietf.org/html/rfc3501
- Mail::IMAPClient (this package)

INSTALLATION
============
1. Download Mail::IMAPClient module
    https://metacpan.org/release/Mail-IMAPClient

2. Read this README

3. This module has a number of dependencies on other Perl modules
   available from CPAN.  If any modules are missing, appropriate
   warnings will be generated in the following step.

4. Prepare to build this module and install any prerequisite modules:

    perl Makefile.PL

5. (OPTIONAL) For extended tests during 'make test', create a file
   'test.txt' in the top level directory of this distribution (the
   same directory as the Makefile.PL, etc.).  This file must contain
   an IMAP server name or IP (server=...), a user account (user=...),
   and password a (passed=...).  A port (port=....) and an
   authentication mechanism to be used (authmechanism=...) can also be
   specified.

Example:

--- BEGIN: test.txt ---
server=localhost
user=mytestuser
passed=mypassword
port=143
--- END: test.txt ---

   NOTE: When testing is completed, be sure to remove test.txt (either
   by hand or by 'make clean').

6. Build, test and install this module:

    make
    make test
    (sudo) make install

7. Read the documentation to become familiar with this module.

Project Links
=============
- Bugs/tickets:
    https://github.com/plobbes/mail-imapclient/issues
- Source code repository (git):
    https://github.com/plobbes/mail-imapclient/
    https://sourceforge.net/p/mail-imapclient/git/
- CPAN releases:
    https://metacpan.org/release/Mail-IMAPClient

TESTING
=======
Ubuntu under WSL 2.0