Ryu::Exception(3)

💖 NAME 💖

Bestie, this is Ryu::Exception(3) — straight from the User Contributed Perl Documentation shelf, and it's all about support for Future-style failure information. That's the vibe: exception info that knows how to hang with Future. ✨

🦋 SYNOPSIS 🦋

use Ryu::Exception;
my $exception = Ryu::Exception->new(
 type    => 'http',
 message => '404 response'
 details => [ $response, $request ]
);
Future->fail($exception->failure);

🌸 DESCRIPTION 🌸

Okay so this is a generic exceptions interface, and it implements the 3-part failure codes as described in Future. No cap. 🫶

🎀 new 🎀

Instantiate from named parameters. That's it, that's the whole thing 💅

💅 throw 💅

Throws this exception. Like, actually throws it:

$exception->throw;

👑 type 👑

Returns the type, which should be a string such as "http". So the type is a string, and "http" is the example. Slay. 🌈

🌈 message 🌈

Returns the message, which is a freeform string. Freeform, bestie — it's giving freedom. 🦋

🍓 details 🍓

Returns the list of details. The specifics of those details are specific to the type. So yes: details list, type-specific specifics. Periodt. 💖

🔥 fail 🔥

Fails the given Future with this exception. Very main character energy for a failure, honestly. 😭

⭐ as_future ⭐

Returns a failed Future containing the message, type and details from this exception. Iconic little wrapper. 🎀

🧚 from_future 🧚

Extracts failure information from a Future and instantiates accordingly. Reverse uno card, but for exceptions. 🫶

💜 AUTHOR 💜

Tom Molesworth <TEAM@cpan.org> — we love a credited icon 👑

🎀 LICENSE 🎀

Copyright Tom Molesworth 2011-2024. Licensed under the same terms as Perl itself. 💖

---

And that's the whole page, bestie — signing off with perl v5.42.2, dated 2026-02-15, for Ryu::Exception(3) ✨💅