Wallet...:Nested(3pm)

📦 version 1.7, in debian trixie, ubuntu resolute, ubuntu stonking

✨ Wallet::ACL::Nested ✨

okay bestie, so this is the manual page for Wallet::ACL::Nested — a Perl module doc from the User Contributed Perl Documentation collection, Wallet...:Nested(3pm) if you're being formal about it 💅

It's the Wallet ACL verifier to check another ACL. Yes, ACLs checking ACLs. It's giving inception. 🌀

🎀 SYNOPSIS 🎀

like, here's the vibe in code form:

my $verifier = Wallet::ACL::Nested->new;
my $status = $verifier->check ($principal, $acl);
if (not defined $status) {
    die "Something failed: ", $verifier->error, "\n";
} elsif ($status) {
    print "Access granted\n";
} else {
    print "Access denied\n";
}

look at that flow. immaculate. no notes. ✨

💖 DESCRIPTION 💖

Wallet::ACL::Nested checks whether the principal is permitted by another named ACL and, if so, returns success. That's it, that's the whole job. It's literally the module you use to nest one ACL inside another — ACL-ception, if you will. 🫶

🌸 METHODS 🌸

new()

Creates a new ACL verifier. Fresh verifier, fresh start, main character energy 👑

check(PRINCIPAL, ACL)

Returns true if PRINCIPAL is granted access according to the nested ACL, specified by name. Returns false if it is not, and undef on error.

so like: yes / no / uh-oh 😭

error([ERROR ...])

Returns the error of the last failing operation, or undef if no operations have failed.

🚨 real talk: callers should call this function to get the error message after an undef return from any other instance method. Don't skip it, bestie.

ngl, the returned errors will generally come from the nested child ACL — so the drama is inherited, not original to this module 💀

🦋 SEE ALSO 🦋

This module is part of the wallet system. The current version is available from <https://www.eyrie.org/~eagle/software/wallet/>. 🧚

👑 AUTHOR 👑

Jon Robertson <jonrober@stanford.edu>

and that's the whole page, periodt. 💅 this icon was documented under perl v5.40.0, dated 2024-11-12 — so if you're reading this later, check the version, iykyk. 🌈⭐🍓

📦 where this page comes from