NAME
   WWW::Hotmail - Connect to Hotmail, download, delete and send messages

SYNOPSIS
     use WWW::Hotmail;

     my $hotmail = WWW::Hotmail->new();

     $hotmail->login('[email protected]', "bar")
      or die $WWW::Hotmail::errstr;

     my @msgs = $hotmail->messages();
     die $WWW::Hotmail::errstr if ($!);

     print "You have ".scalar(@msgs)." messages\n";

     for (@msgs) {
           print "messge from ".$_->from."\n";
           # retrieve the message from hotmail
           my $mail = $_->retrieve;
           # deliver it locally
           $mail->accept;
           # forward the message
           $mail->resend('[email protected]');
           # delete it from the inbox
           $_->delete;
     }

     $hotmail->compose(
       to      => ['[email protected]','[email protected]'],
       subject => 'Hello Person!',
       body    => q[Dear Person,

     I am writing today to tell you about something important.

     Thanks for all your support.

     Sincerely,
     Other Person
     ]) or die $WWW::Hotmail::errstr;

DESCRIPTION
   This module is a partial replacement for the "gotmail" script
   (http://ssl.usu.edu/paul/gotmail/), so if this doesn't do what you want,
   try that instead.

   Create a new "WWW::Hotmail" object with "new", and then log in with your
   MSN username and password with the "login" method.

METHODS
 login
   Make sure to add the domain to your username, for example
   [email protected]. Then this will allow you to use the "messages" method
   to look at the mail in your inbox. The login method does not retrieve
   messages on login. The messages method does that now.

 messages
   This method returns a list of "WWW::Hotmail::Message"s; each message
   supports four methods: "subject" gives you the subject of the email,
   just because it was stunningly easy to implement. "retrieve" retrieves
   an email into a "Mail::Audit" object - see Mail::Audit for more details.
   "from" gives you the from field. Finally "delete" moves it to your
   trash.

 compose
   You can use the "compose" message to send a message through the account
   you are currently logged in to. You should be able to use this method as
   many times and as often as you like during the life of the
   "WWW::Hotmail" object. As its argument, it takes a hash whose keys are
   "to", "cc", "bcc", "subject", "body". Newlines should work fine in the
   "body" argument. Any field can be an array; it will be joined with a
   comma. This function returns 1 on success and undef on failure. Check
   $WWW::Hotmail::errstr for errors, or use $WWW::Hotmail::errhtml for an
   html version of the error.

NOTES
   This module used to croak errors for you. If you would like this
   behavior, then add $WWW::Hotmail::croak_on_error = 1; to your script. It
   will not croak html.

   This module should work with email addresses at charter.com, compaq.net,
   hotmail.com, msn.com, passport.com, and webtv.net

   This module is reasonably fragile. It seems to work, but I haven't
   tested edge cases. If it breaks, you get to keep both pieces. I hope to
   improve it in the future, but this is enough for release.

SEE ALSO
   WWW::Mechanize, Mail::Audit, "gotmail"

AUTHOR
   David Davis, <[email protected]> - I've taken ownership of this module,
   please direct all questions to me.

ORIGINAL AUTHOR
   Simon Cozens, <[email protected]>

CONTRIBUTIONS
   David M. Bradford <[email protected]> - Added the ability to send
   messages via hotmail.

COPYRIGHT AND LICENSE
   Copyright 2003-2004 by Kasei Copyright 2004 by David Davis

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