=head1 VERSION
-Version 1.12
+Version 1.17
=cut
-our $VERSION = '1.12';
+our $VERSION = '1.17';
=head1 DESCRIPTION
=cut
+use Test::Valgrind::Util;
+
use base qw<Test::Valgrind::Component Test::Valgrind::Carp>;
=head1 METHODS
-=head2 C<< new action => $action >>
+=head2 C<new>
+
+ my $tva = Test::Valgrind::Action->new(action => $action);
Creates a new action object of type C<$action> by requiring and redispatching the method call to the module named C<$action> if it contains C<'::'> or to C<Test::Valgrind::Action::$action> otherwise.
The class represented by C<$action> must inherit this class.
my %args = @_;
if ($class eq __PACKAGE__) {
- my $action = delete $args{action} || 'Test';
- $action =~ s/[^\w:]//g;
- $action = __PACKAGE__ . "::$action" if $action !~ /::/;
- $class->_croak("Couldn't load action $action: $@")
- unless eval "require $action; 1";
+ my ($action, $msg) = Test::Valgrind::Util::validate_subclass(
+ $args{action} || 'Test',
+ );
+ $class->_croak($msg) unless defined $action;
return $action->new(%args);
}
sub do_suppressions { 0 }
-=head2 C<start $session>
+=head2 C<start>
+
+ $tva->start($session);
Called when the C<$session> starts.
Defaults to set L<Test::Valgrind::Component/started>.
-=head2 C<report $session, $report>
+=head2 C<report>
+
+ $tva->report($session, $report);
Invoked each time the C<valgrind> process attached to the C<$session> spots an error.
C<$report> is a L<Test::Valgrind::Report> object describing the error.
return;
}
-=head2 C<abort $session, $msg>
+=head2 C<abort>
+
+ $tva->abort($session, $msg);
Triggered when the C<$session> has to interrupt the action.
sub abort { $_[0]->_croak($_[2]) }
-=head2 C<finish $session>
+=head2 C<finish>
+
+ $tva->finish($session);
Called when the C<$session> finishes.
Defaults to clear L<Test::Valgrind::Component/started>.
-=head2 C<status $session>
+=head2 C<status>
+
+ $tva->status($session);
Returns the status code corresponding to the last run of the action.
=head1 COPYRIGHT & LICENSE
-Copyright 2009,2010,2011 Vincent Pit, all rights reserved.
+Copyright 2009,2010,2011,2013,2015 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.