NAME

       Paranoid::Module -- Paranoid Module Loading Routines

VERSION

       $Id: lib/Paranoid/Module.pm, 2.10 2022/03/08 00:01:04 acorliss Exp $

SYNOPSIS

         use Paranoid::Module;

         $rv = loadModule($module, qw(:all));

DESCRIPTION

       This provides a single function that allows you to do dynamic loading of modules at
       runtime, along with importation of the exported symbol table.  Specific functions and/or
       tag sets can be declared, just as you would in a normal use or import statement.

IMPORT LISTS

       This module exports the following symbols by default:

           loadModule

       The following specialized import lists also exist:

           List        Members
           --------------------------------------------------------
           all         @defaults

SUBROUTINES/METHODS

   loadModule
         $rv = loadModule($module, qw(:all));

       Accepts a module name and an optional list of arguments to use with the import function.
       Returns a true or false depending whether the require was successful.

DEPENDENCIES

       o   Carp

       o   Paranoid

       o   Paranoid::Debug

       o   Paranoid::Input

BUGS AND LIMITATIONS

       The loadModule cannot be used to require external files, it can only be used to load
       modules in the existing library path.  In addition, while we track what symbol sets (if
       any) were imported to the caller's name space the return value doesn't reflect the value
       of the import method.  This is intentional because not every module out there offers a
       properly coded import function or inherits it from Exporter(3)).  The return value from
       import is ignored.

AUTHOR

       Arthur Corliss (corliss@digitalmages.com)

LICENSE AND COPYRIGHT

       This software is free software.  Similar to Perl, you can redistribute it and/or modify it
       under the terms of either:

         a)     the GNU General Public License
                <https://www.gnu.org/licenses/gpl-1.0.html> as published by the
                Free Software Foundation <http://www.fsf.org/>; either version 1
                <https://www.gnu.org/licenses/gpl-1.0.html>, or any later version
                <https://www.gnu.org/licenses/license-list.html#GNUGPL>, or
         b)     the Artistic License 2.0
                <https://opensource.org/licenses/Artistic-2.0>,

       subject to the following additional term:  No trademark rights to "Paranoid" have been or
       are conveyed under any of the above licenses.  However, "Paranoid" may be used fairly to
       describe this unmodified software, in good faith, but not as a trademark.

       (c) 2005 - 2020, Arthur Corliss (corliss@digitalmages.com) (tm) 2008 - 2020, Paranoid Inc.
       (www.paranoid.com)