Cataly...equest(3pm)

💖 NAME 💖

Catalyst::Plugin::SubRequest — make subrequests to actions in Catalyst, bestie 🦋

(also known as that Cataly...equest(3pm) page from the User Contributed Perl Documentation, iykyk)

---

✨ SYNOPSIS ✨

use Catalyst 'SubRequest';

my $res_body = $c->subreq('/test/foo/bar', { template => 'magic.tt' });

my $res_body = $c->subreq( {
   path            => '/test/foo/bar',
   body            => $body
}, {
   template        => 'magic.tt'
});

# Get the full response object
my $res = $c->subreq_res('/test/foo/bar', {
    template => 'mailz.tt'
}, {
    param1   => 23
});
$c->log->warn( $res->content_type );

---

🌸 DESCRIPTION 🌸

Okay so, you can make subrequests to actions in Catalyst. That's the whole vibe. 💅

It uses the catalyst dispatcher, so it works like an external url call — no cap. Methods are provided both to get the body of the response and the full response (Catalyst::Response) object. So like, pick your fighter: just the body, or the whole entire response. 👑

---

🎀 METHODS 🎀

subreq [path as string or hash ref], [stash as hash ref], [parameters as hash ref]

subrequest

sub_request

Takes a full path to a path you'd like to dispatch to. ✨

If the path is passed as a hash ref then it can include body, action, match and path.

An optional second argument as hashref can contain data to put into the stash of the subrequest. 🫶

An optional third argument as hashref can contain data to pass as parameters to the subrequest.

Returns the body of the response. That's it, that's the tea. 🍓

subreq_res [path as string or hash ref], [stash as hash ref], [parameters as hash ref]

subrequest_response

sub_request_response

Like sub_request(), but returns a full Catalyst::Response object. It's giving main character energy, but make it a whole object instead of just the body. 🔥

---

💜 SEE ALSO 💜

• Catalyst.

---

👑 AUTHORS 👑

• Marcus Ramberg, "mramberg@cpan.org"
• Tomas Doran (t0m) "bobtfish@bobtfish.net"

---

🌈 MAINTAINERS 🌈

• Eden Cardim (edenc) "eden@insoli.de"

---

🧚 THANK YOU 🧚

• SRI, for writing the awesome Catalyst framework ⭐
• MIYAGAWA, for writing the awesome Plack toolkit ⭐

---

💖 COPYRIGHT 💖

Copyright (c) 2005 - 2011 the Catalyst::Plugin::SubRequest "AUTHORS" as listed above.

---

🦋 LICENSE 🦋

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself. slay, honestly 💅

---

okay that's the whole page bestie, every single flag-free fact intact, not a crumb left behind 🙈

this was perl v5.34.0, dated 2022-06-09, and yes it really does call itself Cataly...equest(3pm) in the corner like that — iconic abbreviation behaviour, we love to see it 💜