<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">package Module::Load;

use strict;
use warnings;
use File::Spec ();

our $VERSION = '0.36';


sub import {
    my $who = _who();
    my $h; shift;

    {   no strict 'refs';

        @_ or (
            *{"${who}::load"} = \&amp;load, # compat to prev version
            *{"${who}::autoload"} = \&amp;autoload,
            return
        );

        map { $h-&gt;{$_} = () if defined $_ } @_;

        (exists $h-&gt;{none} or exists $h-&gt;{''})
            and shift, last;

        ((exists $h-&gt;{autoload} and shift,1) or (exists $h-&gt;{all} and shift))
            and *{"${who}::autoload"} = \&amp;autoload;

        ((exists $h-&gt;{load} and shift,1) or exists $h-&gt;{all})
            and *{"${who}::load"} = \&amp;load;

        ((exists $h-&gt;{load_remote} and shift,1) or exists $h-&gt;{all})
            and *{"${who}::load_remote"} = \&amp;load_remote;

        ((exists $h-&gt;{autoload_remote} and shift,1) or exists $h-&gt;{all})
            and *{"${who}::autoload_remote"} = \&amp;autoload_remote;

    }

}

sub load(*;@){
    goto &amp;_load;
}

sub autoload(*;@){
    unshift @_, 'autoimport';
    goto &amp;_load;
}

sub load_remote($$;@){
    my ($dst, $src, @exp) = @_;

    eval "package $dst;Module::Load::load('$src', qw/@exp/);";
    $@ &amp;&amp; die "$@";
}

sub autoload_remote($$;@){
    my ($dst, $src, @exp) = @_;

    eval "package $dst;Module::Load::autoload('$src', qw/@exp/);";
    $@ &amp;&amp; die "$@";
}

sub _load{
    my $autoimport = $_[0] eq 'autoimport' and shift;
    my $mod = shift or return;
    my $who = _who();

    if( _is_file( $mod ) ) {
        require $mod;
    } else {
        LOAD: {
            my $err;
            for my $flag ( qw[1 0] ) {
                my $file = _to_file( $mod, $flag);
                eval { require $file };
                $@ ? $err .= $@ : last LOAD;
            }
            die $err if $err;
        }
    }

    ### This addresses #41883: Module::Load cannot import
    ### non-Exporter module. -&gt;import() routines weren't
    ### properly called when load() was used.

    {   no strict 'refs';
        my $import;

    ((@_ or $autoimport) and (
        $import = $mod-&gt;can('import')
        ) and (
        unshift(@_, $mod),
        goto &amp;$import
        )
    );
    }

}

sub _to_file{
    local $_    = shift;
    my $pm      = shift || '';

    ## trailing blanks ignored by default. [rt #69886]
    my @parts = split /::|'/, $_, -1;
    ## make sure that we can't hop out of @INC
    shift @parts if @parts &amp;&amp; !$parts[0];

    ### because of [perl #19213], see caveats ###
    my $file = $^O eq 'MSWin32'
                    ? join "/", @parts
                    : File::Spec-&gt;catfile( @parts );

    $file   .= '.pm' if $pm;

    ### on perl's before 5.10 (5.9.5@31746) if you require
    ### a file in VMS format, it's stored in %INC in VMS
    ### format. Therefor, better unixify it first
    ### Patch in reply to John Malmbergs patch (as mentioned
    ### above) on p5p Tue 21 Aug 2007 04:55:07
    $file = VMS::Filespec::unixify($file) if $^O eq 'VMS';

    return $file;
}

sub _who { (caller(1))[0] }

