whitespace changes for attributes
[catagits/Catalyst-Runtime.git] / lib / Catalyst / ActionContainer.pm
index eb6bb74..9d41f4e 100644 (file)
@@ -1,45 +1,87 @@
 package Catalyst::ActionContainer;
 
-use strict;
-use base qw/Class::Accessor::Fast/;
+=head1 NAME
+
+Catalyst::ActionContainer - Catalyst Action Container
+
+=head1 SYNOPSIS
+
+See L<Catalyst>.
+
+=head1 DESCRIPTION
+
+This is a container for actions. The dispatcher sets up a tree of these
+to represent the various dispatch points in your application.
+
+=cut
 
-__PACKAGE__->mk_accessors(qw/part actions/);
+use Moose;
 
 use overload (
 
     # Stringify to path part for tree search
-    q{""} => sub { shift->{part} },
+    q{""} => sub { shift->part },
 
 );
 
-=head1 NAME
+has part => (is => 'rw', required => 1, lazy => 1, default => sub { {} });
+has actions => (is => 'rw', required => 1, lazy => 1, default => sub { {} });
 
-Catalyst::Action - Catalyst Action
+around 'new' => sub {
+  my $next = shift;
+  my ($self, $params) = @_;
+  $params = { part => $params } unless ref $params;
+  $next->($self, $params);
+};
 
-=head1 SYNOPSIS
+no Moose;
 
-See L<Catalyst>.
+sub get_action {
+    my ( $self, $name ) = @_;
+    return $self->actions->{$name} if defined $self->actions->{$name};
+    return;
+}
 
-=head1 DESCRIPTION
+sub add_action {
+    my ( $self, $action, $name ) = @_;
+    $name ||= $action->name;
+    $self->actions->{$name} = $action;
+}
+
+__PACKAGE__->meta->make_immutable;
+
+1;
+
+__END__
 
 =head1 METHODS
 
-=over 4
+=head2 new(\%data | $part)
 
-=item part
+Can be called with { part => $part, actions => \%actions } for full
+construction or with just a part, which will result in an empty actions
+hashref to be populated via add_action later
 
-=item actions
+=head2 get_action($name)
 
-=item new
+Returns an action from this container based on the action name, or undef
 
-=cut
+=head2 add_action($action, [ $name ])
 
-sub new {        # Dumbass constructor
-    my ( $class, $attrs ) = @_;
-    return bless { %{ $attrs || {} } }, $class;
-}
+Adds an action, optionally providing a name to override $action->name
+
+=head2 actions
+
+Accessor to the actions hashref, containing all actions in this container.
+
+=head2 part
+
+Accessor to the path part this container resolves to. Also what the container
+stringifies to.
+
+=head2 meta
 
-=back
+Provided by Moose
 
 =head1 AUTHOR