This module is a simple wrapper around the Frink interpreter written by Alan Eliasen. As such, it requires a local copy of the Java interpreter and the
frink.jar file. For more information on Frink, please see http://futureboy.homeip.net/frinkdocs/. This module works by starting a JVM as a child process, and sending Frink expressions to it via a pipe, and retrieving the results the same way. Also, this module has the ability to function in a restricted mode it attempts to filter "dangerous" expressions, such as functions that read files from local disk, the network, and also commands that may persistantly change the interpreter state.
The list of "dangerous" functions and expressions was derived by reading the Frink documentation, and probably is not complete. If you find commands that get through the filter that should, please report them.
The following functions are not allowed in restricted mode:
The following language constructs are not allowed in restricted mode:
- Function Declarations
- Unit display format
- Time display format
- Procedure blocks
- File inclusion
- Class Declaration
This method will create a new Language::Frink::Eval object, and start up an external Frink interpreter in a JVM. If it encounters any problems when starting the JVM, then it will call
These parameters are not case sensitive.
This is a boolean value. If it is true, then expressions will be filtered to attempt to prevent "dangerous" expressions from being evaluated.
This specifies the entire commandline to run. This defaults to
java -cp frink.jar frink.parser.Frink. If the java interpreter is not in your path, or if the
frink.jaris not in your current directory, then you will need to change this.
This passes the expression that is given to the Frink interpreter, and returns the results as a string. This may return a single string will multiple embedded newlines. If the interpreter's results end in a newline, then it will be removed before returning, to make processing the common case of a single line result easier. If the object is set to
Restricted then results will be filtered before evaluation. If it is determined that the expression cannot be evaluated due to policy, then the program will
croak with an error message describing why.
This module requires a Java interpreter and a local copy of
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Clayton O'Neill <firstname.lastname@example.org>