The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

=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
use Moose;
has part => (is => 'rw', required => 1);
has actions => (is => 'rw', required => 1, lazy => 1, default => sub { {} });
around BUILDARGS => sub {
my ($next, $self, @args) = @_;
unshift @args, 'part' if scalar @args == 1 && !ref $args[0];
return $self->$next(@args);
};
no Moose;
use overload (
# Stringify to path part for tree search
q{""} => sub { shift->part },
);
sub get_action {
my ( $self, $name ) = @_;
return $self->actions->{$name} if defined $self->actions->{$name};
return;
}
sub add_action {
my ( $self, $action, $name ) = @_;
$name ||= $action->name;
$self->actions->{$name} = $action;
}
__PACKAGE__->meta->make_immutable;
1;
__END__
=head1 METHODS
=head2 new(\%data | $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
=head2 get_action($name)
Returns an action from this container based on the action name, or undef
=head2 add_action($action, [ $name ])
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
Provided by Moose
=head1 AUTHORS
Catalyst Contributors, see Catalyst.pm
=head1 COPYRIGHT
This library is free software. You can redistribute it and/or modify it under
the same terms as Perl itself.
=cut
1;