/usr/share/perl5/Path/Dispatcher/Rule.pm is in libpath-dispatcher-perl 1.05-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 | package Path::Dispatcher::Rule;
use Any::Moose;
use Path::Dispatcher::Match;
use constant match_class => "Path::Dispatcher::Match";
has payload => (
is => 'ro',
predicate => 'has_payload',
);
has prefix => (
is => 'ro',
isa => 'Bool',
default => 0,
);
# support for deprecated "block" attribute
sub block { shift->payload(@_) }
sub has_block { shift->has_payload(@_) }
override BUILDARGS => sub {
my $self = shift;
my $args = super;
$args->{payload} ||= delete $args->{block};
return $args;
};
sub match {
my $self = shift;
my $path = shift;
my %args = @_;
my $result;
if ($self->prefix) {
$result = $self->_prefix_match($path);
}
else {
$result = $self->_match($path);
}
return if !$result;
if (ref($result) ne 'HASH') {
die "Results returned from _match must be a hashref";
}
my $match = $self->match_class->new(
path => $path,
rule => $self,
%{ $args{extra_constructor_args} || {} },
%$result,
);
return $match;
}
sub complete {
return (); # no completions
}
sub _prefix_match {
my $self = shift;
return $self->_match(@_);
}
sub run {
my $self = shift;
my $payload = $self->payload;
die "No codeblock to run" if !$payload;
die "Payload is not a coderef" if ref($payload) ne 'CODE';
$self->payload->(@_);
}
__PACKAGE__->meta->make_immutable;
no Any::Moose;
# don't require others to load our subclasses explicitly
require Path::Dispatcher::Rule::Alternation;
require Path::Dispatcher::Rule::Always;
require Path::Dispatcher::Rule::Chain;
require Path::Dispatcher::Rule::CodeRef;
require Path::Dispatcher::Rule::Dispatch;
require Path::Dispatcher::Rule::Empty;
require Path::Dispatcher::Rule::Enum;
require Path::Dispatcher::Rule::Eq;
require Path::Dispatcher::Rule::Intersection;
require Path::Dispatcher::Rule::Metadata;
require Path::Dispatcher::Rule::Regex;
require Path::Dispatcher::Rule::Sequence;
require Path::Dispatcher::Rule::Tokens;
require Path::Dispatcher::Rule::Under;
1;
__END__
=head1 NAME
Path::Dispatcher::Rule - predicate and codeblock
=head1 SYNOPSIS
my $rule = Path::Dispatcher::Rule::Regex->new(
regex => qr/^quit/,
block => sub { die "Program terminated by user.\n" },
);
$rule->match("die"); # undef, because "die" !~ /^quit/
my $match = $rule->match("quit"); # creates a Path::Dispatcher::Match
$match->run; # exits the program
=head1 DESCRIPTION
A rule has a predicate and an optional codeblock. Rules can be matched (which
checks the predicate against the path) and they can be ran (which invokes the
codeblock).
This class is not meant to be instantiated directly, because there is no
predicate matching function. Instead use one of the subclasses such as
L<Path::Dispatcher::Rule::Tokens>.
=head1 ATTRIBUTES
=head2 block
An optional block of code to be run. Please use the C<run> method instead of
invoking this attribute directly.
=head2 prefix
A boolean indicating whether this rule can match a prefix of a path. If false,
then the predicate must match the entire path. One use-case is that you may
want a catch-all rule that matches anything beginning with the token C<ticket>.
The unmatched, latter part of the path will be available in the match object.
=head1 METHODS
=head2 match path -> match
Takes a path and returns a L<Path::Dispatcher::Match> object if it matched the
predicate, otherwise C<undef>. The match object contains information about the
match, such as the results (e.g. for regex, a list of the captured variables),
the C<leftover> path if C<prefix> matching was used, etc.
=head2 run
Runs the rule's codeblock. If none is present, it throws an exception.
=cut
|