use strict;
=head1 NAME
Test::Valgrind::Command::PerlScript - A Test::Valgrind command that invokes a perl script.
=head1 VERSION
Version 1.13
=cut
our $VERSION = '1.13';
=head1 DESCRIPTION
This command is meant to abstract the argument list handling of a C<perl> script.
=cut
use base qw<Test::Valgrind::Command::Perl Test::Valgrind::Carp>;
=head1 METHODS
This class inherits L<Test::Valgrind::Command::Perl>.
=head2 C<< new file => $file, [ taint_mode => $taint_mode ], ... >>
The package constructor, which takes several options :
=over 4
=item *
C<$file> is the path to the C<perl> script you want to run.
This option is mandatory.
=item *
C<$taint_mode> is actually handled by the parent class L<Test::Valgrind::Command::Perl>, but it gets special handling in this subclass : if C<undef> is passed (which is the default), the constructor will try to infer its right value from the shebang line of the script.
=back
Other arguments are passed straight to C<< Test::Valgrind::Command::Perl->new >>.
=cut
sub new {
my $class = shift;
$class = ref($class) || $class;
my %args = @_;
my $file = delete $args{file};
$class->_croak('Invalid script file') unless $file and -e $file;
my $taint_mode = delete $args{taint_mode};
if (not defined $taint_mode and open my $fh, '<', $file) {
my $first = <$fh>;
close $fh;
if ($first and my ($args) = $first =~ /^\s*#\s*!\s*perl\s*(.*)/) {
$taint_mode = 1 if $args =~ /(?:^|\s)-T(?:$|\s)/;
}
$taint_mode = 0 unless defined $taint_mode;
}
my $self = bless $class->SUPER::new(
taint_mode => $taint_mode,
%args,
), $class;
$self->{file} = $file;
return $self;
}
sub new_trainer { Test::Valgrind::Command::Perl->new_trainer }
=head2 C<file>
Read-only accessor for the C<file> option.
=cut
sub file { $_[0]->{file} }
sub args {
my $self = shift;
return $self->SUPER::args(@_),
$self->file
}
=head1 SEE ALSO
L<Test::Valgrind>, L<Test::Valgrind::Command::Perl>.
=head1 AUTHOR
Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
You can contact me by mail or on C<irc.perl.org> (vincent).
=head1 BUGS
Please report any bugs or feature requests to C<bug-test-valgrind at rt.cpan.org>, or through the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Valgrind>.
I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
=head1 SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Test::Valgrind::Command::PerlScript
=head1 COPYRIGHT & LICENSE
Copyright 2009,2010,2011 Vincent Pit, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
=cut
1; # End of Test::Valgrind::Command::PerlScript