File Coverage

blib/lib/Perl/Lint/Policy/ValuesAndExpressions/ProhibitSpecialHeredocTerminator.pm

Criterion	Covered	Total	%
statement	24	24	100.0
branch	4	4	100.0
condition	18	18	100.0
subroutine	6	6	100.0
pod	0	1	0.0
total	52	53	98.1

package Perl::Lint::Policy::ValuesAndExpressions::ProhibitSpecialHeredocTerminator;
use strict;
use warnings;
use Perl::Lint::Constants::Type;
use parent "Perl::Lint::Policy";

use constant {
    DESC => 'Heredoc terminator must not be a special literal',
    EXPL => 'Used "%s" as heredoc terminator',
};

sub evaluate {
    my ($class, $file, $tokens, $args) = @_;

    my @violations;
    for (my $i = 0; my $token = $tokens->[$i]; $i++) {
        my $token_type = $token->{type};
        if ($token_type == HERE_DOCUMENT_TAG || $token_type == HERE_DOCUMENT_RAW_TAG || $token_type == HERE_DOCUMENT_BARE_TAG) {
            my $token_data = $token->{data};
            if (
                $token_data eq '__FILE__' ||
                $token_data eq '__LINE__' ||
                $token_data eq '__PACKAGE__' ||
                $token_data eq '__END__' ||
                $token_data eq '__DATA__'
            ) {
                push @violations, {
                    filename => $file,
                    line     => $token->{line},
                    description => DESC,
                    explanation => sprintf(EXPL, $token_data),
                    policy => __PACKAGE__,
                };
            }
        }
    }

    return \@violations;
}

1;