NAME

MooseX::Role::TraitConstructor - A wrapper for new that can accept a traits parameter.

SYNOPSIS

    package Foo;
    use Moose;

        with qw(MooseX::Role::TraitConstructor);


    package Foo::Bah;

    sub bah_method { ... }



    my $foo = Foo->new( traits => [qw( Bah )] );

    $foo->bah_method;

DESCRIPTION

This role allows you to easily accept a traits argument (or another name) into your constructor, which will easily mix roles into an anonymous class before construction, much like Moose::Meta::Attribute does.

METHODS

constructor_trait_param

Returns the string traits.

Override to rename the parameter.

new_with_traits %params

new_with_traits $params

A "new" in Moose::Object like parameter processor which will call new on the return value of interpolate_class_from_params.

interpolate_class_from_params $params

This method will automatically create an anonymous class with the roles from the traits param mixed into it if one exists.

If not the normal class name will be returned.

Will remove the traits parameter from $params.

Also works as an instance method, but always returns a class name.

In list context also returns the actual list of roles mixed into the class.

process_constructor_traits $params, @traits

Calls filter_constructor_traits on the result of resolve_constructor_traits.

resolve_constructor_traits $params, @traits

Attempt to load the traits specified in @traits usinc resolve_constructor_trait

guess_original_class_name $params

resolve_constructor_trait $params, $possible_root, $trait

Attempts to get a processed name from process_trait_name, and then tries to load that.

If process_trait_name didn't return a true value or its return value could not be loaded then $trait will be tried.

If nothing could be loaded an error is thrown.

$possible_root is the name of the first non anonymous class in the linearized_isa, usually $class, but will DWIM in case $class has already been interpolated with traits from a named class.

process_trait_name $trait, $params, $possible_root

Returns join "::", $possible_root, $trait.

You probably want to override this method.

filter_constructor_traits $params, $traits,

Returns all the the roles that the invocant class doesn't already do (uses does).

VERSION CONTROL

http://code2.0beta.co.uk/moose/svn/. Ask on #moose for commit bits.

AUTHOR

Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT

        Copyright (c) 2008 Yuval Kogman. All rights reserved
        This program is free software; you can redistribute
        it and/or modify it under the same terms as Perl itself.