WWW::M...ptions(3pm)

✨ WWW::Mediawiki::Client::Exception 💖

okay so bestie, welcome to the exception-handling page for WWW::Mediawiki::Client — from the User Contributed Perl Documentation collection, no less. This is the drama-central page where all the "something went wrong" classes live. 🫶

---

🌸 NAME 🌸

WWW::Mediawiki::Client::Exception — exception handling for WWW::Mediawiki::Client, fr fr. It's giving "everything that can go wrong, and the little class names we give it." 💅

---

🎀 SYNOPSIS 🎀

Here's the whole vibe, verbatim, no edits, periodt:

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);
}

so you throw inside an eval, and then you catch by vibe-checking $@ with UNIVERSAL::isa. iconic behaviour honestly. ✨

---

🦋 DESCRIPTION 🦋

It's the base class for WWW::Mediawiki::Client exceptions. That's the whole description. Short. Sweet. Main character energy. 👑

---

🌈 SUBCLASSES 🌈

buckle up bestie, there's a lot of them and honestly every single one is valid 😭

💜 WWW::Mediawiki::Client::URLConstructionException

Indicates a problem with the URL with which we to the Mediawiki server. (yes that sentence is shaped like that, we're relaying it exactly, don't @ me 💀)

💜 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.

ngl bestie, those last two have the exact same description in the original. We are not fixing it. We are not merging them. We are reporting it with love. 🫶

💜 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. rude. 🚫

---

🔥 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.

---

okay that's the whole page bestie, you ate it, go forth and catch your exceptions responsibly 💖✨🎀🦋

this lil gem shipped with perl v5.32.1, dated 2021-12-26 — slay. 🌟