view release on metacpan or  search on metacpan

lib/Module/Pluggable/Loader.pm  view on Meta::CPAN

use 5.008;
use strict;
use warnings;

package Module::Pluggable::Loader;
our $VERSION = '1.100860';
# ABSTRACT: Just load plugins, aware of development directories

sub import {
    my ($class, @namespaces) = @_;
    my $caller = (caller)[0];
    require Module::Pluggable;
    Module::Pluggable->import(
        package     => $caller,
        search_path => \@namespaces,
        (   @Devel::SearchINC::inc
            ? (search_dirs => \@Devel::SearchINC::inc)
            : ()
        ),
        require => 1
    );
    $caller->plugins;    # just load the plugins
}
1;


__END__
=pod

=head1 NAME

Module::Pluggable::Loader - Just load plugins, aware of development directories

=head1 VERSION

version 1.100860

=head1 SYNOPSIS

    use Module::Pluggable::Loader 'My::Plugin::Namespace';

=head1 DESCRIPTION

This module is a simple loader for plugins found by L<Module::Pluggable>. The
search paths can be specified when using the module. L<Module::Pluggable>'s
C<search_dirs> option will be made aware of development directories found by
L<Devel::SearchINC>, if any exist.

The plugins will then be loaded, but not instantiated.

One use for this module is when defining test classes - see L<Test::Class> -
as plugins. You don't want to instantiate those classes, just load them and
let L<Test::Class> handle the rest.

=head1 FUNCTIONS

=head2 import

Handles the calls to L<Module::Pluggable> at compile-time, that is, when
calling C<use()> on this module.

=head1 INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

=head1 BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests through the web interface at
L<http://rt.cpan.org/Public/Dist/Display.html?Name=Module-Pluggable-Loader>.