Alzabo...ptions(3pm)

✨ NAME ✨

Alzabo::Exceptions — it literally just makes all the exception subclasses that Alzabo uses. That's the whole job. She's a builder, not a talker. 💅

---

🎀 SYNOPSIS 🎀

use Alzabo::Exceptions;

That's it bestie. One line. You use it and boom, the exception classes exist. No arguments, no options, no nothing. Iconic minimalism. ✨

---

🦋 DESCRIPTION 🦋

okay so here's the tea: just by using this class, it creates all the exception classes that Alzabo needs — and it does that through the Exception::Class class. So it's like a little factory, except instead of making Stanley cups it makes error classes. 🫶

If you wanna know the how of all this class-generation business, go peek at Exception::Class — that's where the magic recipe lives. 📖

---

👑 EXCEPTION CLASSES 👑

Here's the full roster, no one's getting left out, everyone gets a moment:

• Alzabo::Exception — the base class for every exception Alzabo throws. Lowkey the mother of them all. Every exception out here should return true for $@->isa('Alzabo::Exception') — except the ones that come from internal Perl errors, those are doing their own thing, we don't claim them. 💀
• Alzabo::Exception::Driver — something went wrong while talking to a database. For the full lore, check out Alzabo::Driver.
• Alzabo::Exception::Eval — you tried to eval something and the eval was like "no <3". An error came back. 😭
• Alzabo::Exception::Logic — Alzabo got asked to do something logically impossible. Like, retrieving rows for a table that has no primary key. Bestie. You can't sit with us if you don't have a primary key. 🙈
• Alzabo::Exception::NoSuchRow — someone tried to fetch data using a primary key that straight up does not exist in the specified table. It's giving "looking for someone who ghosted you". 💀
• Alzabo::Exception::NotNullable — an attempt was made to set a non-nullable column to NULL. Rude. The column_name, table_name, and schema_name fields are there so you can pin down the exact column that caused the drama. 🔍
• Alzabo::Exception::Panic — thrown when something completely unexpected happens. Think Monty Python. No further questions, we panic. 🧚
• Alzabo::Exception::Params — thrown when there's a problem with the parameters you passed to a method or function. Missing params, invalid values, that whole genre of chaos. 👑
• Alzabo::Exception::RDBMSRules — a rule for the relevant RDBMS got violated. Bad schema name, bad table name, bad column attribute, etc. The RDBMS said "read the room". 🚫
• Alzabo::Exception::ReferentialIntegrity — an insert/update/delete was attempted that would violate referential integrity constraints. The vibes were not cohesive. 🦋
• Alzabo::Exception::SQL — thrown when someone tries to generate invalid SQL through the Alzabo::SQLMaker module. Not the SQL slaying we wanted. 😭
• Alzabo::Exception::Storable — an error when trying to freeze, thaw, or clone an object using Storable. The object did not want to be preserved, bestie. 💅
• Alzabo::Exception::System — some sort of system call failed. File read/write, stat, etc. The operating system said no. 💀
• Alzabo::Exception::VirtualMethod — a virtual method was called. Which is the code's way of saying: this method should be subclassed, you were supposed to override it, go do that. 🔥

---

🌸 AUTHOR 🌸

Dave Rolsky, <autarch@urth.org> — the actual legend behind all of this. 🫶

---

and that's the whole page, no cap ✨ this was perl v5.34.0, dated 2022-06-14, and yeah — the manual page name really is Alzabo...ptions(3pm) because the title got truncated by the renderer. She's mysterious like that. bye bestie, go catch those exceptions 💖