moosex-currieddelegation
文件大小: unknow
源码售价: 5 个金币 积分规则     积分充值
资源说明:Curry your delegations with methods
[![Build Status](https://travis-ci.org/RsrchBoy/moosex-currieddelegation.svg?branch=master)](https://travis-ci.org/RsrchBoy/moosex-currieddelegation)
[![Kwalitee status](http://cpants.cpanauthors.org/dist/MooseX-CurriedDelegation.png)](http://cpants.charsbar.org/dist/overview/MooseX-CurriedDelegation)
[![Coverage Status](https://coveralls.io/repos/RsrchBoy/moosex-currieddelegation/badge.svg?branch=master)](https://coveralls.io/r/RsrchBoy/moosex-currieddelegation?branch=master)

# NAME

MooseX::CurriedDelegation - Curry your delegations with methods

# VERSION

This document describes version 0.003 of MooseX::CurriedDelegation - released November 09, 2016 as part of MooseX-CurriedDelegation.

# SYNOPSIS

    use Moose;
    use MooseX::CurriedDelegation;

    has one => (is => 'ro', isa => 'Str', default => 'default');

    has foo => (

        is      => 'rw',
        isa     => 'TestClass::Delagatee', # has method curried()
        default => sub { TestClass::Delagatee->new },

        handles => {

            # method-curry
            #   Note the hashref, not arrayref, we employ
            #   first arg is the remote method to delegate to
            #   second is an arrayref comprising:
            #       coderef to call as a method on the instance, followed by
            #       "static" curry args
            #
            # so, essentially:
            #   $self->foo->remote_method($self->$coderef(), @remaining_args);
            #
            # foo_del_one => {
            #   remote_method => [ sub { ... }, qw{ static args } ],
            # },

            foo_del_one => { curried => [ sub { shift->one }, qw{ more curry args } ] },

            # curry_to_self() always returns: sub { shift }
            foo_del_two => { other_method => [ curry_to_self ] },
        },
    );

# DESCRIPTION

Method delegation is awfully handy -- but sometimes it'd be awfully handier if
it was a touch more dynamic.  This is an attribute trait that provides for a
delegated method to be curried.

# USAGE

Using this package will cause the relevant attribute trait to be applied
without requiring further intervention.  We use the standard

    handles => { local_method => delegate_info, ... }

delegation methodology, however our currying is invoked when delegate\_info is
a hashref.  We expect delegate info to look like:

    { remote_method => [ $coderef, @more_curry_args ] }

Only $coderef is ever executed by the delegation.  This means that it is safe
to have any number of additional coderefs in @more\_curry\_args: they will be
passed through to remote\_method without additional manipulation.

# ADDITIONAL SUGAR

In addition, we export a number of helper functions.

## curry\_to\_self()

This function always returns a coderef like "sub { shift }".  That is, this:

    local => { remote => [ curry_to_self ] }

is equivalent to:

    local => { remote => [ sub { shift } ] }

is equivalent to:

    $self->attribute_accessor->remote($self)

# TRAIT ALIASES

## CurriedDelegation

Resolves out to the full name of our attribute trait; you can use it as:

    has foo => (traits => [CurriedDelegation], ...)

# SEE ALSO

Please see those modules/websites for more information related to this module.

- [Moose](https://metacpan.org/pod/Moose)
- [Moose::Meta::Method::Delegation](https://metacpan.org/pod/Moose::Meta::Method::Delegation)

# BUGS

Please report any bugs or feature requests on the bugtracker website
[https://github.com/RsrchBoy/moosex-currieddelegation/issues](https://github.com/RsrchBoy/moosex-currieddelegation/issues)

When submitting a bug or request, please include a test-file or a
patch to an existing test-file that illustrates the bug or desired
feature.

# AUTHOR

Chris Weyl 

## I'm a material boy in a material world

Please note **I do not expect to be gittip'ed or flattr'ed for this work**, rather **it is simply a very pleasant surprise**. I largely create and release works like this because I need them or I find it enjoyable; however, don't let that stop you if you feel like it ;) [Flattr](https://flattr.com/submit/auto?user_id=RsrchBoy&url=https%3A%2F%2Fgithub.com%2FRsrchBoy%2Fmoosex-currieddelegation&title=RsrchBoy's%20CPAN%20MooseX-CurriedDelegation&tags=%22RsrchBoy's%20MooseX-CurriedDelegation%20in%20the%20CPAN%22), [Gratipay](https://gratipay.com/RsrchBoy/), or indulge my [Amazon Wishlist](http://bit.ly/rsrchboys-wishlist)... If and \*only\* if you so desire. # COPYRIGHT AND LICENSE This software is Copyright (c) 2012 by Chris Weyl. This is free software, licensed under: The GNU Lesser General Public License, Version 2.1, February 1999

本源码包内暂不包含可直接显示的源代码文件,请下载源码包。