Cataly...Engine(3pm)

📦
version 0.16 · 4 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Cataly...Engine(3pm) — the ACL brain cell 💖

ok so bestie, welcome to Catalyst::Plugin::Authorization::ACL::Engine 🧚 — the backend that computes ACL checks for Catalyst::Plugin::Authorization::ACL. yes that's a long name, we're gonna say it a lot, hydrate first 💅

✨ SYNOPSIS ✨

# internal

that's it. that's the synopsis. it's internal, bestie, it's not for us 🙈

🌸 METHODS 🌸

  • new $app — spins up a fresh new rule engine for $app. baby engine's first day on the job 🎀
  • add_allow $cond — adds an allow condition, fr fr
  • add_deny $cond — adds a deny condition. we do a lil fudge on $cond, turn that cond into a proper rule, and then hand it off to add_rule ✨
  • add_rule $path, $rule — drops $rule onto every single action sitting under $path. all of them. every last one 🫶
  • append_rule_to_action $action, $index, $rule, $cxt — appends $rule to $action in slot $index, and stores the context info $cxt so we can do error reporting later. very "keeping receipts" of it 💀
  • check_action_rules $action — evaluates the rules for an action. this is the vibe check. the main character moment 👑
  • fudge_condition $thingy — converts a $thingy into a subref, for that DWIM goodness ✨ peep the main ACL docs for the full tea ☕
  • get_action_data $action — getter behaviour for $action data
  • get_cxt_for_rule $rule — getter behaviour for the $cxt of a $rule
  • get_rules — getter behaviour, and it gets the rules. iconic.

🦋 DESCRIPTION 🦋

this is the engine. it's the thing that actually executes the access control checks for Catalyst::Plugin::Authorization::ACL. it's giving backstage crew at the award show — vital, unglamorous, absolutely not the one you talk to directly. so please use that module directly instead, bestie, i'm begging 🙏

🌈 TODO 🌈

  • external uris -> private paths

(we'll get to it. someday. no cap.)

💜 remi: this page is internal-API territory, so if you're poking at it directly you're either extremely brave or extremely deep in the source. either way, slay.

sign-off time, bestie 🎀 this lil doc came from the User Contributed Perl Documentation collection, generated for perl v5.34.0, dated 2022-06-09. mwah. take care of her 💖✨🌸🦋

📦 where this page comes from