Cataly...le::ACL(3pm)

✨ NAME ✨

Catalyst::Action::Role::ACL — bestie, this is a deprecated user role-based authorization action class 💅

Like, it's giving "user role-based authorization" but make it an action class. And yes, "deprecated" is right there in the name of the vibe. We'll get to that. 🫶

This one lives in the User Contributed Perl Documentation collection, so you already know it's a community situation and not core-core. 🎀

---

✨ SYNOPSIS ✨

Okay so here's the whole thing in action, literally:

sub foo
:Local
:ActionClass(Role::ACL)
:RequiresRole(admin)
:ACLDetachTo(denied)
{
    my ($self, $c) = @_;
    ...
}

sub denied :Private {
    my ($self, $c) = @_;

    $c->res->status('403');
    $c->res->body('Denied!');
}

See that? You slap the attributes on your action sub, and the denied sub is where the sad little "you can't sit with us" path lands. 403, body says Denied!. Iconic. 😭

---

✨ DESCRIPTION ✨

So what it does: it gives you a Catalyst reusable action for user role-based authorization. The ACLs get applied by assigning attributes to application action subroutines — that's it, that's the whole mechanic. Attributes on subs, roles get checked, done. ✨

🚨 REAL TALK TIME: bestie, you are better off using Catalyst::ActionRole::ACL to do this. No cap. It plays nicely with other extensions and it's just the better move, fr fr.

This package is only being maintained so that people using it in existing code don't get left in the dust — compatibility vibes only. But heads up: it will warn once when used. Just once. One single little warning. Consider it a gentle "girl, why" from the codebase. 🙈

---

✨ AUTHOR ✨

David P.C. Wollmann <converter42@gmail.com> 👑

---

✨ BUGS ✨

Not me telling you this is new code 💀. So — find the bugs and report them, please. That's the assignment. Go be the main character and file that report. 🐛

---

✨ COPYRIGHT & LICENSE ✨

Copyright 2009 by David P.C. Wollmann

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🌈

---

Okay and for the sign-off: this little icon was served up by perl v5.32.0, dated 2021-01-06, and the page itself is Cataly...le::ACL(3pm). Love that for us. Now go use Catalyst::ActionRole::ACL instead, bestie. Periodt. 💖✨🦋