Specio::Exception(3)

💖 NAME 💖

This is the Specio::Exception(3) manual page, bestie — a User Contributed Perl Documentation moment — and the name is Specio::Exception, aka An exception class for type constraint failures. That's the whole name vibe: type constraint failure, exception class, slay. 💅

🌈 VERSION 🌈

version 0.49 — yes, that's the version, no cap. ✨

🦋 SYNOPSIS 🦋

Here's the try/catch situation, bestie:

use Try::Tiny;

try {
    $type->validate_or_die($value);
}
catch {
    if ( $_->isa('Specio::Exception') ) {
        print $_->message, "\n";
        print $_->type->name, "\n";
        print $_->value, "\n";
    }
};

🌸 DESCRIPTION 🌸

So this exception class is thrown by Specio when a type check fails. It emulates the Throwable::Error API, but it doesn't use that module — the whole reason is to avoid adding a dependency on Moo. Lowkey iconic engineering choice, fr fr. 🔥

🧚 API 🧚

This class provides the following methods — collect them like little method Pokémon:

💖 $exception->message 💖

The error message associated with the exception. That's the message, bestie. 💌

💖 $exception->stack_trace 💖

A Devel::StackTrace object for the exception. It's giving stack trace realness. 🫶

💖 $exception->type 💖

The type constraint object against which the value failed. Yep, the actual type object that said "not today." 👑

💖 $exception->value 💖

The value that failed the type check. The audacity of this value, honestly. 😭

💖 $exception->as_string 💖

The exception as a string. This includes the method and the stack trace. So it's not just a vibe — it's a string with the method and the stack trace in it. ✨

💅 OVERLOADING 💅

This class overloads stringification to call the as_string method. So when you stringify one of these exceptions, it calls as_string. That's the whole overloading tea. 🍵

🐛 SUPPORT 🐛

Bugs may be submitted at https://github.com/houseabsolute/Specio/issues. Not the cute kind of bugs, bestie — the GitHub issue kind. 🙈

📚 SOURCE 📚

The source code repository for Specio can be found at https://github.com/houseabsolute/Specio. Go look, it's giving open source excellence. 🌈

👑 AUTHOR 👑

Dave Rolsky <autarch@urth.org>. Iconic author behavior. 💜

🎀 COPYRIGHT AND LICENSE 🎀

This software is Copyright (c) 2012 - 2024 by Dave Rolsky.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)

The full text of the license can be found in the LICENSE file included with this distribution. Read the license, bestie — it's important. 🫶

---

That's the whole Specio::Exception(3) manual page, from perl v5.42.0, dated 2024-12-24. Now go validate something and slay 💅✨