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

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;


  # set your own search dirs (uses @INC otherwise)
  setmoduledirs(@INC, @plugindirs, $appdir);

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 CW@INC before you call the Module::Find functions.

FUNCTIONS

Sets the directories to be searched for modules. If not set, Module::Find will use CW@INC. If you use this function, CW@INC will not be included automatically, so add it if you want it. Set to undef to revert to default behaviour. Returns modules found in the Module/Category subdirectories of your perl installation. E.g. CWfindsubmod CGI will return CWCGI::Session, but not CWCGI::Session::File . Returns modules found in the Module/Category subdirectories of your perl installation. E.g. CWfindallmod CGI will return CWCGI::Session and also CWCGI::Session::File . Uses and returns modules found in the Module/Category subdirectories of your perl installation. E.g. CWusesub CGI will return CWCGI::Session, but not CWCGI::Session::File . Uses and returns modules found in the Module/Category subdirectories of your perl installation. E.g. CWuseall CGI will return CWCGI::Session and also CWCGI::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.
0.03, 2004-06-18
Fixed a bug (non-localized CW$_) by declaring a loop variable in use functions. Thanks to Stuart Johnston for alerting me to this and providing a fix. Fixed non-platform compatibility by using File::Spec. Thanks to brian d foy. Added setmoduledirs and updated tests. Idea shamelessly stolen from ...errm... inspired by brian d foy.
0.04, 2005-05-20
Added POD tests.
0.05, 2005-11-30
Fixed issue with bugfix in PathTools-3.14.

SEE ALSO

perl

AUTHOR

Christian Renz, <crenz@web42.com>

COPYRIGHT AND LICENSE

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

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