moosex::lazyrequire5.18(3) [mojave man page]

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

NAME

       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 <rafl@debian.org>

       o   Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2013 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.18.2							    2013-03-15						    MooseX::LazyRequire(3)

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

NAME

       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 "<jrockway@cpan.org>"

       Stevan Little "<stevan.little@iinteractive.com>"

       Tomas Doran "<bobtfish@bobtfish.net>"

       Matt S. Trout "<mst@shadowcatsystems.co.uk>"

       Jesse Luehrs "<doy at tozt dot net>"

       Shawn Moore "<sartak@bestpractical.com>"

       Florian Ragwitz "<rafl@debian.org>"

       Chris Prather "<chris@prather.org>"

       Yuval Kogman "<nothingmuch@woobling.org>"

COPYRIGHT AND LICENSE

       Copyright 2008 Infinity Interactive, Inc.

       <http://www.iinteractive.com>

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.16.2							    2010-05-13							 MooseX::Traits(3)