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