use strict;
use warnings;
-use Carp qw/croak/;
-use Symbol qw/gensym/;
-
-use Variable::Magic qw/wizard cast dispell getdata/;
-
=head1 NAME
subs::auto - Read barewords as subroutine names.
=head1 VERSION
-Version 0.02
+Version 0.05
=cut
-our $VERSION = '0.02';
+our $VERSION;
+BEGIN {
+ $VERSION = '0.05';
+}
=head1 SYNOPSIS
foo->meth; # "'foo'->meth" if you have use'd foo somewhere,
# or "foo()->meth" otherwise
print foo 'wut'; # print to the filehandle foo if it's actually one,
- # or "foo()->print('wut')" otherwise
+ # or "print(foo('wut'))" otherwise
} # ... but function calls will fail at run-time if you don't
# actually define foo somewhere
=head1 DESCRIPTION
-This pragma lexically enables the parsing of any bareword as a subroutine name, except those which corresponds to an entry in C<%INC> (expected to be class names) or whose symbol table entry has a IO slot (expected to be filehandles).
+This pragma lexically enables the parsing of any bareword as a subroutine name, except those which corresponds to an entry in C<%INC> (expected to be class names) or whose symbol table entry has an IO slot (expected to be filehandles).
You can pass options to C<import> as key / value pairs :
C<< in => $pkg >>
-Specifies on which package the pragma should act. Defaults to the current package.
+Specifies on which package the pragma should act. Setting C<$pkg> to C<Some::Package> allows you to resolve all functions name of the type C<Some::Package::func ...> in the current scope. You can use the pragma several times with different package names to allow resolution of all the corresponding barewords. Defaults to the current package.
=back
+This module is B<not> a source filter.
+
=cut
+use B;
+
+use B::Keywords;
+
+use Variable::Magic qw/wizard cast dispell getdata/;
+
BEGIN {
- croak 'uvar magic not available' unless Variable::Magic::VMG_UVAR;
+ unless (Variable::Magic::VMG_UVAR) {
+ require Carp;
+ Carp::croak('uvar magic not available');
+ }
+ require XSLoader;
+ XSLoader::load(__PACKAGE__, $VERSION);
}
-my @core = qw/abs accept alarm atan2 bind binmode bless break caller chdir
- chmod chomp chop chown chr chroot close closedir connect
- continue cos crypt dbmclose dbmopen default defined delete die
- do dump each endgrent endhostent endnetent endprotoent endpwent
- endservent eof eval exec exists exit exp fcntl fileno flock fork
- format formline getc getgrent getgrgid getgrnam gethostbyaddr
- gethostbyname gethostent getlogin getnetbyaddr getnetbyname
- getnetent getpeername getpgrp getppid getpriority getprotobyname
- getprotobynumber getprotoent getpwent getpwnam getpwuid
- getservbyname getservbyport getservent getsockname getsockopt
- given glob gmtime goto grep hex index int ioctl join keys kill
- last lc lcfirst length link listen local localtime lock log
- lstat map mkdir msgctl msgget msgrcv msgsnd my next no oct open
- opendir ord our pack package pipe pop pos print printf prototype
- push quotemeta rand read readdir readline readlink readpipe recv
- redo ref rename require reset return reverse rewinddir rindex
- rmdir say scalar seek seekdir select semctl semget semop send
- setgrent sethostent setnetent setpgrp setpriority setprotoent
- setpwent setservent setsockopt shift shmctl shmget shmread
- shmwrite shutdown sin sleep socket socketpair sort splice split
- sprintf sqrt srand stat state study sub substr symlink syscall
- sysopen sysread sysseek system syswrite tell telldir tie tied
- time times truncate uc ucfirst umask undef unlink unpack unshift
- untie use utime values vec wait waitpid wantarray warn when
- write/;
-push @core,qw/not __LINE__ __FILE__ DATA/;
-
my %core;
-@core{@core} = ();
+@core{
+ @B::Keywords::Barewords,
+ @B::Keywords::Functions,
+ 'DATA',
+} = ();
delete @core{qw/my local/};
-undef @core;
-my $tag = wizard data => sub { 1 };
+BEGIN {
+ *_REFCNT_PLACEHOLDERS = eval 'sub () { ' . ($] < 5.011002 ? 0 : 1) . '}'
+}
+
+my $tag = wizard data => sub { \(my $data = _REFCNT_PLACEHOLDERS ? 2 : 1) };
sub _reset {
- my ($pkg, $func) = @_;
my $fqn = join '::', @_;
+
my $cb = do {
no strict 'refs';
no warnings 'once';
*$fqn{CODE};
};
- if ($cb and getdata(&$cb, $tag)) {
- no strict 'refs';
- my $sym = gensym;
- for (qw/SCALAR ARRAY HASH IO FORMAT/) {
- no warnings 'once';
- *$sym = *$fqn{$_} if defined *$fqn{$_}
- }
- undef *$fqn;
- *$fqn = *$sym;
+
+ if ($cb and defined(my $data = getdata(&$cb, $tag))) {
+ $$data--;
+ return if $$data > 0;
+
+ _delete_sub($fqn);
}
}
sub _fetch {
(undef, my $data, my $func) = @_;
- return if $data->{guard};
- return unless $func !~ /::/ and not exists $core{$func};
+
+ return if $data->{guard} or $func =~ /::/ or exists $core{$func};
local $data->{guard} = 1;
+
my $hints = (caller 0)[10];
- if ($hints and $hints->{bareword}) {
- my $mod = $func . '.pm';
- if (not exists $INC{$mod}) {
- my $fqn = $data->{pkg} . '::' . $func;
- if (do { no strict 'refs'; not *$fqn{CODE} and not *$fqn{IO}}) {
- my $cb = sub {
- my ($file, $line) = (caller 0)[1, 2];
- ($file, $line) = ('(eval 0)', 0) unless $file && $line;
- die "Undefined subroutine &$fqn called at $file line $line\n";
- };
- cast &$cb, $tag;
- no strict 'refs';
- *$fqn = $cb;
+ if ($hints and $hints->{+(__PACKAGE__)}) {
+ my $pm = $func . '.pm';
+ return if exists $INC{$pm};
+
+ my $fqn = $data->{pkg} . '::' . $func;
+ my $cb = do { no strict 'refs'; *$fqn{CODE} };
+ if ($cb) {
+ if (_REFCNT_PLACEHOLDERS and defined(my $data = getdata(&$cb, $tag))) {
+ ++$$data;
}
+ return;
}
+ return if do { no strict 'refs'; *$fqn{IO} };
+
+ $cb = sub {
+ my ($file, $line) = (caller 0)[1, 2];
+ ($file, $line) = ('(eval 0)', 0) unless $file && $line;
+ die "Undefined subroutine &$fqn called at $file line $line\n";
+ };
+ cast &$cb, $tag;
+
+ no strict 'refs';
+ *$fqn = $cb;
} else {
_reset($data->{pkg}, $func);
}
+
return;
}
sub _store {
(undef, my $data, my $func) = @_;
+
return if $data->{guard};
local $data->{guard} = 1;
+
_reset($data->{pkg}, $func);
+
return;
}
-my $wiz = wizard data => sub { +{ pkg => $_[1] } },
+my $wiz = wizard data => sub { +{ pkg => $_[1], guard => 0 } },
fetch => \&_fetch,
store => \&_store;
my %pkgs;
+my $pkg_rx = qr/
+ ^(?:
+ ::
+ |
+ (?:::)?
+ [A-Za-z_][A-Za-z0-9_]*
+ (?:::[A-Za-z_][A-Za-z0-9_]*)*
+ (?:::)?
+ )$
+/x;
+
sub _validate_pkg {
my ($pkg, $cur) = @_;
- return $cur unless $pkg;
- croak 'Invalid package name' if ref $pkg
- or $pkg =~ /(?:-|[^\w:])/
- or $pkg =~ /(?:\A\d|\b:(?::\d|(?:::+)?\b))/;
+
+ return $cur unless defined $pkg;
+
+ if (ref $pkg or $pkg !~ $pkg_rx) {
+ require Carp;
+ Carp::croak('Invalid package name');
+ }
+
$pkg =~ s/::$//;
$pkg = $cur . $pkg if $pkg eq '' or $pkg =~ /^::/;
$pkg;
sub import {
shift;
- croak 'Optional arguments must be passed as keys/values pairs' if @_ % 2;
+ if (@_ % 2) {
+ require Carp;
+ Carp::croak('Optional arguments must be passed as keys/values pairs');
+ }
my %args = @_;
- my $cur = (caller 1)[0];
- my $in = _validate_pkg $args{in}, $cur;
- $^H{bareword} = 1;
+
+ my $cur = (caller 1)[0];
+ my $in = _validate_pkg $args{in}, $cur;
++$pkgs{$in};
- no strict 'refs';
- cast %{$in . '::'}, $wiz, $in;
+ {
+ no strict 'refs';
+ cast %{$in . '::'}, $wiz, $in;
+ }
+
+ $^H{+(__PACKAGE__)} = 1;
+ $^H |= 0x020000;
+
+ return;
}
sub unimport {
- $^H{bareword} = 0;
+ $^H{+(__PACKAGE__)} = 0;
}
{
You have to open global filehandles outside of the scope of this pragma if you want them not to be treated as function calls. Or just use lexical filehandles and default ones as you should be.
+This pragma doesn't propagate into C<eval STRING>.
+
=head1 DEPENDENCIES
L<perl> 5.10.0.
-L<Carp> (standard since perl 5), L<Symbol> (since 5.002).
-
L<Variable::Magic> with C<uvar> magic enabled (this should be assured by the required perl version).
+L<B::Keywords>.
+
+L<Carp> (standard since perl 5), L<XSLoader> (since 5.006).
+
=head1 AUTHOR
Vincent Pit, C<< <perl at profvince.com> >>, L<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 C<irc.perl.org> (vincent).
=head1 BUGS
projects / perl / modules / subs-auto.git / blobdiff