MooseX::Does::Delegated - allow your class's DOES method to respond the affirmative to delegated roles
use strict; use Test::More; { package HttpGet; use Moose::Role; requires 'get'; }; { package UserAgent; use Moose; with qw( HttpGet ); sub get { ... }; }; { package Spider; use Moose; has ua => ( is => 'ro', does => 'HttpGet', handles => 'HttpGet', lazy_build => 1, ); sub _build_ua { UserAgent->new }; }; my $woolly = Spider->new; # Note that the default Moose implementation of DOES # ignores the fact that Spider has delegated the HttpGet # role to its "ua" attribute. # ok( $woolly->DOES('Spider') ); ok( not $woolly->DOES('HttpGet') ); Moose::Util::apply_all_roles( 'Spider', 'MooseX::Does::Delegated', ); # Our reimplemented DOES pays attention to delegated roles. # ok( $woolly->DOES('Spider') ); ok( $woolly->DOES('HttpGet') ); done_testing;
According to UNIVERSAL the point of DOES is that it allows you to check whether an object does a role without caring about how it does the role.
DOES
However, the default Moose implementation of DOES (which you can of course override!) only checks whether the object does the role via inheritance or the application of a role to a class.
This module overrides your object's DOES method, allowing it to respond the affirmative to delegated roles. This module is a standard Moose role, so it can be used like this:
with qw( MooseX::Does::Delegated );
Alternatively, if you wish to apply this role ubiqitously (i.e. to all Moose objects in your application) - as is your prerogative - you can use:
use MooseX::Does::Delegated -everywhere;
This will apply the role to the Moose::Object base class.
Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=MooseX-Does-Delegated.
Moose::Manual::Delegation.
Toby Inkster <tobyink@cpan.org>.
This software is copyright (c) 2012 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.
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.
To install MooseX::Does::Delegated, copy and paste the appropriate command in to your terminal.
cpanm
cpanm MooseX::Does::Delegated
CPAN shell
perl -MCPAN -e shell install MooseX::Does::Delegated
For more information on module installation, please visit the detailed CPAN module installation guide.