Cataly...Context(3pm)

💖 Cataly...Context(3pm) 💖

okay so bestie, welcome to Catalyst::Component::InstancePerContext — the Perl module that gives you a brand new instance of a component on each and every request. yes, every single one. it's giving ✨fresh vibes only✨.

---

🌸 NAME 🌸

Catalyst::Component::InstancePerContext — returns a new instance a component on each request 🦋

---

✨ SYNOPSYS ✨

package MyComponent;
use Moose;
with 'Catalyst::Component::InstancePerContext';

sub build_per_context_instance{
    my ($self, $c) = @_;
    # ... do your thing here
    return SomeModule->new(%args);
}

---

🎀 REQUIRED METHODS 🎀

so like, your consuming class has to implement this next one. no skipping, no shortcuts, it's mandatory bestie 💅

🧚 build_per_context_instance

whatever this call hands back? that's literally what you get when you call $c->component('YourComponent'). that's the whole deal. that's the assignment 🫶

---

👑 PROVIDED METHODS 👑

this role is gonna slide one extra method into your consuming class. consider it a gift 🎁

🌈 ACCEPT_CONTEXT

here's the tea ☕ — if the context is not blessed, it just simply passes through the value of "build_per_context_instance". no drama, no fuss, straight through.

but if the context is blessed? then it goes looking in the "stash" for an instance of the requested component and returns that. and if that value isn't found? then whatever "build_per_context_instance" returned gets stored, and then returned. so it's cached in the stash for the rest of the request, iykyk 😌

the idea behind this whole behaviour is that a component can be built on a per-request basis — which is, like, literally what the name of this module is saying. it said it in the name. the name is the point. periodt 💀

---

🔥 SEE ALSO 🔥

• Moose
• Moose::Role
• Catalyst::Component

---

💜 AUTHOR 💜

Guillermo Roditi (groditi) <groditi@cpan.org> — icon, legend, the moment 👑

---

📜 LICENSE 📜

you may distribute this code under the same terms as Perl itself. slay, go forth, distribute responsibly 🎀

---

perl v5.34.0 🌸 2022-06-09 — that's the version and the date bestie, and that's a wrap on Cataly...Context(3pm). mwah 💋🦋✨