sub _is_file {
    local $_ = shift;
    return  /^\./               ? 1 :
            /[^\w:']/           ? 1 :
            undef
    #' silly bbedit..
}


1;

__END__

=pod

=head1 NAME

Module::Load - runtime require of both modules and files

=head1 SYNOPSIS

  use Module::Load;

  my $module = 'Data::Dumper';

  load Data::Dumper;     # loads that module, but not import any functions
                         # -&gt; cannot use 'Dumper' function

  load 'Data::Dumper';   # ditto
  load $module           # tritto

  autoload Data::Dumper; # loads that module and imports the default functions
                         # -&gt; can use 'Dumper' function

  my $script = 'some/script.pl'
  load $script;
  load 'some/script.pl';  # use quotes because of punctuations

  load thing;             # try 'thing' first, then 'thing.pm'

  load CGI, ':all';       # like 'use CGI qw[:standard]'

=head1 DESCRIPTION

C&lt;Module::Load&gt; eliminates the need to know whether you are trying
to require either a file or a module.

If you consult C&lt;perldoc -f require&gt; you will see that C&lt;require&gt; will
behave differently when given a bareword or a string.

In the case of a string, C&lt;require&gt; assumes you are wanting to load a
file. But in the case of a bareword, it assumes you mean a module.

This gives nasty overhead when you are trying to dynamically require
modules at runtime, since you will need to change the module notation
(C&lt;Acme::Comment&gt;) to a file notation fitting the particular platform
you are on.

C&lt;Module::Load&gt; eliminates the need for this overhead and will
just DWYM.

=head2 Difference between C&lt;load&gt; and C&lt;autoload&gt;

C&lt;Module::Load&gt; imports the two functions - C&lt;load&gt; and C&lt;autoload&gt;

C&lt;autoload&gt; imports the default functions automatically,
but C&lt;load&gt; do not import any functions.

C&lt;autoload&gt; is usable under C&lt;BEGIN{};&gt;.

Both the functions can import the functions that are specified.

Following codes are same.

  load File::Spec::Functions, qw/splitpath/;

  autoload File::Spec::Functions, qw/splitpath/;

=head1 FUNCTIONS

=over 4

=item load

Loads a specified module.

See L&lt;/Rules&gt; for detailed loading rule.

=item autoload

Loads a specified module and imports the default functions.

Except importing the functions, 'autoload' is same as 'load'.

=item load_remote

Loads a specified module to the specified package.

  use Module::Load 'load_remote';

  my $pkg = 'Other::Package';

  load_remote $pkg, 'Data::Dumper'; # load a module to 'Other::Package'
                                    # but do not import 'Dumper' function

A module for loading must be quoted.

Except specifing the package and quoting module name,
'load_remote' is same as 'load'.

=item autoload_remote

Loads a specified module and imports the default functions to the specified package.

  use Module::Load 'autoload_remote';

  my $pkg = 'Other::Package';

  autoload_remote $pkg, 'Data::Dumper'; # load a module to 'Other::Package'
                                        # and imports 'Dumper' function

A module for loading must be quoted.

Except specifing the package and quoting module name,
'autoload_remote' is same as 'load_remote'.

=back

=head1 Rules

All functions have the following rules to decide what it thinks
you want:

=over 4

=item *

If the argument has any characters in it other than those matching
C&lt;\w&gt;, C&lt;:&gt; or C&lt;'&gt;, it must be a file

=item *

If the argument matches only C&lt;[\w:']&gt;, it must be a module

=item *

If the argument matches only C&lt;\w&gt;, it could either be a module or a
file. We will try to find C&lt;file.pm&gt; first in C&lt;@INC&gt; and if that
fails, we will try to find C&lt;file&gt; in @INC.  If both fail, we die with
the respective error messages.

=back

=head1 IMPORTS THE FUNCTIONS

'load' and 'autoload' are imported by default, but 'load_remote' and
'autoload_remote' are not imported.

To use 'load_remote' or 'autoload_remote', specify at 'use'.

=over 4

=item "load","autoload","load_remote","autoload_remote"

Imports the selected functions.

  # imports 'load' and 'autoload' (default)
  use Module::Load;

  # imports 'autoload' only
  use Module::Load 'autoload';

  # imports 'autoload' and 'autoload_remote', but don't import 'load';
  use Module::Load qw/autoload autoload_remote/;

=item 'all'

Imports all the functions.

  use Module::Load 'all'; # imports load, autoload, load_remote, autoload_remote

=item '','none',undef

Not import any functions (C&lt;load&gt; and C&lt;autoload&gt; are not imported).

  use Module::Load '';

  use Module::Load 'none';

  use Module::Load undef;

=back

=head1 Caveats

Because of a bug in perl (#19213), at least in version 5.6.1, we have
to hardcode the path separator for a require on Win32 to be C&lt;/&gt;, like
on Unix rather than the Win32 C&lt;\&gt;. Otherwise perl will not read its
own %INC accurately double load files if they are required again, or
in the worst case, core dump.

C&lt;Module::Load&gt; cannot do implicit imports, only explicit imports.
(in other words, you always have to specify explicitly what you wish
to import from a module, even if the functions are in that modules'
C&lt;@EXPORT&gt;)

=head1 SEE ALSO

L&lt;Module::Runtime&gt; provides functions for loading modules,
checking the validity of a module name,
converting a module name to partial C&lt;.pm&gt; path,
and related utility functions.

L&lt;"require" in perlfunc|https://metacpan.org/pod/perlfunc#require&gt;
and
L&lt;"use" in perlfunc|https://metacpan.org/pod/perlfunc#use&gt;.

L&lt;Mojo::Loader&gt; is a "class loader and plugin framework",
and is included in the
L&lt;Mojolicious|https://metacpan.org/release/Mojolicious&gt; distribution.

L&lt;Module::Loader&gt; is a module for finding and loading modules
in a given namespace, inspired by C&lt;Mojo::Loader&gt;.


=head1 ACKNOWLEDGEMENTS

Thanks to Jonas B. Nielsen for making explicit imports work.

=head1 BUG REPORTS

Please report bugs or other issues to E&lt;lt&gt;bug-module-load@rt.cpan.orgE&lt;gt&gt;.

=head1 AUTHOR

This module by Jos Boumans E&lt;lt&gt;kane@cpan.orgE&lt;gt&gt;.

=head1 COPYRIGHT

This library is free software; you may redistribute and/or modify it
under the same terms as Perl itself.

=cut
</pre></body></html>