+ no indirect hook => sub { my ($obj, $name, $file, $line) = @_; ... };
+ no indirect 'global';
+ no indirect 'global, 'fatal';
+ no indirect 'global', hook => sub { ... };
Magically called when C<no indirect @opts> is encountered.
Turns the module on.
Magically called when C<no indirect @opts> is encountered.
Turns the module on.
@@ -90,11+97,15 @@ The policy to apply depends on what is first found in C<@opts> :
If it is a string that matches C</^:?fatal$/i>, the compilation will croak when the first indirect method call is found.
If it is a string that matches C</^:?fatal$/i>, the compilation will croak when the first indirect method call is found.
+This option is mutually exclusive with the C<'hook'> option.
+
=item *
If the key/value pair C<< hook => $hook >> comes first, C<$hook> will be called for each error with a string representation of the object as C<$_[0]>, the method name as C<$_[1]>, the current file as C<$_[2]> and the line number as C<$_[3]>.
If and only if the object is actually a block, C<$_[0]> is assured to start by C<'{'>.
=item *
If the key/value pair C<< hook => $hook >> comes first, C<$hook> will be called for each error with a string representation of the object as C<$_[0]>, the method name as C<$_[1]>, the current file as C<$_[2]> and the line number as C<$_[3]>.
If and only if the object is actually a block, C<$_[0]> is assured to start by C<'{'>.
+This option is mutually exclusive with the C<'fatal'> option.
+
=item *
If none of C<fatal> and C<hook> are specified, a warning will be emitted for each indirect method call.
=item *
If none of C<fatal> and C<hook> are specified, a warning will be emitted for each indirect method call.
@@ -124,24+135,32 @@ Note that if another policy is installed by a C<no indirect> statement further i
=cut
=cut
+sub _no_hook_and_fatal {
+ require Carp;
+ Carp::croak("The 'fatal' and 'hook' options are mutually exclusive");
+}
+
sub unimport {
shift;
sub unimport {
shift;
- my $hook;
- my $global;
+ my ($global, $fatal, $hook);
+
while (@_) {
my $arg = shift;
if ($arg eq 'hook') {
while (@_) {
my $arg = shift;
if ($arg eq 'hook') {
- last if $hook;
+ _no_hook_and_fatal() if $fatal;
$hook = shift;
} elsif ($arg =~ /^:?fatal$/i) {
$hook = shift;
} elsif ($arg =~ /^:?fatal$/i) {
- last if $hook;
- $hook = sub { die msg(@_) };
+ _no_hook_and_fatal() if defined $hook;
+ $fatal = 1;
} elsif ($arg =~ /^:?global$/i) {
$global = 1;
}
}
} elsif ($arg =~ /^:?global$/i) {
$global = 1;
}
}
- $hook = sub { warn msg(@_) } unless defined $hook;
+
+ unless (defined $hook) {
+ $hook = $fatal ? sub { die msg(@_) } : sub { warn msg(@_) };
Magically called at each C<use indirect>. Turns the module off.
As explained in L</unimport>'s description, an C<use indirect> statement will lexically override a global policy previously installed by C<no indirect 'global', ...> (if there's one).
Magically called at each C<use indirect>. Turns the module off.
As explained in L</unimport>'s description, an C<use indirect> statement will lexically override a global policy previously installed by C<no indirect 'global', ...> (if there's one).
Returns the default error message that C<indirect> generates when an indirect method call is reported.
Returns the default error message that C<indirect> generates when an indirect method call is reported.
@@ -227,6+250,8 @@ If you use C<perl> 5.12 or greater, those constructs are correctly reported.
With 5.8 perls, the pragma does not propagate into C<eval STRING>.
This is due to a shortcoming in the way perl handles the hints hash, which is addressed in perl 5.10.
With 5.8 perls, the pragma does not propagate into C<eval STRING>.
This is due to a shortcoming in the way perl handles the hints hash, which is addressed in perl 5.10.
+Indirect constructs that appear in code C<eval>'d during the global destruction phase of a spawned thread or pseudo-fork (the processes used internally for the C<fork> emulation on Windows) are not reported.
+
The search for indirect method calls happens before constant folding.
Hence C<my $x = new Class if 0> will be caught.
The search for indirect method calls happens before constant folding.