indirect - Lexically warn about using the indirect object syntax.
VERSION
- Version 0.02
+ Version 0.12
SYNOPSIS
+ # In a script
no indirect;
my $x = new Apple 1, 2, 3; # warns
{
use indirect;
my $y = new Pear; # ok
+ {
+ no indirect hook => sub { die "You really wanted $_[0]\->$_[1]" };
+ my $z = new Pineapple 'fresh'; # croaks 'You really wanted Pineapple->new'
+ }
}
no indirect ':fatal';
if (defied $foo) { ... } # croaks, note the typo
+ # From the command-line
+ perl -M-indirect -e 'my $x = new Banana;' # warns
+
+ # Or each time perl is ran
+ export PERL5OPT="-M-indirect"
+ perl -e 'my $y = new Coconut;' # warns
+
DESCRIPTION
- When enabled (or disabled as some may prefer, since you actually turn it
- on by calling "no indirect"), this pragma warns about indirect object
- syntax constructs that may have slipped into your code. This syntax is
- now considered harmful, since its parsing has many quirks and its use is
- error prone (when "sub" isn't defined, "sub $x" is actually interpreted
- as "$x->sub").
+ When enabled (or disabled as some may prefer to say, since you actually
+ turn it on by calling "no indirect"), this pragma warns about indirect
+ object syntax constructs that may have slipped into your code. This
+ syntax is now considered harmful, since its parsing has many quirks and
+ its use is error prone (when "sub" isn't defined, "sub $x" is actually
+ interpreted as "$x->sub").
It currently does not warn when the object is enclosed between braces
(like "meth { $obj } @args") or for core functions ("print" or "say").
This may change in the future, or may be added as optional features that
would be enabled by passing options to "unimport".
+ This module is not a source filter.
+
METHODS
- "unimport @opts"
- Magically called when "no indirect @args" is encountered. Turns the
- module on. If @opts contains ':fatal', the module will croak on the
- first indirect syntax met.
+ "unimport [ hook => $hook | ':fatal' ]"
+ Magically called when "no indirect @opts" is encountered. Turns the
+ module on. The policy to apply depends on what is first found in @opts :
+
+ * If it's the string ':fatal', the compilation will croak on the first
+ indirect syntax met.
+
+ * If the key/value pair "hook => $hook" comes first, $hook will be
+ called for each error with the object name as $_[0] and the method
+ name as $_[1].
+
+ * Otherwise, a warning will be emitted for each indirect construct.
"import"
Magically called at each "use indirect". Turns the module off.
+CONSTANTS
+ "I_THREADSAFE"
+ True iff the module could have been built when thread-safety features.
+
+CAVEATS
+ "meth $obj" (no semicolon) at the end of a file won't be seen as an
+ indirect object syntax, although it will as soon as there is another
+ token before the end (as in "meth $obj;" or "meth $obj 1").
+
+ With 5.8 perls, the pragma does not propagate into "eval STRING". This
+ is due to a shortcoming in the way perl handles the hints hash, which is
+ addressed in perl 5.10.
+
DEPENDENCIES
- perl 5.9.4.
+ perl 5.8.
XSLoader (standard since perl 5.006).
- Tests require IPC::Cmd (standard since 5.9.5).
-
AUTHOR
Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
- You can contact me by mail or on #perl @ FreeNode (vincent or
- Prof_Vince).
+ You can contact me by mail or on "irc.perl.org" (vincent).
BUGS
Please report any bugs or feature requests to "bug-indirect at
perldoc indirect
+ Tests code coverage report is available at
+ <http://www.profvince.com/perl/cover/indirect>.
+
ACKNOWLEDGEMENTS
Bram, for motivation and advices.
COPYRIGHT & LICENSE
- Copyright 2008 Vincent Pit, all rights reserved.
+ Copyright 2008-2009 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.