/ 
WebDyne-2.020
River stage zero No dependents
/ WebDyne

WebDyne.pm(3pm)

NAME

WebDyne - Dynamic Perl web application framework with template compilation and modular design

SYNOPSIS

SYNOPSIS

#  Basic usage
#
use WebDyne qw(html html_sr);

# Render a .psp file to HTML (returns a string)
#
my $html = html('app.psp', { param1 => 'value', param2 => 'value' });

# Render a .psp file to HTML (returns a scalar ref)
#
my $html_ref = html_sr('app.psp', { param1 => 'value', param2 => 'value' });

# With additional options
#
my $html = html('template.psp', { outfile => $fh });

DESCRIPTION

WebDyne is a high-performance, dynamic Perl web application framework. It provides method to integrate Perl code in HTMLfiles with dynamic compilation, caching, and a modular architecture. WebDyne is designed for flexibility and performance, supporting both CGI and persistent environments (mod_perl, PSGI). The core interface for scripts is via the html and html_sr functions, which render .psp templates to HTML.

WebDyne can be used directly from scripts or as a handler in persistent environments. It supports advanced features such as block rendering, custom handlers, caching, and integration with Apache via mod_perl and PSGI servers such as Plack and Starman.

Comprehensive documentation around the construction and options within .psp files, and the general usage of WebDyne within an Apache or PSGI server are available in the doc directory of the Perl module or from the Github repository.

The simplest representation of a .psp file that can be rendered is as follows. This example uses several syntactic shortcuts from brevity that are not standard HTML, however the output generated by WebDyne is alway standards compliant HTML.

   <start_html>
   The current server time is: <? localtime() ?>

If this example is saved as the filename  C<<<< app.psp >>>>  it can be rendered to HTML from the command line utility  C<<<< wdrender >>>>  as follows:

   $ wdrender app.psp
    
   <!DOCTYPE html><html lang="en"><head><title>Untitled Document</title><meta charset="UTF-8"></head>
   <body><p>The current server time is: Sat Sep 20 17:17:13 2025</p></body></html>

METHODS

  • html($filename, \%options, ...)

    Renders a .psp file to HTML and returns the result as a string. This is a convenience wrapper around html_sr .

    Arguments:

    • $filename - Path to the .psp template file.

    • \%options - Hashref or hash of options and parameters to pass to the template.

    Options:

    • handler - Specify a custom handler class (defaults to WebDyne).

    • outfile - Filehandle to write output to (optional).

  • html_sr($filename, \%options, ...)

    Renders a .psp file to HTML and returns a scalar reference to the result. This is the core rendering function for scripts.

    Arguments and options are as for html.

  • handler($r, \%params)

    Main request handler for mod_perl and PSGI environments. Not typically used directly in scripts.

OPTIONS

The following options can be passed to html and html_sr :

  • filename

    application .psp filename to render (defaults to first argument).

  • handler

    Custom handler class to use for rendering.

  • outfile

    Filehandle to write output to (optional).

SEE ALSO

Plack Catalyst Dancer2 Mojolicious

AUTHOR

Andrew Speer <andrew.speer@isolutions.com.au> and contributors.

LICENSE and COPYRIGHT

This file is part of WebDyne.

This software is copyright (c) 2025 by Andrew Speer mailto:andrew.speer@isolutions.com.au.

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

Full license text is available at:

http://dev.perl.org/licenses/