NAME

Pgreet::ExecEmbperl - Penguin Greetings wrapper for calls to Embperl

SYNOPSIS

# Call HTML::Mason without use of autohanders (mainly for text files.)
ExecMason({comp_root  => $comp_root,
           data_dir   => $data_dir,
           out_method => \$result_str,
          },
          $comp_path,
          $Transfer
         );

# Call HTML::Mason to create an HTML page with Mason object-oriented
# features
ExecObjMason({comp_root  => $comp_root,
              data_dir   => $data_dir,
               out_method => \$result_str,
              },
             $comp_path,
             $Transfer
            );

DESCRIPTION

The module Pgreet::ExecMason exists to wrap calls to the Embperl enviroment so that the Perl autouse pragma can be used to avoid loading Embperl until runtime. This is one half of the solution to avoid requiring Penguin Greetings users to load both Embperl and HTML::Mason when they might be using only one of the two environments. The only reason to use this module would be to replicate this use of the Perl pragma in some similar situation. Example calls are provided above and/or examine the use of this module in Pgreet::CGIUtils.

There is only a functional interface to these wrappers in order to support the manner in which the autouse pragma swaps in a module's procedures at runtime.

USAGE

The two functions in this package are identical except that one sets the autohandler name to an empty string in order to disable inheritance. There are 3 arguments. The first is a hash-ref containing the argument to HTML::Mason::Interp::new. The remaining two arguments (component path and arguments list) are passed to HTML::Mason::Interp::exec.

COPYRIGHT

Copyright (c) 2005 Edouard Lagache

This software is released under the GNU General Public License, Version 2. For more information, see the COPYING file included with this software or visit: http://www.gnu.org/copyleft/gpl.html

BUGS

No known bugs at this time.

AUTHOR

Edouard Lagache <pgreetdev@canebas.org>

VERSION

0.9.9

SEE ALSO

Pgreet, Pgreet::Config, Pgreet::Error, Pgreet::CGIUtils, Pgreet::ExecEmbperl, CGI::Carp

1;