/usr/share/perl5/PPIx/Regexp/Util.pm is in libppix-regexp-perl 0.055-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 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 | package PPIx::Regexp::Util;
use 5.006;
use strict;
use warnings;
use Carp;
use Scalar::Util qw{ blessed };
use base qw{ Exporter };
our @EXPORT_OK = qw{ __choose_tokenizer_class __instance __to_ordinal_en };
our $VERSION = '0.055';
{
my @ppi_zoo = (
[ 'PPI::Token::Regexp::Transliterate' ],
[ 'PPI::Token::Regexp', 'PPIx::Regexp::Tokenizer' ],
[ 'PPI::Token::QuoteLike::Regexp', 'PPIx::Regexp::Tokenizer' ],
[ 'PPI::Token::Quote',
'PPIx::Regexp::StringTokenizer' ],
[ 'PPI::Token::QuoteLike::Command',
'PPIx::Regexp::StringTokenizer' ],
[ 'PPI::Token::QuoteLike::BackTick',
'PPIx::Regexp::StringTokenizer' ],
[ 'PPI::Token::HereDoc',
'PPIx::Regexp::StringTokenizer' ],
);
my %parse_type = (
guess => sub {
my ( $content ) = @_;
if ( __instance( $content, 'PPI::Element' ) ) {
foreach ( @ppi_zoo ) {
$content->isa( $_->[0] )
and return $_->[1];
}
return;
} elsif ( ref $content ) {
return;
} else {
return $content =~ m/ \A \s*
(?: ["'`] | << | (?: (?: qq | q | qx ) \b ) ) /smx ?
'PPIx::Regexp::StringTokenizer' :
'PPIx::Regexp::Tokenizer';
}
},
regex => sub {
return 'PPIx::Regexp::Tokenizer';
},
string => sub {
return 'PPIx::Regexp::StringTokenizer';
},
);
sub __choose_tokenizer_class {
my ( $content, $arg ) = @_;
my $parse = defined $arg->{parse} ? $arg->{parse} : 'regex';
my $code = $parse_type{$parse}
or return PPIx::Regexp::Tokenizer->__set_errstr(
"Unknown parse type '$parse'" );
return $code->( $content );
}
}
sub __instance {
my ( $object, $class ) = @_;
blessed( $object ) or return;
return $object->isa( $class );
}
sub __to_ordinal_en {
my ( $num ) = @_;
$num += 0;
1 == $num % 10
and return "${num}st";
2 == $num % 10
and return "${num}nd";
3 == $num % 10
and return "${num}rd";
return "${num}th";
}
1;
__END__
=head1 NAME
PPIx::Regexp::Util - Utility functions for PPIx::Regexp;
=head1 SYNOPSIS
use PPIx::Regexp::Util qw{ __instance };
.
.
.
__instance( $foo, 'Bar' )
or die '$foo is not a Bar';
=head1 DESCRIPTION
This module contains utility functions for L<PPIx::Regexp|PPIx::Regexp>
which it is convenient to centralize.
The contents of this module are B<private> to the
L<PPIx::Regexp|PPIx::Regexp> package. This documentation is provided for
the author's convenience only. Anything in this module is subject to
change without notice. I<Caveat user.>
This module exports nothing by default.
=head1 SUBROUTINES
This module can export the following subroutines:
=head2 __instance
__instance( $foo, 'Bar' )
and print '$foo isa Bar', "\n";
This subroutine returns true if its first argument is an instance of the
class specified by its second argument. Unlike C<UNIVERSAL::isa>, the
result is always false unless the first argument is a reference.
=head2 __to_ordinal_en
This subroutine takes as its argument an integer and returns a string
representing its ordinal in English. For example
say __to_ordinal_en( 17 );
# 17th
=cut
=head1 SEE ALSO
L<Params::Util|Params::Util>, which I recommend, but in the case of
C<PPIx::Regexp> I did not want to introduce a dependency on an XS module
when all I really wanted was the function of that module's
C<_INSTANCE()> subroutine.
=head1 SUPPORT
Support is by the author. Please file bug reports at
L<http://rt.cpan.org>, or in electronic mail to the author.
=head1 AUTHOR
Thomas R. Wyant, III F<wyant at cpan dot org>
=head1 COPYRIGHT AND LICENSE
Copyright (C) 2010-2018 by Thomas R. Wyant, III
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl 5.10.0. For more details, see the full text
of the licenses in the directory LICENSES.
This program is distributed in the hope that it will be useful, but
without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.
=cut
# ex: set textwidth=72 :
|