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)

perl v5.34.0                                       2022-03-13                              Paranoid::Module(3pm)