Sub::Ha...Declare(3)

✨ NAME ✨

Sub::HandlesVia::Declare — bestie, it's literally just declaring delegations at compile-time 💅

(and yeah, the manual is filed under User Contributed Perl Documentation, which is why the header goes all mysterious and truncates it to Sub::Ha...Declare(3) — the drama of it all 😭)

---

💖 SYNOPSIS 💖

use Sub::HandlesVia::Declare( $attr, $via => %delegations );

Okay so this is roughly equivalent to the following, no cap:

use Sub::HandlesVia qw(delegations);

BEGIN {
  delegations(
    attribute    => $attr,
    handles_via  => $via,
    handles      => \%delegations,
  );
};

Except — and this is the little glow-up — it doesn't import the delegations function into your namespace. So polite of it. 🎀

---

🌸 DESCRIPTION 🌸

Super useful for Object::Pad, and kind of nice for Class::Tiny. Basically any class builder that does its stuff at compile time. It's giving "works with your fave." ✨

🍓 Object::Pad

use Object::Pad;

class Kitchen {
  has @foods;
  use Sub::HandlesVia::Declare '@foods', Array => (
    all_foods => 'all',
    add_food  => 'push',
  );
}

And here's the cute shortcut: if an attribute begins with a '@' or '%', then $via can be omitted. 🦋

use Object::Pad;

class Kitchen {
  has @foods;
  use Sub::HandlesVia::Declare '@foods', (
    all_foods => 'all',
    add_food  => 'push',
  );
}

🧚 Class::Tiny

package Kitchen;
use Class::Tiny {
  foods  => sub { [] },
  drinks => sub { [ 'water' ] },
};
use Sub::HandlesVia::Declare 'foods', Array => (
  all_foods  => 'all',
  add_food   => 'push',
);
use Sub::HandlesVia::Declare 'drinks', Array => (
  all_drinks => 'all',
  add_drink  => 'push',
);

---

💀 BUGS 💀

Please report any bugs to <https://github.com/tobyink/p5-sub-handlesvia/issues>.

Not me asking you to actually file the issue though — like, please do, for real fr fr 🙈

---

🦋 SEE ALSO 🦋

• Sub::HandlesVia.

---

👑 AUTHOR 👑

Toby Inkster <tobyink@cpan.org>.

---

💖 COPYRIGHT AND LICENCE 💖

This software is copyright (c) 2022 by Toby Inkster.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

---

🔥 DISCLAIMER OF WARRANTIES 🔥

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

(no warranty bestie, you're on your own and that's iconic 💅)

---

Sign-off time 🎀 — this was brought to you by perl v5.42.0, dated 2026-02-11, and filed in the manual as Sub::Ha...Declare(3). Slay, go declare some delegations. 🦋✨