logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

Sub::HandlesVia::Manual::WithClassTiny - using Sub::HandlesVia with Class::Tiny

Author

       Toby Inkster <tobyink@cpan.org>.

Bugs

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

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.

perl v5.40.1                                       2025-04-01             Sub::HandlesVia...::WithClassTiny(3pm)

Manual

       Sub::HandlesVia allows you to delegate methods from your class to the values of your objects' attributes.

       Conceptually, it allows you to define "$object->push_number($n)" to be a shortcut for
       "$object->numbers->push($n)" except that "$object->numbers" is an arrayref, so doesn't have methods you
       can call on it like "push".

   WhichMethodsCanBeDelegatedTo?
       The second parameter ("Array" in the synopsis) indicates which library of methods should be available.
       Valid values include Array, Blessed, Bool, Code, Counter, Enum, Hash, Number, Scalar, and String.

       An arrayref can be provided, though many of the options are conceptually contradictory.

        use Sub::HandlesVia::Declare 'num', [ 'Number', 'Scalar' ] => (
          ...,
        );

   Run-TimeDelegation
       Rather than using Sub::HandlesVia::Declare which operates at compile time, you can use the "delegations"
       function at run time. Which you choose is largely down to style and personal preference.

        package Kitchen;

        use Class::Tiny {
          foods  => sub { [] },
          drinks => sub { [ 'water' ] },
        };

        use Sub::HandlesVia qw( delegations );

        delegations(
          attribute    => 'foods',
          handles_via  => 'Array',
          handles      => {
            all_foods    => 'all',
            add_food     => 'push',
          },
        );

        delegations(
          attribute    => 'drinks',
          handles_via  => 'Array',
          handles      => {
            all_drinks   => 'all',
            add_drink    => 'push',
          },
        );

Name

       Sub::HandlesVia::Manual::WithClassTiny - using Sub::HandlesVia with Class::Tiny

See Also

       Misc advanced documentation: Sub::HandlesVia::Manual::Advanced.

       Sub::HandlesVia.

       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.

Synopsis

        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',
        );

return

See Also