oracular (3) Paranoid::Module.3pm.gz

Provided by: libparanoid-perl_2.10-2_all bug

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)


       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)