Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

moosex::lazyrequire(3) [osx man page]

MooseX::LazyRequire(3)					User Contributed Perl Documentation				    MooseX::LazyRequire(3)

MooseX::LazyRequire - Required attributes which fail only when trying to use them SYNOPSIS
package Foo; use Moose; use MooseX::LazyRequire; has foo => ( is => 'ro', lazy_required => 1, ); has bar => ( is => 'ro', builder => '_build_bar', ); sub _build_bar { shift->foo } Foo->new(foo => 42); # succeeds, foo and bar will be 42 Foo->new(bar => 42); # succeeds, bar will be 42 Foo->new; # fails, neither foo nor bare were given DESCRIPTION
This module adds a "lazy_required" option to Moose attribute declarations. The reader methods for all attributes with that option will throw an exception unless a value for the attributes was provided earlier by a constructor parameter or through a writer method. CAVEATS
Prior to Moose 1.9900, roles didn't have an attribute metaclass, so this module can't easily apply its magic to attributes defined in roles. If you want to use "lazy_required" in role attributes, you'll have to apply the attribute trait yourself: has foo => ( traits => ['LazyRequire'], is => 'ro', lazy_required => 1, ); With Moose 1.9900, you can use this module in roles just the same way you can in classes. AUTHORS
o Florian Ragwitz <> o Dave Rolsky <> COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by Florian Ragwitz. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. perl v5.16.2 2012-07-02 MooseX::LazyRequire(3)

Check Out this Related Man Page

MooseX::Traits(3pm)					User Contributed Perl Documentation				       MooseX::Traits(3pm)

MooseX::Traits - automatically apply roles at object creation time SYNOPSIS
Given some roles: package Role; use Moose::Role; has foo => ( is => 'ro', isa => 'Int' required => 1 ); And a class: package Class; use Moose; with 'MooseX::Traits'; Apply the roles to the class at "new" time: my $class = Class->with_traits('Role')->new( foo => 42 ); Then use your customized class: $class->isa('Class'); # true $class->does('Role'); # true $class->foo; # 42 DESCRIPTION
Often you want to create components that can be added to a class arbitrarily. This module makes it easy for the end user to use these components. Instead of requiring the user to create a named class with the desired roles applied, or apply roles to the instance one-by- one, he can just create a new class from yours with "with_traits", and then instantiate that. There is also "new_with_traits", which exists for compatibility reasons. It accepts a "traits" parameter, creates a new class with those traits, and then insantiates it. Class->new_with_traits( traits => [qw/Foo Bar/], foo => 42, bar => 1 ) returns exactly the same object as Class->with_traits(qw/Foo Bar/)->new( foo => 42, bar => 1 ) would. But you can also store the result of "with_traits", and call other methods: my $c = Class->with_traits(qw/Foo Bar/); $c->new( foo => 42 ); $c->whatever( foo => 1234 ); And so on. METHODS
$class->with_traits( @traits ) Return a new class with the traits applied. Use like: $class->new_with_traits(%args, traits => @traits) "new_with_traits" can also take a hashref, e.g.: my $instance = $class->new_with_traits({ traits => @traits, foo => 'bar' }); ATTRIBUTES YOUR CLASS GETS
This role will add the following attributes to the consuming class. _trait_namespace You can override the value of this attribute with "default" to automatically prepend a namespace to the supplied traits. (This can be overridden by prefixing the trait name with "+".) Example: package Another::Trait; use Moose::Role; has 'bar' => ( is => 'ro', isa => 'Str', required => 1, ); package Another::Class; use Moose; with 'MooseX::Traits'; has '+_trait_namespace' => ( default => 'Another' ); my $instance = Another::Class->new_with_traits( traits => ['Trait'], # "Another::Trait", not "Trait" bar => 'bar', ); $instance->does('Trait') # false $instance->does('Another::Trait') # true my $instance2 = Another::Class->new_with_traits( traits => ['+Trait'], # "Trait", not "Another::Trait" ); $instance2->does('Trait') # true $instance2->does('Another::Trait') # false AUTHORS and CONTRIBUTORS Jonathan Rockway "<>" Stevan Little "<>" Tomas Doran "<>" Matt S. Trout "<>" Jesse Luehrs "<doy at tozt dot net>" Shawn Moore "<>" Florian Ragwitz "<>" Chris Prather "<>" Yuval Kogman "<>" COPYRIGHT AND LICENSE
Copyright 2008 Infinity Interactive, Inc. <> This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2010-05-13 MooseX::Traits(3pm)
Man Page