NAME

Module::Find - Find and use installed modules in a (sub)category

SYNOPSIS

use Module::Find;

# use all modules in the Plugins/ directory
@found = usesub Mysoft::Plugins;

# use modules in all subdirectories
@found = useall Mysoft::Plugins;

# find all DBI::... modules
@found = findsubmod DBI;

# find anything in the CGI/ directory
@found = findallmod CGI;

DESCRIPTION

Module::Find lets you find and use modules in categories. This can be very useful for auto-detecting driver or plugin modules. You can differentiate between looking in the category itself or in all subcategories.

If you want Module::Find to search in a certain directory on your harddisk (such as the plugins directory of your software installation), make sure you modify @INC before you call the Module::Find functions.

FUNCTIONS

@found = findsubmod Module::Category

Returns modules found in the Module/Category subdirectories of your perl installation. E.g. findsubmod CGI will return CGI::Session, but not CGI::Session::File .

@found = findallmod Module::Category

Returns modules found in the Module/Category subdirectories of your perl installation. E.g. findallmod CGI will return CGI::Session and also CGI::Session::File .

@found = usesub Module::Category

Uses and returns modules found in the Module/Category subdirectories of your perl installation. E.g. usesub CGI will return CGI::Session, but not CGI::Session::File .

@found = useall Module::Category

Uses and returns modules found in the Module/Category subdirectories of your perl installation. E.g. useall CGI will return CGI::Session and also CGI::Session::File .

HISTORY

0.01, 2004-04-22

Original version; created by h2xs 1.22

0.02, 2004-05-25

Added test modules that were left out in the first version. Thanks to Stuart Johnston for alerting me to this.

SEE ALSO

perl

AUTHOR

Christian Renz, <crenz@web42.com>

COPYRIGHT AND LICENSE

Copyright 2004 by Christian Renz <crenz@web42.com>

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