Current File : //usr/share/perl5/vendor_perl/inc/latest/private.pm
use strict;
use warnings;
package inc::latest::private;
# ABSTRACT: private implementation for inc::latest
our $VERSION = '0.500';
use File::Spec;
use IO::File;
# must ultimately "goto" the import routine of the module to be loaded
# so that the calling package is correct when $mod->import() runs.
sub import {
my ( $package, $mod, @args ) = @_;
my $file = $package->_mod2path($mod);
if ( $INC{$file} ) {
# Already loaded, but let _load_module handle import args
goto \&_load_module;
}
# A bundled copy must be present
my ( $bundled, $bundled_dir ) = $package->_search_bundled($file)
or die "No bundled copy of $mod found";
my $from_inc = $package->_search_INC($file);
unless ($from_inc) {
# Only bundled is available
unshift( @INC, $bundled_dir );
goto \&_load_module;
}
if ( _version($from_inc) >= _version($bundled) ) {
# Ignore the bundled copy
goto \&_load_module;
}
# Load the bundled copy
unshift( @INC, $bundled_dir );
goto \&_load_module;
}
sub _version {
require ExtUtils::MakeMaker;
return ExtUtils::MM->parse_version(shift);
}
# use "goto" for import to preserve caller
sub _load_module {
my $package = shift; # remaining @_ is ready for goto
my ( $mod, @args ) = @_;
eval "require $mod; 1" or die $@;
if ( my $import = $mod->can('import') ) {
goto $import;
}
return 1;
}
sub _search_bundled {
my ( $self, $file ) = @_;
my $mypath = 'inc';
local *DH; # Maintain 5.005 compatibility
opendir DH, $mypath or die "Can't open directory $mypath: $!";
while ( defined( my $e = readdir DH ) ) {
next unless $e =~ /^inc_/;
my $try = File::Spec->catfile( $mypath, $e, $file );
return ( $try, File::Spec->catdir( $mypath, $e ) ) if -e $try;
}
return;
}
# Look for the given path in @INC.
sub _search_INC {
# TODO: doesn't handle coderefs or arrayrefs or objects in @INC, but
# it probably should
my ( $self, $file ) = @_;
foreach my $dir (@INC) {
next if ref $dir;
my $try = File::Spec->catfile( $dir, $file );
return $try if -e $try;
}
return;
}
# Translate a module name into a directory/file.pm to search for in @INC
sub _mod2path {
my ( $self, $mod ) = @_;
my @parts = split /::/, $mod;
$parts[-1] .= '.pm';
return $parts[0] if @parts == 1;
return File::Spec->catfile(@parts);
}
1;
# vim: ts=4 sts=4 sw=4 tw=75 et:
__END__
=pod
=encoding UTF-8
=head1 NAME
inc::latest::private - private implementation for inc::latest
=head1 VERSION
version 0.500
=head1 DESCRIPTION
This module has the private methods used to find and load bundled modules.
It should not be used directly.
=head1 AUTHORS
=over 4
=item *
David Golden <dagolden@cpan.org>
=item *
Eric Wilhelm <ewilhelm@cpan.org>
=back
=head1 COPYRIGHT AND LICENSE
This software is Copyright (c) 2009 by David Golden.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004
=cut
Mini Shell