X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FDispatchType%2FRegex.pm;h=0d6da04b2f05bef060b5c84ae47a0b4cd19618cd;hp=c40be54e5c30433450c3402708470065a7b6115b;hb=48d435ba6a0925260fd58c8c18ff425e99708eae;hpb=ea0e58d9d85d93bf94c3ffa6b4d7b71b200bbdf1 diff --git a/lib/Catalyst/DispatchType/Regex.pm b/lib/Catalyst/DispatchType/Regex.pm index c40be54..0d6da04 100644 --- a/lib/Catalyst/DispatchType/Regex.pm +++ b/lib/Catalyst/DispatchType/Regex.pm @@ -1,20 +1,42 @@ package Catalyst::DispatchType::Regex; -use strict; -use base qw/Catalyst::DispatchType::Path/; +use Moose; +extends 'Catalyst::DispatchType::Path'; + use Text::SimpleTable; +use Catalyst::Utils; use Text::Balanced (); +has _compiled => ( + is => 'rw', + isa => 'ArrayRef', + required => 1, + default => sub{ [] }, + ); + +no Moose; + =head1 NAME Catalyst::DispatchType::Regex - Regex DispatchType =head1 SYNOPSIS -See L. +See L. =head1 DESCRIPTION +Dispatch type managing path-matching behaviour using regexes. For +more information on dispatch types, see: + +=over 4 + +=item * L for how they affect application authors + +=item * L for implementation information. + +=back + =head1 METHODS =head2 $self->list($c) @@ -25,19 +47,26 @@ Output a table of all regex actions, and their private equivalent. sub list { my ( $self, $c ) = @_; - my $re = Text::SimpleTable->new( [ 35, 'Regex' ], [ 36, 'Private' ] ); - for my $regex ( @{ $self->{compiled} } ) { + my $avail_width = Catalyst::Utils::term_width() - 9; + my $col1_width = ($avail_width * .50) < 35 ? 35 : int($avail_width * .50); + my $col2_width = $avail_width - $col1_width; + my $re = Text::SimpleTable->new( + [ $col1_width, 'Regex' ], [ $col2_width, 'Private' ] + ); + for my $regex ( @{ $self->_compiled } ) { my $action = $regex->{action}; $re->row( $regex->{path}, "/$action" ); } - $c->log->debug( "Loaded Regex actions:\n" . $re->draw ) - if ( @{ $self->{compiled} } ); + $c->log->debug( "Loaded Regex actions:\n" . $re->draw . "\n" ) + if ( @{ $self->_compiled } ); } =head2 $self->match( $c, $path ) -Check path against compiled regexes, and set action to any matching -action. Returns 1 on success and 0 on failure. +Checks path against every compiled regex, and offers the action for any regex +which matches a chance to match the request. If it succeeds, sets action, +match and captures on $c->req and returns 1. If not, returns 0 without +altering $c. =cut @@ -48,7 +77,7 @@ sub match { # Check path against plain text first - foreach my $compiled ( @{ $self->{compiled} || [] } ) { + foreach my $compiled ( @{ $self->_compiled } ) { if ( my @captures = ( $path =~ $compiled->{re} ) ) { next unless $compiled->{action}->match($c); $c->req->action( $compiled->{path} ); @@ -65,10 +94,10 @@ sub match { =head2 $self->register( $c, $action ) -Registers one or more regex actions for an action object.\ +Registers one or more regex actions for an action object. Also registers them as literal paths. -Returns 1 on if any regexps were registered. +Returns 1 if any regexps were registered. =cut @@ -88,15 +117,15 @@ sub register { =head2 $self->register_regex($c, $re, $action) -Register an individual regex on the action. Usually called from the -register action. +Register an individual regex on the action. Usually called from the +register method. =cut sub register_regex { my ( $self, $c, $re, $action ) = @_; push( - @{ $self->{compiled} }, # and compiled regex for us + @{ $self->_compiled }, # and compiled regex for us { re => qr#$re#, action => $action, @@ -125,11 +154,13 @@ sub uri_for_action { my $final = '/'; my @captures = @$captures; while (my ($front, $rest) = split(/\(/, $re, 2)) { + last unless defined $rest; ($rest, $re) = Text::Balanced::extract_bracketed("(${rest}", '('); next REGEX unless @captures; $final .= $front.shift(@captures); } + $final .= $re; next REGEX if @captures; return $final; } @@ -137,16 +168,17 @@ sub uri_for_action { return undef; } -=head1 AUTHOR +=head1 AUTHORS -Matt S Trout -Sebastian Riedel, C +Catalyst Contributors, see Catalyst.pm =head1 COPYRIGHT -This program is free software, you can redistribute it and/or modify it under +This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself. =cut +__PACKAGE__->meta->make_immutable; + 1;