/usr/share/perl5/Sub/Exporter/GlobExporter.pm is in libsub-exporter-globexporter-perl 0.002-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 | use strict;
use warnings;
package Sub::Exporter::GlobExporter;
BEGIN {
$Sub::Exporter::GlobExporter::VERSION = '0.002';
}
# ABSTRACT: export shared globs with Sub::Exporter collectors
use Scalar::Util ();
use Sub::Exporter -setup => [ qw(glob_exporter) ];
my $is_ref;
BEGIN {
$is_ref = sub {
return(
! Scalar::Util::blessed($_[0])
&& Scalar::Util::reftype($_[0]) eq $_[1]
);
};
}
sub glob_exporter {
my ($default_name, $globref) = @_;
my $globref_method = $is_ref->($globref, 'GLOB') ? sub { $globref }
: $is_ref->($globref, 'SCALAR') ? $$globref
: Carp::confess("illegal glob locator '$globref'");
return sub {
my ($value, $data) = @_;
my @args = defined $value
? ({ map {; $_ => $value->{$_} } grep { ! /^-/ } keys %$value })
: ();
my $globref = $data->{class}->$globref_method(@args);
# allow a SCALAR ref in the future to do ($$as = $globref) as we allow subs
# to be exported into scalar refs -- rjbs, 2010-11-23
my $name;
$name = defined $value->{'-as'} ? $value->{'-as'} : $default_name;
my $sym = "$data->{into}::$name";
{
no strict 'refs';
*{$sym} = *$globref;
}
$_[0] = $globref;
return 1;
}
}
1;
__END__
=pod
=head1 NAME
Sub::Exporter::GlobExporter - export shared globs with Sub::Exporter collectors
=head1 VERSION
version 0.002
=head1 SYNOPSIS
First, you write something that exports globs:
package Shared::Symbol;
use Sub::Exporter;
use Sub::Exporter::GlobExport qw(glob_exporter);
use Sub::Exporter -setup => {
...
collectors => { '$Symbol' => glob_exporter(Symbol => \'_shared_globref') },
};
sub _shared_globref { return \*Common }
Now other code can import C<$Symbol> and get their C<*Symbol> made an alias to
C<*Shared::Symbol::Symbol>.
If you don't know what this means or why you'd want to do it, you may want to
stop reading now.
The other class can do something like this:
use Shared::Symbol '$Symbol';
print $Symbol; # prints the scalar entry of *Shared::Symbol::Symbol
...or...
use Shared::Symbol '$Symbol' => { -as => 'SharedSymbol' };
print $SharedSymbol; # prints the scalar entry of *Shared::Symbol::Symbol
=head1 OVERVIEW
Sub::Exporter::GlobExporter provides only one routine, C<glob_exporter>, which
may be called either by its full name or may be imported on request.
my $exporter = glob_exporter( $default_name, $globref_locator );
The routine returns a L<collection validator|Sub::Exporter/Collector
Configuration> that will export a glob into the importing package. It will
export it under the name C<$default_name>, unless an alternate name is given
(as shown above). The glob that is installed is specified by the
C<$globref_locator>, which can be either the globref itself, or a reference to
a string which will be called on the exporter
For an example, see the L</SYNOPSIS>, in which a method is defined to produce
the globref to share. This allows the glob-exporting package to be subclassed,
for for the subclass to choose to re-use the same glob when exporting or to
export a new one.
If there are entries in the arguments to the globref-exporting collector
I<other> than those beginning with a dash, a hashref of them will be passed to
the globref locator. In other words, if we were to write this:
use Shared::Symbol '$Symbol' => { arg => 1, -as => 2 };
It would result in a call like the following:
my $globref = Shared::Symbol->_shared_globref({ arg => 1 });
=head1 AUTHOR
Ricardo Signes <rjbs@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Ricardo Signes.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|