PerlSamplePlugin

Introduction

This plugin executes and nicely formats a piece of Perl code, together with its STDOUT and STDERR outputs. To avoid improper usage it executes the Perl code in a CPAN:Safe compartment.

Syntax Rules

Enclose Perl code in %PERLSAMPLE{ and }%.

Usage Example

%PERLSAMPLE{
print "hello world!";
}% 

1

print "hello world!";

1 

 1: hello world! 

To-Do

• Apply a timeout to the perl execution (spawn a delayed kill process)
• Limit the output size (disk quota?)
• Use a random generated file for the output/stderr

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %PERLSAMPLEPLUGIN_SHORTDESCRIPTION%

• One line description, is shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = Execute and format nicely some Perl code embedded in a TWiki page, showing STDOUT and STDERR outputs

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.

• Install the CPAN:Safe Perl module (see http://www.cpan.org)
• Make sure that bin/perl_stdout.tmp and bin/perl_stderr.tmp are writable by the Apache user
• Download the ZIP file from the Plugin Home (see below)
• Unzip PerlSamplePlugin.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/PerlSamplePlugin.txt	Plugin topic
  lib/TWiki/Plugins/PerlSamplePlugin.pm	Plugin Perl module

• Configure the plugin:
  • Run the configure script to enable the plugin
• Test if the installation was successful:
  • See above example

Plugin Info

Plugin Author:	TWiki:Main.AndreaSterbini and TWiki:Main.FrancoBagnoli
Copyright:	© 2000-2001 TWiki:Main.FrancoBagnoli © 2007-2011 TWiki:TWiki.TWikiContributor
License:	GPL (GNU General Public License)
Plugin Version:	2011-01-25 (V1.1)
Change History:
2011-01-25:	TWikibug:Item6638: Doc improvements; XHTML fixes -- TWiki:Main.PeterThoeny
2001-11-27:	Initial version
TWiki Dependency:	$TWiki::Plugins::VERSION 1.1
CPAN Dependencies:	CPAN:Safe
Other Dependencies:	none
Perl Version:	5.005
Benchmarks:	GoodStyle nn%, FormattedSearch nn%, PerlSamplePlugin nn%
Plugin Home:	http://TWiki.org/cgi-bin/view/Plugins/PerlSamplePlugin
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/PerlSamplePluginDev
Appraisal:	http://TWiki.org/cgi-bin/view/Plugins/PerlSamplePluginAppraisal

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences