NAME

CatalystX::Component::Traits - Automatic Trait Loading and Resolution for Catalyst Components

SYNOPSIS

            

              
              
package Catalyst::Model::SomeModel;
with 'CatalystX::Component::Traits';
package MyApp::Model::MyModel;
use parent 'Catalyst::Model::SomeModel';
package MyApp;
__PACKAGE__->config('Model::MyModel' => {
    traits => ['SearchedForTrait', '+Fully::Qualified::Trait']
});
            
          

DESCRIPTION

Adds a "COMPONENT" in Catalyst::Component method to your Catalyst component base class that reads the optional traits parameter from app and component config and instantiates the component subclass with those traits using "new_with_traits" in MooseX::Traits from MooseX::Traits::Pluggable.

TRAIT SEARCH

Trait names qualified with a + are taken to be full package names.

Unqualified names are searched for, using the algorithm described below.

EXAMPLE

Suppose your inheritance hierarchy is:

            

              
              
MyApp::Model::MyModel
Catalyst::Model::CatModel
Catalyst::Model
Catalyst::Component
Moose::Object
            
          

The configuration is:

            

              
              
traits => ['Foo']
            
          

The package search order for Foo will be:

            

              
              
MyApp::TraitFor::Model::CatModel::Foo
Catalyst::TraitFor::Model::CatModel::Foo
            
          

A MORE PATHOLOGICAL EXAMPLE

For:

            

              
              
My::App::Controller::AController
CatalystX::Something::ControllerBase::SomeController
Catalyst::Controller
Catalyst::Model
Catalyst::Component
Moose::Object
            
          

With:

            

              
              
traits => ['Foo']
            
          

Search order for Foo will be:

            

              
              
My::App::TraitFor::Controller::SomeController::Foo
CatalystX::Something::TraitFor::Controller::SomeController::Foo
            
          

The Base after (M|V|C) is automatically removed.

TRAIT MERGING

Traits from component class config and app config are automatically merged if you set the _trait_merge attribute default, e.g.:

            

              
              
has '+_trait_merge' => (default => 1);
            
          

You can remove component class config traits by prefixing their names with a - in the app config traits.

For example:

            

              
              
package Catalyst::Model::Foo;
has '+_trait_merge' => (default => 1);
__PACKAGE__->config->{traits} = [qw/Foo Bar/];
package MyApp;
__PACKAGE__->config->{'Model::Foo'}{traits} = [qw/-Foo Baz/];
            
          

Will load the traits:

            

              
              
Bar Baz
            
          

AUTHOR

Rafael Kitover, <rkitover@cpan.org>

CONTRIBUTORS

Tomas Doran, <bobtfish@bobtfish.net>

BUGS

Please report any bugs or feature requests to bug-catalystx-component-traits at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CatalystX-Component-Traits. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

ACKNOWLEDGEMENTS

Matt S. Trout and Tomas Doran helped me with the current design.

COPYRIGHT & LICENSE

Copyright (c) 2014, Rafael Kitover

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

cpanm CatalystX::Component::Traits

perl -MCPAN -e shell
install CatalystX::Component::Traits