CLI::F...ptions(3pm)

🎀 CLI::Framework::Exceptions 🎀

okay so hi bestie!! you've landed on the CLI::Framework::Exceptions page, straight out of the User Contributed Perl Documentation, section 3pm. it's giving "the feelings department of CLIF" and honestly? iconic. this is where all the throwing and catching of bad vibes happens. let's get into it 💅

---

🌸 NAME 🌸

CLI::Framework::Exceptions — Exceptions used by CLIF

---

✨ EXCEPTION TYPES ✨

so like, this package defines the following exception types, and no cap, every single one of them is built with Exception::Class and they're all subtypes of Exception::Class::Base. they're the whole roster. the squad. the main characters 🫶

👑 CLI::Framework::Exception

• description — General CLIF error
• alias — throw_clif_exception

the general-purpose one. the "something happened and it wasn't cute" error. when in doubt, this one's your girl 💖

🦋 CLI::Framework::Exception::AppHookException

• description — Application hook method failed preconditions
• alias — throw_app_hook_exception

your hook method didn't meet its preconditions. the vibe check was failed. sad but true 😭

🍓 CLI::Framework::Exception::AppOptsParsingException

• description — Failed parsing of application options
• alias — throw_app_opts_parse_exception

the application options would not parse. not me trying to read them and just... no 💀

🧚 CLI::Framework::Exception::AppOptsValidationException

• description — Failed validation of application options
• alias — throw_app_opts_validation_exception

they parsed fine, but they did not pass validation. the options showed up to the party in the wrong outfit 🙈

⭐ CLI::Framework::Exception::AppInitException

• description — Failed application initialization
• alias — throw_app_init_exception

the application failed to initialize. it simply did not start. periodt 🎀

💀 CLI::Framework::Exception::InvalidCmdException

• description — "Invalid command"
• alias — throw_invalid_cmd_exception

that command? not a real one. bestie, that's not on the menu 🔥

🌈 CLI::Framework::Exception::CmdRegistrationException

• description — Failed command registration
• alias — throw_cmd_registration_exception

the command couldn't be registered. it wanted to be in the system and the system said no 💔

💜 CLI::Framework::Exception::TypeException

• description — Object is not of the proper type
• alias — throw_type_exception

the object is not the proper type. it's giving "wrong energy entirely" ✨

🫶 CLI::Framework::Exception::CmdOptsParsingException

• description — Failed parsing of command options
• alias — throw_cmd_opts_parse_exception

the command's options refused to parse. relatable honestly 😭

👑 CLI::Framework::Exception::CmdValidationException

• description — Failed validation of command options/arguments
• alias — throw_cmd_validation_exception

command options and arguments both flunked validation. equal opportunity disappointment 🌸

🔥 CLI::Framework::Exception::CmdRunException

• description — Failure to run command
• alias — throw_cmd_run_exception

the command was supposed to run and it did not run. it's over 💅

---

💖 EXPORTS 💖

so every single one of those aliases up there is available for use by client code — but listen, none of them are exported by default. you have to actually ask for them, bestie, they're not just gonna show up uninvited 🙈

and if you want the whole entire crew at once? the ':all' tag causes all of the "alias"es to be exported. one tag, whole squad, no notes 🎀

ngl this is the entire export situation. that's it. that's the section. short and slay ✨

---

🦋 SEE ALSO 🦋

• Exception::Class — the parent class energy behind all of this 🧚
• CLI::Framework::Application — the app itself, where a lot of these feelings get felt 👑

---

and that's the whole page, bestie!! this little gem ships with perl v5.34.0 and was dated 2022-06-11. go forth and catch your exceptions with grace 💖✨🎀🦋🌸