NAME

       WWW::Mediawiki::Client::Exception - exception handling for WWW::Mediawiki::Client

SYNOPSIS

         use WWW::Mediawiki::Client::Exception;
         use Data::Dumper;

         # throw
         eval {
             WWW::Mediawiki::Client::LoginException->throw(
                     error      => 'Something bad happened',
                     res        => $res,
                     cookie_jar => $cookie_jar,
                 );
         };

         # catch
         if (UNIVERSAL::isa($@, 'WWW::Mediawiki::Client::LoginException') {
             print STDERR $@->error;
             print Dumper($@->res);
         }

DESCRIPTION

       A base class for WWW::Mediawiki::Client exceptions.

SUBCLASSES

   WWW::Mediawiki::Client::URLConstructionException
       Indicates a problem with the URL with which we to the Mediawiki server.

   WWW::Mediawiki::Client::AuthException
       Indicates a problem with the provided authentication information

   WWW::Mediawiki::Client::LoginException
       Indicates that login failed for an unknown reason

       Fields:

       res For the apache response object returned by the attempt to log in.

       cookie_jar
           For the cookie jar which was returned by the attempt to log in.

   WWW::Mediawiki::Client::CookieJarException
       Something went wrong saving or loading the cookie jar

   WWW::Mediawiki::Client::FileAccessException
       Something went wrong saving or loading a file

   WWW::Mediawiki::Client::FileTypeException
       The file which we attempted to operate on is not a .wiki file

   WWW::Mediawiki::Client::AbsoluteFileNameException
       The file which we attempted to operate on is not a .wiki file

   WWW::Mediawiki::Client::CommitMessageException
       There is a problem with the commit message

   WWW::Mediawiki::Client::CommitException
       Something went wrong while committing a change

   WWW::Mediawiki::Client::PageDoesNotExistException
       There is no such page, either here or on the server

   WWW::Mediawiki::Client::UpdateNeededException
       The page on the server has changed since the local file was last updated

   WWW::Mediawiki::Client::ConflictsPresentException
       An attempt was made to commit a file containing conflicts

   WWW::Mediawiki::Client::CorruptedConfigFileException
       The configuration file cannot be parsed.

   WWW::Mediawiki::Client::ServerPageException
       Something went wrong fetching the server page.

       Throws:

       res The apache response object which was returned in the attempt to fetch the page.

   WWW::Mediawiki::Client::ReadOnlyFieldException
       Client code tried to set a read-only field.

SEE ALSO

       Exception::Class

AUTHORS

       Mark Jaroski <mark@geekhive.net>
           Author

       Bernhard Kaindl <bkaindl@ffii.org>
           Inspired the improvement in error handling and reporting.

LICENSE

       Copyright (c) 2004 Mark Jaroski.

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