---
name: "Sub::HandlesVia"
section: "3pm"
platform: "linux"
package: "perl-sub-handlesvia"
version: "0.053005-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Sub::HandlesVia"
---

# Sub::HandlesVia(3pm)

alternative handles\_via implementation

## NAME

Sub::HandlesVia - alternative handles\_via implementation

## SYNOPSIS

```
 package Kitchen {
   use Moo;
   use Sub::HandlesVia;
   use Types::Standard qw( ArrayRef Str );

   has food => (
     is          => 'ro',
     isa         => ArrayRef[Str],
     handles_via => 'Array',
     default     => sub { [] },
     handles     => {
       'add_food'    => 'push',
       'find_food'   => 'grep',
     },
   );
 }
 my $kitchen = Kitchen->new;
 $kitchen->add_food('Bacon');
 $kitchen->add_food('Eggs');
 $kitchen->add_food('Sausages');
 $kitchen->add_food('Beans');

 my @foods = $kitchen->find_food(sub { /^B/i });
```

## DESCRIPTION

If you've used Moose's native attribute traits, or MooX::HandlesVia before, you should have a fairly good idea what this does.

Why re-invent the wheel? Well, this is an implementation that should work okay with Moo, Moose, Mouse, and any other OO toolkit you throw at it. One ring to rule them all, so to speak.

For details of how to use it, see the manual.

- Sub::HandlesVia::Manual::WithMoo

  How to use Sub::HandlesVia with Moo and Moo::Role.

- Sub::HandlesVia::Manual::WithMoose

  How to use Sub::HandlesVia with Moose and Moose::Role.

- Sub::HandlesVia::Manual::WithMouse

  How to use Sub::HandlesVia with Mouse and Mouse::Role.

- Sub::HandlesVia::Manual::WithMite

  How to use Sub::HandlesVia with Mite.

- Sub::HandlesVia::Manual::WithClassTiny

  How to use Sub::HandlesVia with Class::Tiny.

- Sub::HandlesVia::Manual::WithObjectPad

  How to use Sub::HandlesVia with Object::Pad classes.

- Sub::HandlesVia::Manual::WithGeneric

  How to use Sub::HandlesVia with other OO toolkits, and hand-written Perl classes.

Note: as Sub::HandlesVia needs to detect which toolkit you are using, and often needs to detect whether your package is a class or a role, it needs to be loaded *after* Moo/Moose/Mouse/etc. Your `"use Moo"` or `"use Moose::Role"` or whatever needs to be *before* your `"use Sub::HandlesVia"`.

## BUGS

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

(There are known bugs for Moose native types that do coercion.)

## SEE ALSO

Guides for use with different OO toolkits: Sub::HandlesVia::Manual::WithMoo, Sub::HandlesVia::Manual::WithMoose, Sub::HandlesVia::Manual::WithMouse, Sub::HandlesVia::Manual::WithMite, Sub::HandlesVia::Manual::WithClassTiny, Sub::HandlesVia::Manual::WithObjectPad, Sub::HandlesVia::Manual::WithGeneric.

Documentation for delegatable methods: Sub::HandlesVia::HandlerLibrary::Array, Sub::HandlesVia::HandlerLibrary::Blessed, Sub::HandlesVia::HandlerLibrary::Bool, Sub::HandlesVia::HandlerLibrary::Code, Sub::HandlesVia::HandlerLibrary::Counter, Sub::HandlesVia::HandlerLibrary::Enum, Sub::HandlesVia::HandlerLibrary::Hash, Sub::HandlesVia::HandlerLibrary::Number, Sub::HandlesVia::HandlerLibrary::Scalar, and Sub::HandlesVia::HandlerLibrary::String.

Other implementations of the same concept: Moose::Meta::Attribute::Native, MouseX::NativeTraits, and MooX::HandlesVia with Data::Perl.

Comparison of those: Sub::HandlesVia::Manual::Comparison

Sub::HandlesVia::Declare is a helper for declaring Sub::HandlesVia delegations at compile-time, useful for Object::Pad and (to a lesser extent) Class::Tiny.

## AUTHOR

Toby Inkster \<tobyink@cpan.org\>.

## COPYRIGHT AND LICENCE

This software is copyright (c) 2020, 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.